一、版本概览openclaw 在 2026年5月7日发布了v2026.5.6版本。这次更新虽然看起来是一个小版本但实际涉及多个关键修复特别是Doctor/OpenAI Codex 路由回退问题、插件/runtime fetch 请求头兼容问题、debug proxy 请求重放问题、以及web fetch 超时清理问题。这些问题都和使用体验、请求稳定性以及认证路由有关属于非常值得关注的修复内容。如果你正在使用 openclaw尤其是涉及openai-codex、ChatGPT/Codex OAuth、OpenAI API key、插件请求、调试代理、Web fetch等场景那么这次更新建议认真阅读。下面我会按照原始更新内容完整梳理 v2026.5.6 的修复点并整理成适合 CSDN 发布的技术文章内容。二、v2026.5.6 修复内容总览本次版本主要包含以下修复Doctor/OpenAI Codex回退 2026.5.5 的 doctor --fix 修复行为纠正此前会把合法的openai-codex/*ChatGPT/Codex OAuth 路由错误重写成openai/*的问题。这个错误可能导致OAuth-only GPT-5.5 配置失效用户被意外切换到 OpenAI API key 路由如果 2026.5.5 已经改变了默认模型需要执行指定命令把默认 agent 切回 Codex OAuth PI 路由。Plugins/runtime fetch请求头字典中过滤第三方 symbol 元数据在将普通 request header dictionaries 传给 native fetch 或 Headers 之前先移除第三方 symbol metadata。这样可以避免 SDK 和 guarded/proxy fetch 路径拒绝本来合法的插件请求。Debug proxy规范化捕获的 fetch header dictionaries在重放请求前对捕获到的 fetch 请求头字典进行规范化。避免 caller-owned header 对象中的 symbol metadata 导致 debug-proxy fetch 失败。Web fetch限制 guarded dispatcher cleanup 在请求超时后的清理行为让超时的 fetch 返回工具错误而不是让 Gateway tool lanes 一直处于活动状态。三、重点修复一Doctor/OpenAI Codex 路由回退问题这是本次更新最重要的修复之一。3.1 问题背景在 2026.5.5 中doctor --fix的修复行为存在一个回退问题它可能会把原本合法的openai-codex/*ChatGPT/Codex OAuth 路由错误地重写为openai/*。这会带来什么后果可能破坏 OAuth-only GPT-5.5 配置可能把用户从 OAuth 路由意外切换到 OpenAI API-key 路由可能导致默认模型和默认 agent 配置发生变化可能让原本正常工作的认证方式变得不可用也就是说本来应该走 Codex OAuth 的场景可能被错误改写成 OpenAI 路由从而引发一系列认证与模型调用问题。3.2 本次修复的意义v2026.5.6 对这个问题进行了回退修复目的是恢复openai-codex/*路由的正确性避免doctor --fix误改配置让 OAuth-only GPT-5.5 场景重新回到正确的 Codex OAuth PI 路由减少由于配置被误写带来的排查成本如果你在 2026.5.5 更新后发现默认模型发生变化或者认证方式不对那么这次更新就是直接的修复版本。3.3 如果已经被影响应该怎么恢复官方给出的处理方式非常明确如果 2026.5.5 已经改变了你的默认模型需要运行以下命令把默认 agent 切回 Codex OAuth PI 路由openclaw modelssetopenai-codex/gpt-5.5openclaw config validate这条命令的作用可以拆开理解openclaw models set openai-codex/gpt-5.5将默认模型设置回openai-codex/gpt-5.5重新回到 Codex OAuth 路由openclaw config validate校验当前配置是否正确确认修复后配置没有问题这一步非常重要因为它不只是“改回模型名字”而是把默认 agent 的路由逻辑也一并拉回正确轨道。四、如何检查并恢复 Codex OAuth 路由官方在更新说明中给出了完整的检查命令。如果你想确认当前默认 agent 用的到底是哪个模型、哪个 runtime、哪个 auth route可以执行以下命令。4.1 查看默认 agent 的模型、runtime、认证路由openclaw models status openclaw models auth list--provideropenai-codex openclaw config get agents.defaults.model--jsonopenclaw config get agents.defaults.agentRuntime--json这些命令分别用于openclaw models status查看当前模型状态openclaw models auth list --provider openai-codex查看 openai-codex provider 下可用的认证信息openclaw config get agents.defaults.model --json查看默认模型配置openclaw config get agents.defaults.agentRuntime --json查看默认 agent runtime 配置通过这些命令可以快速判断默认 agent 是否还在正确的 OAuth 路由上。4.2 查看指定 agent 的状态如果你需要检查某一个特定 agent而不是默认 agent可以使用--agent id参数。openclaw models status--agentidopenclaw models auth list--agentid--provideropenai-codex这适合多 agent 配置场景。比如某个 agent 使用 Codex OAuth另一个 agent 使用不同路由你就可以针对性排查。4.3 如果旧配置仍然有问题执行修复官方建议如果旧配置里还保留着openai-codex/gpt-*或者有 stale 的 OpenAI PI session pin就需要修复openclaw doctor--fixopenclaw config validate这里要注意的是doctor --fix是修复配置config validate是检查配置有效性也就是说修复之后一定要验证不要只做一半。4.4 如果没有可用的 openai-codex profile需要重新登录如果执行下面这条命令后发现没有可用 profileopenclaw models auth list--provideropenai-codex那么需要重新登录openclaw models auth login--provideropenai-codex登录完成后再做探测确认openclaw models status--probe--probe-provider openai-codex这一步的意义是验证认证是否恢复provider 是否可用探测是否成功4.5 重要概念说明官方特别强调openai-codex仍然是auth/profile provider idopenai/*是OpenAI agent turns through Codex 的 model route这句话非常关键容易混淆。也就是说openai-codex负责认证/配置身份openai/负责模型路由这次问题之所以重要就是因为路由被错误改写后可能把认证和模型路径混在一起导致配置偏离原意。五、重点修复二Plugins/runtime fetch 请求头兼容问题第二个修复和请求头处理有关。5.1 问题表现在 plugins/runtime fetch 场景中普通 request header dictionaries 在传入 native fetch 或 Headers 之前可能携带了第三方 symbol metadata。结果就是SDK 可能拒绝该请求guarded/proxy fetch 路径可能拒绝该请求原本合法的插件请求反而无法通过这类问题通常很隐蔽因为表面上请求头看起来没有明显错误但底层对象附带了额外的 symbol 元数据触发了 fetch 或 Headers 的兼容性问题。5.2 本次修复做了什么v2026.5.6 的处理方式是在把普通 request header dictionaries 交给 native fetch 或 Headers 之前先移除第三方 symbol metadata这样做的目标非常明确让插件请求更稳定避免 SDK 拒绝合法请求避免 guarded/proxy fetch 路径报错提升 runtime fetch 的兼容性换句话说系统会先“清理请求头字典”再交给底层 fetch 机制处理避免 metadata 干扰请求。5.3 这对开发者意味着什么如果你在使用插件、runtime fetch、SDK 或 guarded/proxy fetch并且遇到莫名其妙的请求拒绝问题这次修复很可能正是你需要的版本。它不是功能新增而是兼容性层面的稳定性增强减少请求被错误拒绝减少 header 对象结构带来的副作用让合法请求更顺畅地通过底层 fetch六、重点修复三Debug proxy 请求重放失败问题第三个修复和 debug proxy 有关。6.1 问题背景debug proxy 在捕获请求后需要重放请求。但在这个过程中捕获到的 fetch header dictionaries 如果带有 caller-owned header 对象里的 symbol metadata就可能导致重放失败。也就是说问题发生在请求被 debug proxy 捕获头信息被保存重放时原始对象中的 symbol metadata 干扰了 fetch导致 debug-proxy fetch 失败6.2 修复内容v2026.5.6 的修复策略是在重放请求之前先规范化捕获的 fetch header dictionaries这样可以确保caller-owned header 对象中的 symbol metadata 不会污染重放请求debug proxy fetch 不会因为元数据而失败请求重放过程更加稳定6.3 修复价值这个修复对于调试场景非常重要。因为 debug proxy 本身就是用于排查问题的工具如果它自己的请求重放都不稳定那么调试工作会被进一步放大困难。本次规范化处理能够减少以下问题重放失败头信息异常由 symbol metadata 触发的兼容问题七、重点修复四Web fetch 超时后的 guarded dispatcher 清理问题第四个修复和 Web fetch 超时有关。7.1 问题描述在 Web fetch 中如果请求超时guarded dispatcher 的清理行为没有被合理限制可能导致timed-out fetch 没有正确返回工具错误Gateway tool lanes 一直保持 active 状态后续请求或资源管理受到影响这类问题会让系统看起来像“卡住了”因为超时后本该结束的 lane 没有及时释放。7.2 本次修复怎么处理v2026.5.6 的修复是对 guarded dispatcher cleanup 做边界控制让请求超时后返回工具错误避免 Gateway tool lanes 一直处于 active 状态这样做可以让超时行为更符合预期超时就是超时失败就返回工具错误不会因为清理不当导致资源悬挂7.3 修复带来的好处这类修复虽然不直接改变用户界面但对系统稳定性非常重要减少超时后资源残留避免工具通道一直占用提升 Web fetch 的错误反馈质量避免后续链路被连带影响八、这次更新适合哪些场景重点关注如果你属于以下任意一种情况建议重点阅读并及时检查版本使用 openai-codex / ChatGPT / Codex OAuth 路由使用 OAuth-only GPT-5.5 配置曾经执行过doctor --fix默认模型突然变化插件请求偶发被拒绝SDK 或 guarded/proxy fetch 兼容性异常debug proxy 重放请求失败Web fetch 超时后工具通道未释放九、推荐的处理顺序如果你是从 2026.5.5 升级过来或者怀疑受到影响可以按以下顺序处理第一步查看当前状态openclaw models status openclaw models auth list--provideropenai-codex openclaw config get agents.defaults.model--jsonopenclaw config get agents.defaults.agentRuntime--json第二步如果是指定 agent再查指定 agentopenclaw models status--agentidopenclaw models auth list--agentid--provideropenai-codex第三步如有旧配置问题执行修复openclaw doctor--fixopenclaw config validate第四步如无可用 profile重新登录openclaw models auth login--provideropenai-codex openclaw models status--probe--probe-provider openai-codex第五步如果 2026.5.5 已经改乱默认模型手动切回openclaw modelssetopenai-codex/gpt-5.5openclaw config validate十、更新总结openclaw v2026.5.6 虽然没有引入大量新功能但这次修复非常关键核心可以概括为以下几点修复 doctor --fix 对 openai-codex/路由的错误重写*避免 OAuth-only GPT-5.5 场景被破坏避免用户意外切到 OpenAI API-key 路由增强 plugins/runtime fetch 对 header metadata 的兼容性提升 debug proxy 请求重放稳定性修复 Web fetch 超时后 gateway tool lanes 残留问题