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

安装插件

打开 PowerShell，执行：

openclaw plugins install @m1heng-clawd/feishu

配置插件

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

• 选择渠道：飞书
• 选择配置链接：对应链接
• 填写凭证：App ID 和 App Secret
• 选择域名：中国区域
• 接受群组聊天：确认开启
• 完成配置：Yes → Open → 继续

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

openclaw gateway stop
openclaw gateway start

设置事件回调

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

开始使用

打开飞书客户端，找到创建的机器人，直接发消息即可指挥 OpenClaw。

常用命令速查

常见问题

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

这是 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 等国内模型，成本更低）