飞书接入龙虾后失联解决方法

一、最常见：Gateway 进程已停止（隔夜必查）

本地部署默认没有开机自启/守护，电脑休眠、重启、进程崩溃都会断连。

检查状态

bash

openclaw gateway status

• 显示 Runtime: stopped → 进程挂了

• 显示 RPC probe: failed → 网关异常

修复

bash

重启网关（80%问题秒解）

openclaw gateway restart

验证

openclaw gateway status --deep

预期：Runtime: running, RPC probe: ok

一劳永逸（开机/掉线自动重启）

bash

# Linux
systemctl enable --now openclaw

# macOS
openclaw gateway install
openclaw gateway start

二、飞书连接：WebSocket 长连接失效

OpenClaw 飞书靠 WebSocket 长连接，隔夜容易超时/断开。

1. 检查连接模式（必须 WebSocket）

打开 ~/.openclaw/openclaw.json

json

"feishu": {

"enabled": true,

"mode": "websocket" // 不能是 webhook

}

改完： openclaw gateway restart

2. 重新登录飞书渠道

bash

openclaw channels login feishu

按提示完成认证

3. 检查飞书开发者平台

• 应用状态：已发布（不是草稿）

• 事件订阅：启用长连接

• 权限：必须有 im:message 、 im:message:send_as_bot

三、授权/配对失效（隔夜常见）

1. 用户未授权 / 配对过期

发消息机器人可能返回：

Your Feishu user id: xxx, Pairing code: xxx

修复

bash

openclaw pairing approve feishu 配对码

2. AppID / AppSecret 配置丢失/错误

bash

重新配置

openclaw config set channels.feishu.config.appId "cli_xxx"

openclaw config set channels.feishu.config.appSecret "xxx"

openclaw gateway restart

四、模型 API 问题（能收消息但不回复）

1. API Key 过期/余额不足

查看日志：

bash

openclaw logs --follow

出现 No API key / insufficient balance → 重新配置模型密钥、检查余额

2. 网络无法访问大模型 API

• 本地网络/代理变动

• 境外 API 被墙

五、日志定位（终极）

bash

实时看网关日志

openclaw logs --follow --gateway

看飞书渠道日志

openclaw logs --follow | grep feishu

• 有 feishumain: received message → 收到消息但没处理（授权/路由）

• 无任何日志 → 网关没启动或长连接断了

• 有 Error → 按报错信息修复

六、隔夜稳定方案（必做）

1. 开启 Gateway 守护： systemctl enable openclaw （Linux）

2. 强制 WebSocket：禁用 webhook

3. 配置健康检查：每分钟自动重启掉线网关

4. 避免电脑休眠：本地服务器保持唤醒