写在前面
从这一步开始，你要学的不是新功能，而是怎么稳定地维护 OpenClaw。
后面无论你接模型、接平台、装技能还是做部署，都会反复回到状态、日志、配置和重启这几个入口。
第一步：先学会看状态
每次觉得系统不对劲时，先不要猜原因，先看状态。
openclaw status如果你要做更深入的检查，再跑：
openclaw status --deep你要重点确认的是：
- Gateway 是否在运行；
- 当前配置有没有明显异常；
- 深度检查里是否出现模型、连接或渠道层面的错误。
第二步：日志要和每次改动绑在一起看
日志是最重要的排错入口。
openclaw logs --follow如果你只是回看最近输出，用：
openclaw logs --limit 100建立这个习惯：
- 配置一改，立刻看日志；
- 消息一发，立刻看日志；
- 结果不对，先看日志再下结论。
不要只根据聊天入口有没有响应来猜问题。
第三步：改配置时先看路径，再改值
先找出当前配置文件位置：
openclaw config file修改前如果你只是想确认某个值，先查：
openclaw config get agents.defaults.workspace如果你要设置某个字段，再改：
openclaw config set agents.defaults.heartbeat.every "2h"这一步最重要的不是记住具体字段，而是形成顺序：
- 先确认配置文件和当前值；
- 一次只改一类问题；
- 改完立刻验证。
第四步：每次改完配置，都先验证再重启
更稳妥的顺序是：
openclaw config validate
openclaw gateway restart
openclaw status如果你想一边重启一边看结果，可以同时开着：
openclaw logs --follow判断标准：
config validate没有报格式或字段错误；- Gateway 能正常重启；
- 重启后状态恢复正常，没有新增持续报错。
第五步：先掌握这组高频命令
日常维护阶段，优先把这组命令用熟：
openclaw status
openclaw status --deep
openclaw logs --follow
openclaw doctor
openclaw configure
openclaw gateway restart
openclaw config validate
openclaw dashboard它们分别解决的是：
- 现在系统是否正常；
- 问题更像落在哪一层；
- 最近到底报了什么错；
- 配置改动是否已经生效；
- 需要时怎样重新进入配置向导。
常见错误或风险
- 不要一次改很多配置项；
- 不要跳过
config validate就直接重启； - 不要只凭聊天入口是否回复来判断系统健康；
- 没有已知可用基线时，不要持续叠加改动。
下一步
基础维护入口熟悉之后，继续看 技能系统入门。