先看报错
像先听它喊哪里疼。
Help 导读
2分钟故障排查：先跑这7条命令，再查具体问题
遇到OpenClaw异常时，按顺序执行`openclaw status`→`gateway probe`→`doctor`→`logs --follow`，输出中看到`works`或`audit ok`即为正常。最容易忽略的是`gateway probe`返回`RPC: limited - missing scope: operator.read`并非连接失败，只是诊断降级。如果本地OpenAI后端直连正常但通过OpenClaw代理失败，先检查`requiresStringContent`和`supportsTools`两个兼容开关。
先讲这一页到底在解决什么
2分钟故障排查：先跑这7条命令，再查具体问题
遇到OpenClaw异常时，按顺序执行`openclaw status`→`gateway probe`→`doctor`→`logs --follow`，输出中看到`works`或`audit ok`即为正常。最容易忽略的是`gateway probe`返回`RPC: limited - missing scope: operator.read`并非连接失败，只是诊断降级。如果本地OpenAI后端直连正常但通过OpenClaw代理失败，先检查`requiresStringContent`和`supportsTools`两个兼容开关。
第一站
🚦 先按顺序排，不要一上来就乱修
故障排查最重要的是顺序：先确认症状，再确认范围，最后才动手。
先看日志
像翻事故现场回放。
先做最小修复
像先拧紧最松的那颗螺丝。
第二站
🛠 常用动作像在做什么
官方这类页面一般会把最实用的动作摆在前面：看日志、跑 doctor、检查配置。
`openclaw doctor`
像先做一次全身检查。
`openclaw logs`
像翻刚刚发生了什么。
重启 / 重新构建
像把卡住的玩具先停一下，再重新拼。
最后记住
🎈 Troubleshooting 的重点，是先稳住再动手
故障页不是让你慌，是让你按顺序把问题一层层剥开。