OpenClaw 本地部署及飞书机器人接入实战指南

8. 启动服务

配置完成后，系统会自动打开一个命令窗口启动服务。等待约 30 秒后，在配置窗口选择 Open the Web UI 打开浏览器。

9. 基础测试

在 Web UI 中输入简单指令（如'你好'），确认服务正常运行。

接入飞书机器人

1. 创建飞书应用

1. 登录飞书开放平台：https://open.feishu.cn
2. 点击右上角进入开发者后台。
3. 点击'创建应用'，填写应用名称和描述。
4. 获取应用凭证（App ID 和 App Secret）。

2. 添加机器人并配置权限

1. 在应用详情页添加'机器人'。
2. 开通必要权限，包括消息接收、通讯录读取等。
3. 提交审核并发布为在线应用。

3. 安装飞书插件

回到 PowerShell 窗口，执行以下命令安装飞书插件：

openclaw plugins install @m1heng-clawd/feishu 

4. 配置插件参数

1. 输入 openclaw config 进入配置菜单。
2. 选择渠道为飞书。
3. 输入之前获取的 App ID 和 App Secret。
4. 域名选择中国区节点。
5. 勾选接受群组聊天，完成配置。

5. 设置事件回调

1. 回到飞书开发者后台，找到'事件订阅'。
2. 启用长连接接收事件。
3. 添加'消息接收'事件类型。
4. 重新发布应用版本。

6. 验证连接

重启 OpenClaw 服务后，在飞书客户端搜索机器人名称，发送消息测试交互。

访问 Web 控制面板

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

Control UI: http://127.0.0.1:18789 

复制该链接在浏览器打开，即可进行可视化配置与管理。

常用命令速查

常见问题解答

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

原因：Windows 环境下 npm 调用可能存在兼容性问题。

解决：修改源码中的 spawn 调用逻辑。

定位文件路径：

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

找到 runCommandWithTimeout 函数，修改如下：

修改前：

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 命令找不到'

解决：关闭所有终端窗口，重新打开；或执行 exec bash 刷新环境变量。

Q3: 安装卡住不动

解决：按 Ctrl + C 中断，执行 openclaw doctor 检查网络或防火墙设置。

Q4: API Key 配置错误

解决：执行 openclaw onboard 重新配置，确保密钥格式无误。

Q5: 端口 18789 被占用

解决：指定其他端口启动服务：

openclaw gateway --port 18790 

成本说明

软件本身免费，主要成本来自 AI 模型 API 调用。建议选择性价比高的国产大模型以降低成本。