前言

最近我花了几天时间折腾，终于把AI助手成功搭起来了。现在通过飞书发个消息，电脑上的OpenClaw就能帮我干活了。整个过程虽然不算难，但步骤确实有点多，所以特意写下这份笔记。

⚠️ 安全提示

• OpenClaw安装后拥有较高系统权限，操作不当可能误删用户数据。
• 如果部署在公网环境，存在被攻击的风险。
• 调用大模型会消耗Tokens，特别是处理复杂任务时，费用可能增长很快。

安装前需要了解的概念

主要涉及以下组件和平台：

• 操作系统：Windows 10/11 + PowerShell终端
• 运行时环境：Node.js 22及以上版本
• AI网关：OpenClaw
• 大模型服务：DeepSeek API
• 消息通道：飞书、QQ、微信

关系很简单：OpenClaw跑在Node.js上，通过插件连接飞书等平台收消息，然后调用DeepSeek生成回复，最终把结果返回给用户。

安装步骤

第一步：安装Node.js

OpenClaw依赖Node.js环境，要求22及以上版本。

1. 访问nodejs.org下载Windows安装包(.msi)。
2. 双击安装，确保勾选"Add to PATH"选项。
3. 打开PowerShell（右键开始菜单 → Windows PowerShell(管理员)），输入以下命令验证：
   node --version
   出现版本号就对了。

第二步：安装OpenClaw

用npm全局安装，必须以管理员身份运行PowerShell：

npm install -g openclaw

装完后检查版本：

openclaw --version

如果一切正常，openclaw命令就能用了。

第三步：申请DeepSeek API Key

你需要获取三个关键信息：

• API Key：格式 sk-xxx
• Base URL：https://api.deepseek.com
• 模型ID：deepseek-chat（非思考）或 deepseek-reasoner（思考模式）

1. 访问 DeepSeek开放平台 并登录。
2. 点击左侧"API Key"，创建新Key。
3. 复制生成的Key并安全保存（关闭页面后就看不到了）。

第四步：配置OpenClaw使用DeepSeek

运行配置向导：

openclaw onboard

配置过程主要步骤：

1. 风险确认：选Yes继续。
2. 配置模式：选QuickStart就好。
3. 模型提供商：选择DeepSeek，如果没有就选Custom Provider。
4. 模型配置：
   • Base URL：https://api.deepseek.com
   • API Key：粘贴刚才复制的Key
   • Endpoint兼容性：OpenAI-compatible
   • Model ID：例如deepseek-v4-flash
5. 消息通道：可跳过，后面单独配置飞书。
6. 技能：暂时选No。
7. 钩子：全选。
8. 网关服务：选Install或Reinstall，支持后台运行。
9. 启动方式：选Hatch in TUI或Open the Web UI。

成功后会打开一个类似下面的网页控制台或终端界面：
http://127.0.0.1:18789/#token=xxxxx
这个token是一次性的，重启后失效。

常用命令：

• openclaw gateway start 或 openclaw gateway restart：启动/重启网关
• openclaw dashboard：打开网页控制台
• openclaw tui：打开终端控制台

如果配置有误，可以运行 openclaw dashboard 重新配置，或者用 openclaw config 单项修改。配置过程中可按 Ctrl+C 退出。

第五步：配置飞书

飞书官方推出了专用插件，相比OpenClaw内置插件更简单，只需扫码即可完成配置。安装命令：

npx -y @larksuite/openclaw-lark-tools install

需要管理员权限，具体用法参考OpenClaw飞书官方插件文档。

如果选择使用OpenClaw内置插件，则需按以下步骤操作：

1. 创建飞书应用

1. 访问飞书开放平台，创建企业自建应用。
2. 添加机器人能力。
3. 在"凭证与基础信息"中获取 App ID 和 App Secret。
4. 创建版本并发布上线（必须是已发布状态，不能是草稿）。

2. 安装飞书插件并配置

openclaw plugins install @openclaw/feishu

openclaw config set channels.feishu.appId "你的App ID"
openclaw config set channels.feishu.appSecret "你的App Secret"

配置后重启网关：

openclaw gateway restart

3. 配置事件订阅与权限

• 在飞书开放平台的"事件与回调"中，订阅方式选择"使用长连接接收事件"。
• 添加事件 im.message.receive_v1。
• 在"权限管理"中批量导入以下权限：

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "event:ip_list",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource"
    ],
    "user": [
      "aily:file:read",
      "aily:file:write",
      "im:chat.access_event.bot_p2p_chat:read"
    ]
  }
}

完成后重新发布应用。

4. 配对操作

这是OpenClaw的安全机制，只有配对过的飞书用户才能使用AI助手。

1. 在飞书中给机器人发任意消息，会收到8位配对码，例如 X379S5M8。
2. 在终端执行：openclaw pairing approve feishu X379S5M8
3. 看到类似 Pairing approved for user ou_xxxxxxxxxxxxxxx 的提示即表示成功。
4. 再次发消息测试，应该能正常收到AI回复。

第六步：配置QQ

OpenClaw 3.31及以上版本已内置QQ机器人插件，无需单独安装。访问QQ开放平台查询具体接入方法。

第七步：配置微信

微信也支持了，安装方式如下：

1. 在微信客户端中点击"我"→"设置"→"插件"→"微信ClawBot"。
2. 在部署OpenClaw的电脑上执行：npx -y @tencent-weixin/openclaw-weixin-cli@latest install
3. 按提示扫码完成安装。
4. 重启网关：openclaw gateway restart

遇到问题怎么办？

• 把错误信息复制给DeepSeek等大模型求助（注意AI有时会给出错误建议）。
• 运行 openclaw config 或 openclaw onboard 重新配置，然后 openclaw gateway restart。
• 使用 openclaw doctor 进行诊断。
• 直接在OpenClaw中提问，让它帮你排查。
• 多关注错误提示，按提示调整配置。

升级OpenClaw

OpenClaw更新频繁，版本间兼容性较差，建议直接卸载重装更省事。

常规升级命令：

npm install -g openclaw@latest   # 或 openclaw update

升级后检查：

openclaw doctor       # 运行健康检查
openclaw gateway restart   # 重启网关
openclaw status       # 查看状态

卸载与重装

卸载前先备份 .openclaw 文件夹，里面有你的配置和插件。

openclaw uninstall --all --yes   # 删除主程序、服务、配置
npm uninstall -g openclaw       # 删除命令行工具

重装时重新执行安装步骤即可。

常用命令速查

最常用的几个

场景	命令
首次安装	npm install -g openclaw → openclaw onboard
配置飞书	openclaw plugins install @openclaw/feishu → 配置App ID/Secret → openclaw gateway restart
修改配置	openclaw config
日常使用	openclaw gateway start → openclaw dashboard 或 openclaw tui → openclaw gateway stop
问题排查	openclaw doctor + openclaw logs

客户端界面

命令	说明
openclaw tui	终端命令行聊天界面
openclaw dashboard	打开网页控制台

安装与管理

命令	说明
npm install -g openclaw	首次安装
openclaw --version	查看版本
openclaw update	更新版本
openclaw doctor	诊断检查

网关服务

命令	说明
openclaw gateway start	启动网关（前台）
openclaw gateway stop	停止网关
openclaw gateway restart	重启网关
openclaw gateway status	查看网关状态
openclaw gateway install	安装为系统服务
openclaw status	查看整体状态

配置管理

命令	说明
openclaw onboard	配置向导
openclaw config	通用配置工具
openclaw config get <key>	读取配置项
openclaw config set <key> <value>	设置配置项

常用配置项示例

配置项	示例值	说明
model.provider	deepseek	大模型提供商
model.apiKey	sk-xxx	API Key
model.name	deepseek-v4-flash	模型名称（经济版日常用）
channels.feishu.appId	cli_xxxxx	飞书App ID
channels.feishu.appSecret	your-secret	飞书App Secret
channels.feishu.enabled	true	启用飞书通道

模型说明：deepseek-v4-flash 适合日常；deepseek-v4-pro 适合复杂任务，但费用较高。

插件管理

命令	说明
openclaw plugins list	列出已安装插件
openclaw plugins install <名称>	安装插件
openclaw plugins uninstall <名称>	卸载插件
openclaw plugins update <名称>	更新插件

用户授权

命令	说明
openclaw pairing list	查看待处理配对
openclaw pairing approve <渠道> <配对码>	批准用户
openclaw pairing revoke <渠道> <用户ID>	撤销用户权限

技能与ClawHub

命令	说明
openclaw skills list	列出本地技能
npm install -g clawhub	安装ClawHub（需管理员权限）
clawhub --version	验证安装
npx clawhub search "关键词"	搜索技能
clawhub install <技能名>	安装技能
clawhub list	列出已安装技能

安装技能后需要重启网关才能生效：openclaw gateway restart。

数据与存储

命令	说明
openclaw logs	查看日志文件
openclaw reset	重置配置（谨慎使用）