OpenClaw 安装 + 接入飞书机器人完整教程

飞书配置较复杂，此处选择 Skip，后续单独配置。

6. 跳过 Skills 配置

选择 No，后续通过 UI 界面配置。

7. 开启 Hooks

按空格键选中，再按回车确认。

8. 启动服务并打开 UI 界面

服务启动后，约等待 30 秒，选择 Open the Web UI，浏览器自动打开管理界面：

http://127.0.0.1:18789 

五、接入飞书机器人

第一步：创建飞书应用

1. 打开飞书开放平台：https://open.feishu.cn
2. 点击右上角进入开发者后台
3. 点击创建应用，填写应用名称和描述
4. 进入应用详情，记录下 App ID 和 App Secret

第二步：添加机器人能力

在应用详情页，找到添加应用能力，选择并添加机器人。

第三步：配置权限

在权限管理页面，开通以下权限（即时通讯相关权限全部开通）：

• 获取与发送单聊、群组消息
• 读取用户基本信息
• 获取通讯录基本信息

第四步：创建版本并发布

1. 在版本管理中创建新版本
2. 提交发布，状态为在线应用
3. 前往飞书客户端完成审批

第五步：安装飞书插件

打开 PowerShell，执行：

openclaw plugins install @m1heng-clawd/feishu 

第六步：配置飞书插件

安装完成后，新开一个 PowerShell 窗口，执行：

openclaw config 

按照向导依次完成：

配置完成后重启服务使配置生效：

openclaw gateway stop openclaw gateway start

第七步：飞书后台设置事件回调

1. 回到飞书开放平台 → 应用详情 → 事件订阅
2. 选择使用长连接接收事件
3. 点击添加事件，添加接收消息事件
4. 重新发布版本（步骤同上）

第八步：开始使用

打开飞书客户端，找到你创建的机器人，直接发消息即可指挥 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 等国内模型，成本更低）