OpenClaw 中文文档 下载 App

OpenClaw 故障速查:渠道、节点与升级后的高频问题

日常运维三大高发区:渠道、移动节点、版本升级。每类给一条最短排查路径。

渠道:机器人不回消息

  1. 看日志:openclaw logs --follow,然后发条消息。
  2. 无入站日志 → 渠道凭证问题:令牌失效、WhatsApp 会话掉线(重新扫码)、机器人被踢出群。
  3. 有入站无回复 → 权限链问题:私信没批准?群组不在允许列表?没 @ 机器人?发送者不在白名单?逐层过(规则详见 群聊规则)。
  4. Telegram 特有:持续报 409 冲突 = 另一个程序(多半是另一个网关实例)在用同一个机器人令牌轮询。
  5. 收尾:渠道层专项修复后重启网关;配置键是旧格式的让 doctor --fix 清一遍。

移动节点:手机连不上/能力失效

  1. 手机设置页看连接状态与权限档位(Full/Limited)——受限档说明走了明文通道,换 wss 端点重新配对(见 远程访问)。
  2. 局域网发现失败:路由器隔离了 mDNS?改用设置码或手动填地址。
  3. 节点能力(相机/麦克风)失效:系统权限弹窗没批、应用不在前台(能力仅前台可用)、或另一个网关握着焦点——多网关场景检查焦点设置。
  4. 网关侧:openclaw nodes status 看节点在不在,不在就重新走设备批准。

升级后:行为突然变了

  1. openclaw gateway restart ——确认新代码真的在跑。
  2. openclaw doctor --fix ——清理停用配置键、迁移旧格式(心跳文件、白名单、流式配置都可能被改名)。
  3. 看 skills 快照:技能清单在会话启动时快照,改了技能要开新会话(/new)或等监视器刷新。
  4. 手机端更新后行为异常:检查是否混用了商店/安装包两条更新通道——可能要求卸载重装,本地数据会清空。
  5. 仍异常 → openclaw status --all 生成完整诊断,带着去提 issue。

万能三步

进程(status)→ 配置(doctor)→ 模型(models status)。三层各自通过后问题仍复现,用日志定位到具体环节再对症下药——比到处试配置快得多。

相关阅读:诊断命令、更新卸载。