一、最常见：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
bash
# Linux
systemctl enable --now openclaw
bash
# macOS
openclaw gateway install
openclaw gateway start二、飞书连接：WebSocket 长连接失效
OpenClaw 飞书靠 WebSocket 长连接，隔夜容易超时/断开。
- 检查连接模式（必须 WebSocket）
打开 ~/.openclaw/openclaw.json
json
"feishu": {
"enabled": true,
"mode": "websocket" // 不能是 webhook
}
改完： openclaw gateway restart
- 重新登录飞书渠道
bash
openclaw channels login feishu
按提示完成认证
- 检查飞书开发者平台
-
应用状态：已发布（不是草稿）
-
事件订阅：启用长连接
-
权限：必须有 im:message 、 im:message:send_as_bot
三、授权/配对失效（隔夜常见）
- 用户未授权 / 配对过期
发消息机器人可能返回：
Your Feishu user id: xxx, Pairing code: xxx
修复
bash
openclaw pairing approve feishu 配对码
- AppID / AppSecret 配置丢失/错误
bash
重新配置
openclaw config set channels.feishu.config.appId "cli_xxx"
openclaw config set channels.feishu.config.appSecret "xxx"
openclaw gateway restart
四、模型 API 问题（能收消息但不回复）
- API Key 过期/余额不足
查看日志：
bash
openclaw logs --follow
出现 No API key / insufficient balance → 重新配置模型密钥、检查余额
- 网络无法访问大模型 API
-
本地网络/代理变动
-
境外 API 被墙
五、日志定位（终极）
bash
实时看网关日志
openclaw logs --follow --gateway
看飞书渠道日志
openclaw logs --follow | grep feishu
-
有 feishumain: received message → 收到消息但没处理（授权/路由）
-
无任何日志 → 网关没启动或长连接断了
-
有 Error → 按报错信息修复
六、隔夜稳定方案（必做）
-
开启 Gateway 守护： systemctl enable openclaw （Linux）
-
强制 WebSocket：禁用 webhook
-
配置健康检查：每分钟自动重启掉线网关
-
避免电脑休眠：本地服务器保持唤醒