这章是“从报错到定位”的入口页。你不需要先记住所有配置项，只要先把排障顺序走对，80% 的问题都能在几分钟内分层定位。
本章完成标准
你读完后应该能判断一个问题属于配置层、服务层、渠道层、会话层，还是 Skill 层，并知道下一步去哪一篇查。
这章解决什么问题
- 配置文件在哪、怎么安全修改、改完怎么验证。
- 服务正常但不回消息时，先查哪一层最省时间。
- ClawHub 安装与更新异常时，如何快速断点排查。
步骤一：先判定问题层级
- 配置层：配置项写错、变量缺失、权限过宽。
- 服务层：Gateway 状态异常、端口冲突、日志报错。
- 渠道层：Webhook/Token/配对与路由策略异常。
- 会话层：旧会话快照未刷新、上下文状态异常。
- Skill 层：依赖未满足、优先级覆盖、触发条件不清。
步骤二：先跑这组起手命令
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
openclaw security audit先用这组命令分层，再决定是否修改配置。不要先盲改。
步骤三：按顺序进入对应子页
常见误区
- 直接重装：很多问题其实是配置或会话层，不需要重装。
- 先改大量配置：容易制造二次故障。
- 只看 UI 不看日志：很难定位真实根因。