OpenClaw 安装与飞书机器人接入教程

输入自己的 API Key。

4. 选择 AI 模型

建议选择默认的 GLM-4 系列模型。

5. 连接即时通讯平台

配置完 AI 模型后，OpenClaw 会询问要连接哪个通讯平台。

OpenClaw 原生支持 WhatsApp、Telegram、Discord 等，国内用户可选择飞书或钉钉。

此处先选择跳过，后续通过 UI 界面进行配置。

6. 选择 Skills

选择 No，暂不配置，后续通过 UI 界面进行配置。

7. 是否开启 Hooks

操作步骤：先敲空格选中当前项，再敲回车键。

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

此时会自动打开一个命令窗口来启动服务。

等待约 30 秒左右，回到设置窗口，选择 Open the Web UI，打开 OpenClaw 的 Web UI 界面。

浏览器自动打开 Web UI 界面。

9. 测试

在界面中输入指令进行测试。

五、接入飞书机器人

需要先至飞书平台创建机器人来接入 OpenClaw。

1. 来到飞书开发者后台

飞书开放平台地址：https://open.feishu.cn

点击右上角进入 开发者后台。

2. 创建应用

3. 填写应用信息

4. 获取应用凭证

记录 AppID 和 AppSecret。

5. 给应用添加机器人

6. 给应用配置权限

开通即时通讯相关的权限。

7. 创建版本并发布

提交审批，发布为在线应用。

8. 安装飞书插件

打开 PowerShell，输入以下命令安装飞书插件：

openclaw plugins install @m1heng-clawd/feishu 

安装成功后，打开新的命令窗口，输入命令：openclaw config。

选择渠道，选择配置链接。

输入飞书的 AppID 和 AppSecret。

域名选择中国区域。

接受群组聊天。

选择完成，确认 Yes，选择 Open。

重启服务使配置生效。

9. 回到飞书后台设置事件回调

选择 使用长连接接收事件。

添加接收消息事件。

开通获取通讯录基本信息的权限。

重新发布版本为在线应用。

现在可以在飞书中与 AI 助手对话了。

六、访问 Web 控制面板

配置完成后，PowerShell 窗口底部会显示控制面板链接，格式类似：

Control UI: http://127.0.0.1:18789 

1. 复制完整链接
2. 在浏览器中打开
3. 即可看到可视化 UI 管理界面

七、常用命令速查

八、常见问题解答

Q1: 安装飞书插件提示：spawn npm ENOENT

问题原因：可能是 OpenClaw 的一个 bug。

解决步骤： 定位问题代码文件路径：

C:\Users\Administrator\AppData\Roaming\fnm\node-versions\v22.14.0\installation\node_modules\openclaw\dist\process\exec.js 

修改 runCommandWithTimeout 函数中的 spawn 调用。

修改前：

const stdio = resolveCommandStdio({ hasInput, preferInherit:true});
const child = spawn(argv[0], argv.slice(1), { stdio, cwd, env: resolvedEnv, windowsVerbatimArguments });

修改后：

const stdio = resolveCommandStdio({ hasInput, preferInherit:true});
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 });

Q2: 提示'openclaw 命令找不到'

解决方法：

1. 关闭所有 PowerShell 窗口
2. 重新打开 PowerShell
3. 如还不行，执行 exec bash 或重启电脑

Q3: 安装卡住不动

解决方法：

1. 按 Ctrl + C 中断当前操作
2. 执行：openclaw doctor 检查问题
3. 如提示网络问题，检查防火墙设置

Q4: API Key 配置错误

解决方法：

1. 执行：openclaw onboard
2. 选择重新配置 API Key
3. 确保密钥格式正确

Q5: 端口 18789 被占用

解决方法：

openclaw gateway --port 18790 

使用其他端口启动服务。

九、成本说明

OpenClaw 软件本身完全免费，主要成本来自 AI 模型 API 调用，可选择国产大模型降低成本。