前言
用 OpenClaw 配置飞书机器人时遇到了两个常见问题：群消息无响应、Gateway 频繁断开。经过排查已解决，记录如下供参考。
问题现象
飞书消息不回复
在飞书群里 @ 机器人后完全无反应。状态显示连接正常，但无法接收或发送消息。
Gateway 频繁断开
执行 openclaw gateway restart 或空闲时 Gateway 均可能断开。再次启动报错，需运行 openclaw doctor --fix 重新安装才能恢复。
原因分析
飞书机器人 ID 类型错误
日志提示：
receive events or callbacks through persistent connection only available in self-build & Feishu app
原配置的 App ID 属于快捷版/小程序类型，不支持 WebSocket 长连接收消息。需向运维获取正确的自建应用 ID。
多机器人配置格式错误
尝试为运营 agent 单独配置飞书机器人时报错'unknown channel id'。飞书多账号需在配置中使用 accounts 字段。
正确配置示例：
{"channels":{"feishu":{"defaultAccount":"main","accounts":{"main":{"appId":"xxxxxxxxxxxxxxxx","appSecret":"abcdefghijklmnopqrstuvwxyz"},"yunying":{"appId":"yyyyyyyyyyyyyy","appSecret":"1234567890abcdef"}}}}}
Bindings 配置：
{"bindings":[{"type":"route","agentId":"main","match":{"channel":"feishu","accountId":"main"}},{"type":"route","agentId":"yunying","match":{"channel":"feishu","accountId":"yunying"}}]}
Gateway 断开原因
Gateway 收到 SIGTERM 后正常关闭，但 LaunchAgent 未自动重载。之前在前台直接运行 openclaw gateway 导致进程不受 LaunchAgent 管理，断开后不会自动重启。
解决方案
修复多账号配置
修改 ~/.openclaw/openclaw.json 配置文件，重启 Gateway：
openclaw gateway restart
日志确认连接成功：
feishu[yunying]: WebSocket client started feishu[main]: WebSocket client started
启用自动重启
停止前台运行的 Gateway，改用 LaunchAgent 方式启动：
# 先停掉前台运行的 Gateway
openclaw gateway install
openclaw gateway start
此后 Gateway 受 LaunchAgent 管理，断开后可自动重启。
总结
- 飞书多账号需使用
accounts字段配置，不可开启多个渠道。 - Gateway 必须使用
openclaw gateway start启动，确保由系统服务管理。
