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

4. 发布版本

在版本管理中创建新版本并提交发布，状态变为'在线应用'后，需在飞书客户端完成审批。

5. 安装插件

打开 PowerShell，执行以下命令安装飞书插件：

openclaw plugins install @m1heng-clawd/feishu 

6. 配置插件

安装完成后，新开一个 PowerShell 窗口执行 openclaw config，按向导依次填写：

配置生效后需重启服务：

openclaw gateway stop
openclaw gateway start

7. 设置事件回调

回到飞书开放平台 → 应用详情 → 事件订阅：

1. 选择使用长连接接收事件。
2. 点击添加事件，勾选接收消息。
3. 重新发布版本使配置生效。

8. 开始使用

在飞书客户端找到创建的机器人，发送消息即可指挥 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 调用，在前方添加 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 等国内模型以降低开销）。