OpenClaw升级后遇到 HTTP 500 500:404 NOT_FOUND？我的解决记录

大家好，我是平时爱折腾本地AI工具的程序员。最近把OpenClaw从旧版本直接拉到最新，其实也没有多旧，就是从2026.3.2升级到2026.3.8而已，结果一重启，开始对话就傻眼了Web UI 上面就显示红色的一串提示：

HTTP 500 500:404 NOT_FOUND

看着就头大。明明升级前一切正常，升级日志也没报错，就是突然连不上Gateway，agent发消息直接卡死。

我第一反应当然是官方推荐的万能钥匙：openclaw doctor。

openclaw doctor --fix

跑了两遍，输出都是“Everything looks good!”，连个警告都没有。我心想这下完了，是不是哪里配置彻底坏掉了？又去翻了GitHub issue、Discord群、文档，全搜了一圈，类似404的bug倒是有几个，但基本都是模型fallback或者OpenAI Responses API的锅，跟我这个“升级后全家桶挂掉”不太一样。

折腾了快一个小时，差点想直接卸载重装（想想又心疼之前配好的channels和skills）。最后抱着死马当活马医的心态，试了试最暴力的一招——直接跑openclaw onboard重置配置。（记得保存好原配置文件和skills文件夹，手动能力强的可以对比参照进行手动替换）

具体操作就两步：

1. 先停掉当前Gateway（保险起见）：

   openclaw gateway stop
   # 或者 systemctl stop openclaw-gateway （看你怎么装的daemon）

2. 执行重置向导：

   openclaw onboard --reset

   （注意加--reset会清掉旧config+credentials+sessions，文档说默认就是这个行为。我直接用了全量重置--reset-scope full，反正旧的东西我都备份过了）

向导一路点“Quick Start”走完，重新配了一下API token、channels……发现配置的项目又多了，兼容最新的ChatGPT 5.4模型。整个过程不到3分钟。（不愧是装了超10次的男人）

最后一项选择使用 Web UI，自动弹出页面，Say 个 hello ，能正常聊天了！那个该死的500:404直接消失得无影无踪。

为什么doctor没救回来，onboard却直接起死回生？

这其实是个挺典型的“升级遗留配置坑”。OpenClaw迭代速度挺快的（前身叫Clawdbot/Moltbot），3月头已经更新了4个版本，每次版本跳跃都可能改config schema，文档又没特别强调“升级必跑onboard重置”。我这次算是踩坑了，也算给后来人留个小经验。

这次折腾虽然浪费了点时间，但也让我对OpenClaw的配置机制又熟悉了一层。果然本地AI工具再好用，升级还是得谨慎啊。

希望这篇小文能帮到被500:404支配的你！下次再见～🦞