OpenClaw 排错清单：doctor、gateway 状态与首次失败怎么查

入门 新手 预计 20 分钟 发布于 2026/2/12

为什么这篇值得先看

真正有用的排错，不是把所有命令都背下来，而是知道顺序。OpenClaw 的问题通常集中在配置、服务状态、授权配对和渠道策略四层。

先抓住这 3 个关键点

• openclaw doctor 负责快速发现显性的环境和配置问题，是第一道筛查。
• 如果服务没有稳定起来，后面所有 Dashboard、Control UI 和 channels 现象都只是表象。
• 配对、allowlist、groupPolicy 这类“逻辑错误”，通常不会靠重装解决。

实操步骤

1. 先执行 openclaw doctor，看是否有可直接修复的项；如果官方建议可自动修复，再尝试 openclaw doctor --fix。
2. 确认 gateway 和 dashboard 是否能稳定起来，别在服务不稳定时继续调 channels。
3. 去 Control UI 看 auth、pairings、logs 是否有明确的失败点，不要只凭终端一条错误信息猜。
4. 最后才针对具体渠道排查：Telegram 看 bot token 和 dmPolicy，WhatsApp 看 session 和 selfChatMode，Browser 看登录态和扩展。

配置或命令示例

openclaw doctor
openclaw doctor --fix
openclaw dashboard

常见坑

• 同时改 token、channel、browser、plugin，最后不知道是哪一项真的修好了问题。
• 看见 pairing 失败就重装，结果把原本还能用的 session 一起清掉。
• 忽略 Control UI 里的 auth / logs，只看终端最后一行错误。

完成检查

• 你已经能按固定顺序排查，而不是边猜边改。
• doctor 不再报致命错误，Dashboard / Control UI 能给出清晰状态。
• 同类问题下次出现时，你知道先去哪一层找根因。

为什么建议把这篇收藏起来

• 这篇是所有后续教程的“兜底页”，每次接新能力都可能回来看。
• 真正可复用的不是某个命令，而是这套排错路径。