事情是这样的

一天早上，我像往常一样打开飞书，准备跟小文聊几句。

消息发出去，等了几秒，没反应。

又等了一会儿，还是没反应。

我心里咯噔一下——别是又崩了吧？

打开浏览器，输入 http://localhost:18789 想看控制台，结果页面都打不开。

坏了，OpenClaw 网关直接没启动。

第一反应：重启大法

我第一反应就是——重启试试。

去服务里找到 OpenClaw，点了重启，等了一分钟……

还是不行。

再重启……

依然不行。

这时候我才意识到，问题没那么简单。

真相大白：配置文件坏了

我用命令行跑了一下诊断：

openclaw doctor

结果报了一段红字：

Invalid config at C:\Users\Admin\.openclaw\openclaw.json
Run "openclaw doctor --fix" to repair

原来是配置文件出问题了！

我回想了一下，昨晚好像手痒改过几个设置，估计是改完保存的时候出了问题。

更让我后怕的是——如果没备份，我的所有配置就全废了。

一键修复：doctor –fix

赶紧执行修复命令：

openclaw doctor --fix

几秒钟就跑完了。日志显示：

• 检测到配置文件无效

• 自动从备份中恢复

• 恢复成功，网关重新启动

就这么简单！OpenClaw 自己给自己做了个”换心手术”。

事后挖出的真相

后来我去翻稳定性日志（在 logs/stability/ 目录下），看到了当时的记录：

gateway.startup_failed
reason: Invalid config

原来系统启动时会校验配置文件，一旦发现格式不对，直接拒绝启动，防止你用坏配置跑出更严重的问题。

并且，doctor --fix 会自动从 .last-good 备份文件里恢复上一次正常运行的配置。

换句话说：OpenClaw 自带后悔药。

学到了什么

改配置前先备份——虽然系统有自动备份，但多一重保险总没错

崩了先跑 doctor——不要盲目重启，先诊断再行动

doctor --fix 是救命稻草——一键修复，比百度快多了

稳定性日志是个好东西——出事后去翻翻，能找到根因

实用小贴士

你可以定期跑一下 openclaw doctor 做健康检查，不用等出问题再看。就像每年体检一样，预防比治疗更省心。

以及——我后来养成了一个习惯：每次改配置前，先手动复制一份 openclaw.json 备份到桌面。这习惯救过我第二次（那是另一个故事了，后面会讲）。

下一篇预告：消息发出去石沉大海？一次意外重启的排查始末

小文AI踩坑记 · 小文AI实战笔记 番外篇