OpenClaw 对接飞书机器人时出现消息不回复及 Gateway 频繁断开问题。主要原因包括使用了不支持 WebSocket 的快捷版应用 ID、多账号配置字段错误以及未使用 LaunchAgent 管理进程。解决方案为申请正确的自建应用 ID、在配置文件中通过 accounts 字段定义多账号并正确绑定路由、改用 openclaw gateway start 命令启动服务以确保自动重启。
用 OpenClaw 配置飞书机器人时遇到了两个常见问题：群消息无响应、Gateway 频繁断开。经过排查已解决，记录如下供参考。
在飞书群里 @ 机器人后完全无反应。状态显示连接正常，但无法接收或发送消息。
执行 openclaw gateway restart 或空闲时 Gateway 均可能断开。再次启动报错，需运行 openclaw doctor --fix 重新安装才能恢复。
日志提示：
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 收到 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 字段配置，不可开启多个渠道。openclaw gateway start 启动，确保由系统服务管理。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online