OpenClaw 多飞书机器人与多 Agent 团队实战复盘
这次实践的目标很明确:在 Windows 上稳定跑通 OpenClaw,接入飞书机器人,实现一个机器人对应一个 Agent 角色,支持多模型并行,最终形成可执行的多 Agent 团队。
落地状态已验证:
- 渠道:Feishu 多账号在线
- 路由:按
accountId精确绑定到对应 Agent - 角色:产品经理、技术开发、测试质保、代码评审、文档维护、发布运维
- 模型:默认
openai-codex/gpt-5.2,文档 Agent 使用ollama/gpt-oss:20b-cloud
跨系统安装与 Gateway 排障
环境前置检查
先确认 Node 和 npm 版本。建议 Node.js >= 22,npm >= 10。如果版本过低,先升级再安装 OpenClaw。
node -v
npm -v
按系统执行安装命令
macOS / Linux:
curl -fsSL https://openclaw.ai/install.sh | bash
Windows(PowerShell):
iwr -UseBasicParsing https://openclaw.ai/install.ps1 | iex
安装完成后统一验证,能返回版本号(如 2026.x.x)即通过:
openclaw --version
首次初始化与健康检查
推荐运行初始化向导,完成三件事:选择模型供应商、完成认证、写入本地配置。
openclaw onboard --install-daemon
接着做健康检查,确保无致命错误且网关可达:
openclaw doctor
openclaw status
openclaw health
openclaw gateway status
openclaw gateway probe
通过标准包括 doctor 无致命错误,gateway probe 显示 Reachable: yes,本地网关目标通常是 ws://127.0.0.1:18789。
最小可用调用测试如下,返回 JSON 且无致命报错即可:
openclaw agent --agent main -m "你好,请回复:安装连通通过" --json
常见问题排查
1. 找不到 openclaw 命令 诊断 PATH 是否包含全局 bin 目录。
macOS / Linux:
npm prefix -g && echo "$PATH"
Windows(PowerShell):
npm prefix -g; $env:Path
修复原则是将输出目录加入系统 PATH。
2. Gateway 状态异常
若 openclaw gateway status 显示服务缺失或 RPC 失败,尝试前台启动确认服务本体:


