问题描述
在 OpenClaw 配置飞书机器人时,遇到群消息无响应及 Gateway 频繁断开的问题。
飞书消息不回复
@机器人后无反应,状态显示连接正常。
Gateway 频繁断开
执行 openclaw gateway restart 或空闲时 Gateway 断开,启动报错,需运行 openclaw doctor --fix 修复。
原因分析
飞书应用类型错误
日志提示仅自建应用支持 WebSocket 长连接收消息。初始配置的 App ID 为快捷版/小程序类型,不支持该功能。需使用正确的自建应用 ID。
多机器人配置方式错误
运营 Agent 单独配置飞书机器人时报错 unknown channel id。飞书多账号需通过 accounts 字段配置,而非多个渠道。
Gateway 进程管理问题
日志显示 Gateway 收到 SIGTERM 后正常关闭,但 LaunchAgent 未自动重新加载。前台直接运行 openclaw gateway 不受 LaunchAgent 的 KeepAlive 控制,断开后无法自动重启。
解决方案
飞书多账号配置
修改 ~/.openclaw/openclaw.json 配置文件,使用 accounts 字段定义多个账号,并在 bindings 中指定 accountId。
配置示例:
{"channels":{"feishu":{"defaultAccount":"main","accounts":{"main":{"appId":"xxxxxxxxxxxxxxxx","appSecret":"abcdefghijklmnopqrstuvwxyz"},"yunying":{"appId":"yyyyyyyyyyyyyy","appSecret":"1234567890abcdef"}}}}}
绑定示例:
{"bindings":[{"type":"route","agentId":"main","match":{"channel":"feishu","accountId":"main"}},{"type":"route","agentId":"yunying","match":{"channel":"feishu","accountId":"yunying"}}]}
重启 Gateway 验证:
openclaw gateway restart
日志显示两个 WebSocket 客户端均已启动。
Gateway 自动重启
停止前台运行的 Gateway,改用 LaunchAgent 管理。
# 停止前台运行的 Gateway
openclaw gateway install
openclaw gateway start
此后 Gateway 受 LaunchAgent 管理,断开后可自动重启。
注意事项
- 飞书多账号需使用
accounts字段配置。 - Gateway 必须使用
openclaw gateway start命令启动,以便由 LaunchAgent 接管。

