OpenClaw 安装与飞书机器人接入指南
OpenClaw（前身为 ClawdBot、MoltBot）是一款开源的本地 AI 助手，支持在 Windows 环境下运行并执行电脑操作。相比普通聊天机器人，它具备真正的执行能力，可全天候待命处理任务。
环境准备
建议手动安装 Node.js（版本 v22.x 以上），这能加快后续安装速度并减少依赖冲突。
安装 OpenClaw
1. 设置 PowerShell 权限
以管理员身份运行 PowerShell，依次执行以下命令以允许脚本运行：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
Set-ExecutionPolicy Bypass -Scope Process
2. 执行一键安装
复制并运行以下命令，安装程序会自动检测环境、下载核心文件并进入配置向导：
iwr -Uri https://openclaw.ai/install.ps1 -UseBasicParsing | 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，浏览器将自动打开管理界面（默认端口 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 上的已知兼容性问题。需要修改底层执行脚本：
- 找到路径：
C:\Users\你的用户名\AppData\Roaming\fnm\node-versions\v22.x.x\installation\node_modules\openclaw\dist\process\exec.js - 定位
runCommandWithTimeout函数中的spawn调用。 - 在
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
费用说明
- 软件本身：完全免费开源。
- 主要成本：AI 模型 API 调用费用（建议使用智谱 GLM 等国内模型以降低开销）。
