OpenClaw 多飞书机器人与多 Agent 协作落地记录
这次实践不是单纯把 OpenClaw 跑起来,而是把一整条链路补完整:Windows 安装、Gateway 连通、Feishu 接入、多机器人配对、按账号路由到不同 Agent,再到模型分工和身份固化。中间踩了不少坑,真正有价值的部分也正是在这些坑里。
目标和最终状态
这次要解决的事情很明确:
- 在 Windows 上稳定运行 OpenClaw
- 接入飞书机器人
- 让一个机器人对应一个 Agent 角色
- 同时使用 OpenAI 和 Ollama 两类模型
- 最后拼成一个能实际分工的多 Agent 团队
目前验证下来的状态是:
- Feishu 多账号已在线
- 路由按
accountId精确绑定到对应 Agent - 角色已经拆开:产品经理、技术开发、测试质保、代码评审、文档维护、发布运维
- 默认模型是
openai-codex/gpt-5.2 - 文档 Agent 单独使用
ollama/gpt-oss:20b-cloud
安装和 Gateway 排障
先说安装。为了避免后面渠道跑不起来,安装后我把健康检查和 Feishu 接入放在一起做,不拆成两个孤立步骤。
先确认 Node 和 npm:
node -v
npm -v
建议版本是:
- Node.js
>= 22 - npm
>= 10
版本太低就先升级,再装 OpenClaw。
macOS / Linux:
curl -fsSL https://openclaw.ai/install.sh | bash
Windows(PowerShell):
iwr -useb https://openclaw.ai/install.ps1 | iex
装完后先看版本:
openclaw --version
如果能正常返回版本号,比如 2026.x.x,说明安装链路基本通了。
推荐顺手跑一下初始化:
openclaw onboard --install-daemon
这个向导里主要做三件事:选模型供应商、完成认证、写入本地配置。
接下来做健康检查:
openclaw doctor openclaw status openclaw health openclaw gateway status openclaw gateway probe
我比较看重的是 gateway probe,只要它能给出 Reachable: yes,后面的大多数问题就只是配置问题,不是底层坏了。常见的本地网关地址是 ws://127.0.0.1:18789。
再测一次最小调用:
openclaw agent --agent main -m"你好,请回复:安装连通通过"--json
这一步只看两件事:有没有返回 JSON,最终是不是成功。中间即使提示 gateway fallback,也不一定是问题,关键看结果有没有出来。
如果 openclaw 命令找不到,先查 PATH:
macOS / Linux:
npm prefix -g && echo


