项目目标与落地状态
这次实践的核心目标是把 OpenClaw 从单机环境扩展到多机器人协作，最终形成一个能稳定运行的自动化团队。我们验证了以下关键点：
- 渠道：支持 Feishu 多账号在线
- 路由：按
accountId精确绑定到对应 Agent - 角色：覆盖产品经理、技术开发、测试质保、代码评审、文档维护、发布运维
- 模型：默认使用
openai-codex/gpt-5.2，文档 Agent 独立配置ollama/gpt-oss:20b-cloud
安装与环境配置
前置检查
先确认 Node 和 npm 版本是否达标，建议 Node.js >= 22，npm >= 10。如果版本过低，升级后再进行后续操作。
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 onboard --install-daemon
随后通过健康检查确保网关正常，特别是 gateway probe 应显示 Reachable: yes，本地网关通常监听在 ws://127.0.0.1:18789。
openclaw doctor
openclaw gateway status
openclaw gateway probe
最小可用调用测试也很关键，确保能收到 JSON 响应且无致命报错。
openclaw agent --agent main -m "你好，请回复：安装连通通过" --json
常见问题排查
1. 找不到 openclaw 命令
如果是 PATH 问题，需要把全局 npm bin 目录加入环境变量。
macOS / Linux：
npm prefix -g && echo "$PATH"
Windows（PowerShell）：
npm prefix -g; $env:Path
修复原则是将输出目录加入系统 PATH。
2. Gateway 状态异常
如果 gateway status 显示服务缺失或 RPC 失败，尝试前台启动确认主进程是否正常。
openclaw gateway run --verbose
