OpenClaw 故障速查:渠道、节点与升级后的高频问题
日常运维三大高发区:渠道、移动节点、版本升级。每类给一条最短排查路径。
渠道:机器人不回消息
- 看日志:openclaw logs --follow,然后发条消息。
- 无入站日志 → 渠道凭证问题:令牌失效、WhatsApp 会话掉线(重新扫码)、机器人被踢出群。
- 有入站无回复 → 权限链问题:私信没批准?群组不在允许列表?没 @ 机器人?发送者不在白名单?逐层过(规则详见 群聊规则)。
- Telegram 特有:持续报 409 冲突 = 另一个程序(多半是另一个网关实例)在用同一个机器人令牌轮询。
- 收尾:渠道层专项修复后重启网关;配置键是旧格式的让 doctor --fix 清一遍。
移动节点:手机连不上/能力失效
- 手机设置页看连接状态与权限档位(Full/Limited)——受限档说明走了明文通道,换 wss 端点重新配对(见 远程访问)。
- 局域网发现失败:路由器隔离了 mDNS?改用设置码或手动填地址。
- 节点能力(相机/麦克风)失效:系统权限弹窗没批、应用不在前台(能力仅前台可用)、或另一个网关握着焦点——多网关场景检查焦点设置。
- 网关侧:openclaw nodes status 看节点在不在,不在就重新走设备批准。
升级后:行为突然变了
- openclaw gateway restart ——确认新代码真的在跑。
- openclaw doctor --fix ——清理停用配置键、迁移旧格式(心跳文件、白名单、流式配置都可能被改名)。
- 看 skills 快照:技能清单在会话启动时快照,改了技能要开新会话(/new)或等监视器刷新。
- 手机端更新后行为异常:检查是否混用了商店/安装包两条更新通道——可能要求卸载重装,本地数据会清空。
- 仍异常 → openclaw status --all 生成完整诊断,带着去提 issue。
万能三步
进程(status)→ 配置(doctor)→ 模型(models status)。三层各自通过后问题仍复现,用日志定位到具体环节再对症下药——比到处试配置快得多。