OpenClaw 多飞书机器人与多 Agent 团队实战复盘
这次实践的目标很明确:在 Windows 上稳定跑通 OpenClaw,接入飞书机器人,实现一个机器人对应一个 Agent 角色,支持多模型并行,最终形成可执行的多 Agent 团队。
环境安装与 Gateway 排障
从零开始安装
先确认 Node 和 npm 版本。建议 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
通过标准是能返回版本号。
首次初始化与健康检查
推荐运行 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。
最小可用调用测试:
openclaw agent --agent main -m "你好,请回复:安装连通通过" --json
只要命令返回 JSON 且无致命报错即可。
常见问题处理
- 命令找不到:如果是 PATH 问题,将
$(npm prefix -g)/bin(Linux/macOS) 或npm prefix -g输出目录 (Windows) 加入系统 PATH。 - Gateway 状态异常:若
openclaw gateway status显示服务缺失,尝试前台启动openclaw gateway run --verbose。观察到listening on ws://127.0.0.1:18789说明主进程正常。 - Windows 下
--force报错:Windows 没有lsof时,直接去掉--force参数运行。
飞书集成与配对机制
安装后马上接入 Feishu 渠道。
- 安装插件:
openclaw plugins install @openclaw/feishu - 添加渠道:
按提示选择openclaw channels addFeishu,填入开放平台的App ID与App Secret。 - 重启并检查:
openclaw gateway restart openclaw logs --follow


