OpenClaw 安装与飞书机器人接入指南
说明：OpenClaw 曾用名 ClawdBot、MoltBot，属同一软件。 适用系统：Windows 10/11
一、工具简介
OpenClaw 是一款开源的本地 AI 助手，具备真正的执行能力，不仅能回答问题，还能操作你的电脑。它支持 24/7 全天候待命，数据完全掌控在自己手中，目前已支持接入飞书、钉钉等国内平台。
二、环境准备
建议手动安装 Node.js（版本 v22.x 以上），这能加快后续安装速度并减少意外。
官方下载地址：https://nodejs.org/zh-cn/download
三、安装 OpenClaw
1. 设置 PowerShell 执行权限
以管理员身份运行 PowerShell（Win 键搜索 → 右键 → 以管理员身份运行），依次执行以下命令：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
2. 执行一键安装
复制并执行以下命令，安装过程会自动检测环境、安装依赖、下载核心文件并进入配置向导：
iwr-useb https://openclaw.ai/install.ps1 |iex
四、初始配置向导
安装启动后，按向导提示操作即可：
- 风险告知：按左方向键
←选择Yes，回车确认继续。 - 模式选择：选择
QuickStart模式。 - 模型 API Key：推荐使用国内智谱 GLM 模型，成本低且门槛低。前往 https://www.bigmodel.cn 注册获取 Key 填入。
- 选择模型：选择
GLM-4.7（智谱当前旗舰）或其他已有 Key 的模型。 - 跳过通讯平台：飞书配置较复杂，此处选
Skip，后续单独配置。 - 跳过 Skills：选
No，后续通过 UI 界面配置。 - 开启 Hooks：按空格键选中，再按回车确认。
- 启动服务：等待约 30 秒，选择
Open the Web UI，浏览器将自动打开管理界面：
http://127.0.0.1:18789
五、接入飞书机器人
第一步：创建飞书应用
- 登录飞书开放平台：https://open.feishu.cn
- 点击右上角进入开发者后台。
- 点击创建应用，填写名称和描述。
- 在应用详情页记录 App ID 和 App Secret。
第二步：添加机器人能力
在应用详情页找到添加应用能力，选择并添加机器人。
第三步：配置权限
在权限管理页面，开通以下即时通讯相关权限：
- 获取与发送单聊、群组消息
- 读取用户基本信息
- 获取通讯录基本信息
第四步：发布应用
- 在版本管理中创建新版本。
- 提交发布，状态变为在线应用。
- 前往飞书客户端完成审批。
第五步：安装插件
打开 PowerShell，执行：
openclaw plugins install @m1heng-clawd/feishu
第六步：配置插件
安装完成后，新开一个 PowerShell 窗口，执行：
openclaw config
按照向导依次完成：
| 步骤 | 操作 |
|---|---|
| 选择渠道 | 选择飞书 |
| 选择配置链接 | 选择对应链接 |
| 填写凭证 | 输入 App ID 和 App Secret |
| 选择域名 | 选择中国区域 |
| 接受群组聊天 | 确认开启 |
| 完成配置 | 选择 Yes → Open → 继续 |
配置完成后需重启服务使配置生效：
openclaw gateway stop
openclaw gateway start
第七步：设置事件回调
- 回到飞书开放平台 → 应用详情 → 事件订阅。
- 选择使用长连接接收事件。
- 点击添加事件，添加接收消息事件。
- 重新发布版本（步骤同上）。
第八步：开始使用
打开飞书客户端，找到你创建的机器人，直接发消息即可指挥 OpenClaw 干活！
六、常用命令速查
| 命令 | 功能 |
|---|---|
openclaw onboard | 重新进入配置向导 |
openclaw status | 查看运行状态 |
openclaw health | 健康检查 |
openclaw gateway start | 启动服务 |
openclaw gateway stop | 停止服务 |
openclaw update | 更新到最新版本 |
openclaw doctor | 诊断问题 |
openclaw uninstall | 卸载 OpenClaw |
七、常见问题
Q：安装飞书插件提示 spawn npm ENOENT
这是 Windows 上的已知兼容性问题。需要修改源码中的 exec.js 文件。
找到路径：
C:\Users\你的用户名\AppData\Roaming\fnm\node-versions\v22.x.x\installation\node_modules\openclaw\dist\process\exec.js
定位到 runCommandWithTimeout 函数中的 spawn 调用，在其前面添加 Windows npm 兼容处理：
let command = argv[0];
let useShell = false;
if (process.platform === "win32" && path.basename(command) === "npm") {
useShell = true;
}
const child = spawn(command, argv.slice(1), {
stdio,
cwd,
env: resolvedEnv,
shell: useShell,
});
Q：提示"openclaw 命令找不到"
关闭所有 PowerShell 窗口，重新打开后重试。如仍不行，重启电脑刷新环境变量。
Q：安装卡住不动
按 Ctrl+C 中断，执行 openclaw doctor 检查问题，确认防火墙设置是否阻止了网络请求。
Q：端口 18789 被占用
换用其他端口启动服务：
openclaw gateway --port 18790
八、费用说明
- OpenClaw 软件本身：完全免费
- 主要费用来源：AI 模型 API 调用（推荐使用智谱 GLM 等国内模型，成本更低）