PythonSaaSAI
OpenClaw 对接飞书机器人：消息不回与 Gateway 断开问题排查
OpenClaw 对接飞书机器人常见问题排查。主要解决消息无响应、Gateway 频繁断开故障。原因涉及应用 ID 类型限制（需自建应用支持 WebSocket）、多账号配置结构错误（应使用 accounts 字段）及进程管理方式不当（需使用 LaunchAgent）。通过修正配置并改用系统守护进程启动，可实现自动重启与稳定通信。
OpenClaw 对接飞书机器人常见问题排查。主要解决消息无响应、Gateway 频繁断开故障。原因涉及应用 ID 类型限制（需自建应用支持 WebSocket）、多账号配置结构错误（应使用 accounts 字段）及进程管理方式不当（需使用 LaunchAgent）。通过修正配置并改用系统守护进程启动，可实现自动重启与稳定通信。
使用 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（yunying）单独配置飞书机器人时报 "unknown channel id"。飞书多账号需通过 accounts 字段配置，而非多个渠道。
正确 channels 配置示例：
{"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 的 KeepAlive 机制管理，导致进程退出后不会自动重启。
修改 ~/.openclaw/openclaw.json 配置文件，重启 Gateway：
openclaw gateway restart
日志确认两个机器人均连接成功：
feishu[yunying]: WebSocket client started feishu[main]: WebSocket client started
改用 LaunchAgent 方式管理进程，避免前台运行：
# 停止前台运行的 Gateway
openclaw gateway stop
# 使用 LaunchAgent 启动
openclaw gateway install
openclaw gateway start
此后 Gateway 将受系统守护进程管理，异常断开后可自动重启。
accounts 字段配置，不可开启多个渠道。openclaw gateway install/start 启动，确保由 LaunchAgent 管理。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具，curl 转代码在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online