OpenClaw 2026.5.6 紧急发布,因为doctor –fix 把 OAuth 路由改坏了

有用户在 Issues 里问：升了 2026.5.5 之后，之前配好的 GPT-5.5 Codex OAuth 突然失效了，重新走 API Key 路线了。我看了一眼发布记录，果然出事了——doctor 的自动修复功能，把一个好好的配置给”修”坏了。

5.6 今天出来，专门修这件事。发版的节奏说明问题确实比较严重，值得说说。

01 | doctor –fix 干了什么

OpenClaw 有个内置诊断命令 doctor –fix，设计初衷是帮用户自动修复配置问题。理论上很好用——你不知道哪里配错了，它帮你查，帮你改。

2026.5.5 版本里，这个命令检测到 openai-codex/* 路径下的配置时，判断逻辑出了问题：它把 ChatGPT 和 Codex 走的 OAuth 路由，悄悄改写成了标准的 OpenAI API Key 路由（openai/* 路径）。

如果你用的是 Codex OAuth 认证接入 GPT-5.5，而不是直接用 OpenAI API Key，那升级 5.5 之后 doctor 一旦运行，你的默认模型就可能被静默切换了，没有任何明显提示。

最危险的地方在于：表面上看起来还在用，只是走的路线变了。如果你没有仔细盯着日志，根本察觉不到。

02 | 这次 5.6 修了什么

修复内容直接、干脆，总共 4 个 Fix：

• OAuth 路由复原：doctor –fix 不再把有效的 openai-codex/* OAuth 路由改写成 openai/* API Key 路由。已经被 5.5 改坏的用户，需要手动跑一下恢复命令。
• 插件 fetch 头过滤：第三方插件带来的 Symbol 元数据不再被错误地传进 native fetch 或 Headers 构造器，避免插件请求被莫名拒绝。
• Debug 代理头处理：调试代理重放请求时，同样会先清理 Symbol 元数据，不再因为这个导致重放失败。
• 超时 fetch 清理：请求超时后正确释放 Gateway 通道，不再留着占位。

03 | 如果你已经被 5.5 影响了

官方给了一个恢复命令，在终端里跑一下：

第一条把默认模型重新指回 Codex OAuth 路线，第二条验证配置是否合法。跑完后确认一下 openclaw models list 里的默认项。

如果你不确定自己有没有受影响，可以先看一下现在的默认模型是不是还在 openai-codex/ 路径下。如果已经变成 openai/ 开头的，那就被改过了。

04 | 说几个不确定的地方

这次的 bug 是 doctor –fix 主动触发才会出问题，如果你从来不用 doctor，只是手动配置，理论上不受影响。但我没有完整验证每种配置组合，不保证没有其他边界情况。

插件 fetch 那两个修复（#77846、#78439）是社区贡献的，感谢 @shakkernerd 和 @obviyus，说明这两个坑已经有真实用户踩到了，不是小概率问题。

目前看 5.6 是个纯修复版本，没有新功能。主线还有 557 个提交在 main 上没进来，后续还会有更大的版本。

你们升了 5.5 之后有没有发现 OAuth 路由异常？评论区告诉我。

⭐点赞、转发、关注和推荐一键三连⭐