提供商与路由修复
检查 2b-2g 涵盖提供商覆盖、浏览器和 Chrome MCP 就绪状态、 OAuth TLS 前提条件,以及路由清理。
检查 2b-2g¶
2b. OpenCode 提供商覆盖
如果你已手动添加 models.providers.opencode、opencode-zen 或 opencode-go,同时匹配的官方外部插件已安装并启用,则会覆盖该插件提供的模型目录。这可能会将模型强制指向错误的 API,或将成本清零。Doctor 会发出警告,以便你移除该覆盖并恢复按模型的 API 路由和成本。如果没有匹配的插件,该条目仍是一个有效的独立自定义提供商。
2c. 浏览器迁移和 Chrome MCP 就绪状态
如果扩展驱动配置仍然携带已弃用的中继 cdpUrl,doctor 会移除该 URL,同时保留 driver: "extension";当前扩展中继拥有其端点。
当 browser.extensionRelay.allowLegacyAuth 启用时,Doctor 会发出警告。请将配对的 Chrome 扩展和外部 CDP 客户端升级到 Browser Relay Authentication v2,然后将该标志设置为 false。V2 客户端不会降级到旧版身份验证。
Doctor 不会检查个人浏览器配置中可选扩展的就绪状态或 Cookie 导入可用性。它会将可导入的 Cookie 数据库数量报告为不可用,而不是零。当存在稳定的 Chrome 扩展副本时,Doctor 会将其原生引导状态报告为未检查;openclaw doctor --fix 会跳过原生主机注册修复。
在托管 Chrome 的机器上,运行 openclaw browser extension status --json 以显式检查注册;这可能会请求浏览器配置访问权限。如果升级后遗留了过时的原生主机目标,请运行 openclaw browser extension install --no-store,通过显式安装程序进行修复,而不请求商店安装。安装程序拒绝覆盖外部的同名清单或启动器。状态会区分已请求的安装、Chrome 批准以及原生主机注册健康状况;它不能证明存在实时中继连接。
对于初始设置,请运行 openclaw browser extension install。在 macOS 上,这还会请求在 Google Chrome 中进行官方商店安装;重新打开 Chrome,并在提示时批准或启用 OpenClaw。其他浏览器和平台需要手动商店安装。未打包的稳定路径仍作为开发回退方案,使用 openclaw browser extension install --no-store。显式 Cookie 导入仍需要单独的同意。
当你使用 defaultProfile: "user" 或已配置的 existing-session 配置时,Doctor 还会审计主机本地 Chrome MCP 路径:
- 检查默认自动连接配置是否在同一主机上安装了 Google Chrome
- 检查检测到的 Chrome 版本,并在低于 Chrome 144 时发出警告
- 提醒你在浏览器检查页面中启用远程调试(例如
chrome://inspect/#remote-debugging、brave://inspect/#remote-debugging或edge://inspect/#remote-debugging)
Doctor 无法替你启用 Chrome 端设置。主机本地 Chrome MCP 仍要求在网关/节点主机上运行本地 Chromium 系浏览器 144+,启用远程调试,并在浏览器中批准首次附加同意提示。
此处的就绪状态仅涵盖本地附加前提条件。Existing-session 保留当前 Chrome MCP 路由限制;诸如 responsebody、PDF 导出、下载拦截和批量操作等高级路由仍需要受管浏览器或原始 CDP 配置。此检查不适用于 Docker、沙箱、远程浏览器或其他无头流程,这些流程继续使用原始 CDP。
2d. OAuth TLS 前提条件
当配置了 OpenAI Codex OAuth 配置时,doctor 会检查 OpenAI 授权端点,以验证本地 Node/OpenSSL TLS 栈能否验证证书链。如果检查因证书错误失败(例如 UNABLE_TO_GET_ISSUER_CERT_LOCALLY、证书过期或自签名证书),doctor 会打印特定平台的修复指导。在 macOS 上使用 Homebrew Node 时,修复方法通常是 brew postinstall ca-certificates。使用 --deep 时,即使网关健康,也会运行该检查。
2e. Codex OAuth 提供商覆盖
如果你之前已在 models.providers.openai-codex 下添加了旧版 OpenAI 传输设置,它们可能会遮蔽内置的 Codex OAuth 提供商路径。当 Doctor 看到这些旧传输设置与 Codex OAuth 同时存在时,会发出警告,以便你移除或重写过时的传输覆盖,并恢复当前路由行为。自定义代理和仅头部覆盖仍受支持,并且不会触发此警告,但这些已编写的请求路由不符合隐式 Codex 选择条件。
2f. Codex 路由修复
Doctor 会检查旧版 openai-codex/* 模型引用。原生 Codex 框架路由使用规范的 openai/* 模型引用,但仅凭前缀永远不会选择 Codex。当运行时策略未设置或为 auto 时,只有完全匹配的官方 HTTPS Platform Responses 或 ChatGPT Responses 路由,且没有已编写的请求覆盖,才符合条件。参见 OpenAI 隐式代理运行时。
在 --fix / --repair 模式下,doctor 会重写受影响的默认代理和每个代理的引用,包括主模型、回退、图像/视频生成模型、心跳/子代理/压缩覆盖、钩子、通道模型覆盖以及过时的持久化会话路由状态:
openai-codex/gpt-*变为openai/gpt-*。- Codex 意图会移动到已修复代理模型引用的提供商/模型作用域
agentRuntime.id: "codex"条目中。 - 由于运行时选择是提供商/模型作用域的,因此会移除过时的持久化会话运行时固定。
- 除非修复的旧版模型引用需要 Codex 路由以保留旧身份验证路径,否则现有提供商/模型运行时策略会被保留。
- 现有模型回退列表会被保留,其旧版条目会被重写;复制的按模型设置会从旧版键移动到规范的
openai/*键。 - 持久化会话的
modelProvider/providerOverride、model/modelOverride、回退通知和身份验证配置固定会在所有发现的代理会话存储中修复。 - Doctor 会单独修复过时的
agentRuntime.id: "codex-cli"固定(一个不同的旧版运行时 id),将其在agents.defaults、agents.entries.*和models.providers.*模型条目中改为"codex"。 /codex ...表示“从聊天中控制或绑定原生 Codex 对话。”/acp ...或runtime: "acp"表示“使用外部 ACP/acpx 适配器。”
2g. 会话路由清理
Doctor 还会扫描已发现的 agent 会话存储,检查在你将已配置的模型或运行时从插件拥有的路由(例如 Codex)移开后遗留的自动创建的路由状态。
openclaw doctor --fix 可以在其所属路由不再配置时,清除自动创建的过期状态,例如 modelOverrideSource: "auto" 模型固定项、运行时模型元数据、已固定的 harness id、CLI 会话绑定以及自动 auth-profile 覆盖。显式的用户或旧版会话模型选择会被报告以供人工审查,并保持原样;当该路由不再需要时,请使用 /model ...、/new 切换,或重置会话。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw