背景
在将 OpenClaw 接入飞书群机器人时,我遇到了两个典型问题:一是群内@机器人后无响应,二是 Gateway 服务频繁断开且难以自恢复。经过排查,发现主要是应用类型选择错误、多账号配置结构不当以及启动方式不规范导致的。
问题一:飞书消息无响应
日志中曾出现如下报错:
receive events or callbacks through persistent connection only available in self-build & Feishu app
这提示我们,最初配置的 App ID 对应的是快捷版或小程序类型的飞书应用,这类应用不支持 WebSocket 长连接来接收事件回调。正确的做法是向运维申请支持自建应用的机器人 ID,替换原有配置后即可正常收发消息。
问题二:Gateway 频繁断开
修改配置重启 Gateway 后,服务经常无故断开。若直接在前台运行 openclaw gateway,进程退出后不会自动拉起,必须手动执行 openclaw doctor --fix 重装才能恢复。
根本原因在于 LaunchAgent 虽然配置了 KeepAlive: true,但它只管理后台服务进程,不接管前台运行的命令行实例。因此,必须改用系统服务方式启动。
多账号配置方案
若需为不同 Agent(如运营 agent)绑定独立飞书机器人,不能简单开启多个渠道,而应在 channels 下定义 accounts 字段。
配置文件示例:
{
"channels": {
"feishu": {
"defaultAccount": "main",
"accounts": {
"main": {
"appId": "xxxxxxxxxxxxxxxx",
"appSecret": "abcdefghijklmnopqrstuvwxyz"
},
"yunying": {
"appId"


