OpenClaw 安装与飞书机器人接入教程
适用系统：Windows 10/11
一、什么是 OpenClaw？
OpenClaw 是一款开源个人 AI 助手，GitHub 星标已超过 10 万颗。
与普通 AI 聊天机器人的核心区别：
- 真正的执行能力：不只回答问题，能实际操作你的电脑
- 24/7 全天候待命：睡觉时也能主动完成任务
- 完全开源免费：数据完全掌控在自己手中
- 支持国内平台：飞书、钉钉等均已支持接入
二、安装前准备：安装 Node.js
建议提前手动安装 Node.js（版本 v22.x 以上），可加快后续安装速度并减少意外。
官方下载地址：https://nodejs.org/zh-cn/download
三、安装 OpenClaw
1. 设置 PowerShell 执行权限
以管理员身份运行 PowerShell（Win 键搜索 → 右键 → 以管理员身份运行），依次执行：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
2. 执行一键安装命令
iwr -useb https://openclaw.ai/install.ps1 | iex
安装过程会自动完成：检测系统环境、安装依赖、下载核心文件、配置环境变量，并进入配置向导。
四、初始配置向导
1. 风险告知
按左方向键 ← 选择 Yes，回车确认继续。
2. 选择 QuickStart 模式
3. 配置 AI 模型 API Key
推荐使用国内智谱 GLM 模型，成本低且门槛低。
- 注册地址：https://www.bigmodel.cn
- 注册后获取 API Key，填入配置向导
4. 选择模型
选择 GLM-4.7（智谱当前旗舰模型）或其他你已有 Key 的模型。
5. 跳过通讯平台配置
飞书配置较复杂，此处选择 Skip，后续单独配置。
6. 跳过 Skills 配置
选择 No，后续通过 UI 界面配置。
7. 开启 Hooks
按空格键选中，再按回车确认。
8. 启动服务并打开 UI 界面
服务启动后，约等待 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
这是 OpenClaw 在 Windows 上的已知 bug。找到以下文件：
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 等国内模型，成本更低）
