OpenClaw 多飞书机器人与多 Agent 团队实战复盘
这次实践完整记录了一次从单机安装到多机器人协作落地的真实过程，涵盖了 Windows 环境下的安装报错、Gateway 连通性调试、模型切换策略、Feishu 配对流程，以及最终构建'产品 - 开发 - 测试 - 评审 - 文档 - 运维'的自动化团队。
一、目标与结果
这次实践的目标很明确：在 Windows 上稳定跑通 OpenClaw，接入飞书机器人，实现一个机器人对应一个 Agent 角色，支持多模型并行（OpenAI + Ollama），最终形成可执行的多 Agent 团队。
落地状态已验证：
- 渠道：Feishu 多账号在线
- 路由：按 accountId 精确绑定到对应 Agent
- 角色：产品经理、技术开发、测试质保、代码评审、文档维护、发布运维
- 模型：默认 openai-codex/gpt-5.2，文档 Agent 使用 ollama/gpt-oss:20b-cloud
二、第一阶段：跨系统安装与 Gateway 排障
1. 从零安装 OpenClaw（Windows / macOS / Linux）
Step 1. 环境前置检查 先确认 Node 和 npm 版本是否达标。建议 Node.js >= 22，npm >= 10。如果版本过低，请先升级再安装 OpenClaw。
node -v && npm -v
Step 2. 按系统执行安装命令 macOS / Linux：
curl -fsSL https://openclaw.ai/install.sh | bash
Windows（PowerShell）：
iwr -useb https://openclaw.ai/install.ps1 | iex
安装完成后统一验证版本号，如返回 2026.x.x 即通过。
openclaw --version
Step 3. 首次初始化（推荐） 运行 onboard 向导完成三件事：选择模型供应商、完成认证（API Key 或 OAuth）、写入本地配置。
openclaw onboard --install-daemon
Step 4. 安装后健康检查 依次执行 doctor、status、health 等命令。重点看 gateway probe 是否显示 Reachable: yes，本地网关目标通常是 ws://127.0.0.1:18789。
openclaw doctor
openclaw status
openclaw health
openclaw gateway status
openclaw gateway probe
Step 5. 最小可用调用测试 发送一条测试消息，确保能返回 JSON 且无致命报错。
openclaw agent --agent main -m "你好，请回复：安装连通通过" --json
Step 6. 解决 openclaw 命令找不到（PATH） 如果提示 command not found，需将 npm 全局 bin 目录加入 PATH。
macOS / Linux：
export PATH="$PATH:$(npm prefix -g)/bin"
Windows（PowerShell）：
$env:Path += ";$(npm prefix -g)"
