OpenClaw 安装与使用全攻略：小白也能当大侠

写在前面：
如果你是一个刚入 AI 江湖的小白，看到 OpenClaw 可能就像第一次见到武侠里的神秘内功心法。别慌，这篇文章我带你从零开始，一步步练成掌控 OpenClaw 的大侠。

---

一、前言：什么是 OpenClaw？

想象一下，你手里有一只万能小爪子（Claw），它能抓住各种 AI 模型，无论是千问（Qwen）、DeepSeek V3，还是 Zai 的 GLM，你只要伸手，它都能乖乖服从。
OpenClaw 就是这样一把神奇的小爪子，让你在本地或者云端轻松调度各种模型和插件。

💡 小技巧：如果你平时玩过 VS Code 插件，那 OpenClaw 的插件机制和它很像——只不过对象换成了 AI 模型。

---

二、准备工作

1. 安装前必备

• 操作系统：Windows / macOS / Linux（任君挑选）
• Node.js：版本建议 18 以上
• Git：用于拉取插件或模型代码
• 一个好心情：心态决定战力

2. 下载 OpenClaw

# 使用 npm 全局安装
npm install -g openclaw

或者去官网 OpenClaw 官网 下载对应版本。
安装完成后，输入：

openclaw --version

如果出现版本号，你就成功迈出了江湖第一步。

3. 第一次启动 OpenClaw

openclaw start

• 你会看到五颜六色的启动日志
• 如果提示 OAuth 授权，记住别慌，按照提示在浏览器完成认证就好

---

三、插件世界：飞书也能被你抓住

OpenClaw 的插件机制很强大，比如你想把飞书（Feishu）也抓来：

# 查看插件状态
openclaw plugins list

你会看到类似输出：

• feishu_doc：文档
• feishu_chat：聊天
• feishu_wiki：Wiki
• feishu_drive：云盘
• feishu_bitable：表格工具

💡 小技巧：为了避免重复警告，可以在配置里写明允许的插件：

{
  "plugins": {
    "allow": ["feishu"]
  }
}

---

四、模型调度：千问与 DeepSeek

想象你是武林大侠，千问（Qwen）是你的轻功，DeepSeek 是你的内功。
你可以随意切换：

# 列出模型
/models qwen-portal

# 切换模型
/model qwen-portal/coder-model

# 设置默认模型
/model set-default qwen-portal/coder-model

⚠️ 常见问题：

• 速率限制：如果提示 API rate limit reached，说明你用太快了，等几分钟再用
• 403 错误：说明 API Key 没配好，检查你的 Key 是否有效

---

五、安装 API Key（稳定访问千问）

1. 打开 Qwen 官网
2. 获取 API Key（不要用 OAuth，稳定可靠）
3. 配置 OpenClaw：

openclaw config

选择：

• Gateway: Local
• Sections to configure: Model
• Model/Auth provider: Qwen
• Auth method: API Key → 填入你拿到的 Key

4. 验证是否可用：

/model status

输出应该显示 Active: qwen-portal/coder-model。

---

六、DeepSeek V3：备用内功

注册 SiliconFlow 获取 Key，配置 Custom Provider：

{
  "provider": "custom",
  "endpoint": "https://api.siliconflow.cn/v1",
  "api_key": "<你的 DeepSeek Key>",
  "model": "deepseek-v3"
}

切换模型：

/model custom/deepseek-v3
/model status

这样在千问被限额时，可以自动切换到 DeepSeek V3。

---

七、使用场景举例

1. 本地 AI 写作助手

   • 输入文字，千问帮你续写文章

2. 飞书机器人

   • 接入飞书插件，自动回复同事消息

3. 代码生成

   • coder-model 帮你写 Three.js、React、Node.js 代码

4. 数据分析

   • 用 DeepSeek 快速分析表格和文本

---

八、日志与调试

实时查看日志：

openclaw logs --follow

• 遇到问题第一步就是看日志
• 日志里会显示插件加载、模型切换、API 调用情况

💡 小技巧：日志就像江湖传闻，看懂了，你就能预知下一步可能出现的坑。

---

九、进阶技巧

1. 自定义插件：在 extensions 下创建自己的插件，扩展功能
2. 多模型自动切换：设置 fallback 模型，速率限制时自动切换
3. 定时任务：结合系统计划任务，让 OpenClaw 自动跑批处理
4. 日志分析：用 Python 或 Node.js 对日志做可视化，监控模型调用

---

十、总结

OpenClaw 就像一只万能小爪子，把 AI 世界都抓在手里。
无论是写文章、写代码、处理表格，还是飞书自动回复，它都能帮你轻松搞定。
小白也能上手，高手可以玩出花样。只要你肯动手，AI 江湖任你驰骋。

---

🔥 文章亮点

• 小白友好，通俗易懂
• 幽默风趣，带莫言式叙事风格
• 图文并茂，操作步骤详细
• 配置、插件、模型、调试全覆盖

---

附录：常用命令速查表

命令	功能
/models <provider>	查看提供商下所有模型
/model <provider>/<model>	切换当前模型
/model set-default <provider>/<model>	设置默认启动模型
/plugins list	查看已启用插件
/plugins allow	查看允许插件
openclaw logs --follow	实时查看日志

---

写完本文，你就是 OpenClaw 江湖的小侠，不管是千问轻功还是 DeepSeek 内功，都能得心应手。
小白也能秒变大侠，只要你敢动手。