Codex 路由部署

哪些有效路由选择 Codex 运行时，以及基于该策略构建的部署形状。 Codex harness 指南的一部分； 每个部分移动的位置 列出每个部分。

路由和模型选择

当账户支持时，openai/gpt-6-astra 默认通过共享 OpenAI 提供程序策略进行 medium 推理工作。对于 OpenClaw- 托管轮次，已解决的工作量在 Codex turn/start 请求中发送，包括 collaborationMode.settings.reasoning_effort，因此本机线程使用与 Control UI 相同的默认值。明确的思维设置仍然获胜；为 high 配置的现有会话或代理保留在 high。附加有保留的本机设置的线程保留其本机工作。

将提供方引用和运行时策略分开：

• 使用openai/gpt-*进行标准OpenAI模型选择。单独的前缀永远不会选择 Codex。
• 当运行时未设置或设为 auto 时，只有完全匹配的官方 HTTPS Platform Responses 或 ChatGPT Responses 路由，且未编写提供方请求覆盖，才可以隐式选择 Codex。有效的模型级快速模式和截止时间控制不计为已编写的请求参数。
• 不要在配置中使用旧版 Codex GPT 引用；运行 openclaw doctor --fix 以修复旧版引用和过时的会话路由固定。
• agentRuntime.id: "codex" 使 Codex 成为兼容路由所需的运行时。它不会使不兼容的有效路由变得兼容。
• 当有意为提供方或模型启用嵌入式 OpenClaw 运行时时，使用 agentRuntime.id: "openclaw"。
• /codex ... 用于从聊天中控制原生 Codex 应用服务器对话。
• ACP/acpx 是独立的外部运行器路径。仅当用户要求使用 ACP/acpx 或外部运行器适配器时才使用它。

agents.defaults.imageModel 遵循相同的前缀拆分规则。正常的 OpenAI 路由请使用 openai/gpt-* ；只有当图像理解应通过受限的 Codex 应用服务器轮次运行时，才使用 codex/gpt-*。Doctor 会将旧版 Codex GPT 引用重写为 openai/gpt-*。

操作员角色模型权限

角色的 模型策略 适用于每个本机推理请求，包括重试、子轮流、普通评论、本机图像和搜索请求以及压缩。 OpenClaw 在转发之前会根据作品的原始权限和当前策略检查实际模型。已验证的目录到本机模型映射仍然有效。删除模型会取消受影响的推理，同时允许的工作继续进行。

重用本机子项不会永久附加其创建者的权限。在前一轮解决后，具有明确源属性的后轮使用其提交操作员的权限。当本机钩子集成处于活动状态时，将输入发送到活动回合需要相同的原始权限，包括本机执行可以在该回合中使用的后续请求。 Native Guardian 审查和配置的内存处理保留其现有的服务权限，并通过本机请求来源及其拥有的执行或配置的服务进行验证。

受限运行需要 OpenClaw- 拥有的本机推理路由。托管 stdio 连接可以通过公共 HTTPS 保留 HTTP 或 WebSocket 响应提供程序；已经拥有的本机绑定可以重用该路由。提供商投影共享连接的八条路由限制；多余的提供程序仍然无法用于受限的本机恢复，并且在达到容量后选择新路由需要新的托管本机连接。自定义提供程序需要显式的本机 base_url；查询字段使用本机 query_params 表。无主附件、本机本地模型提供程序、AWS-签名请求、系统代理配置文件、自定义本机证书文件以及无法同时保留上游路由和私有环回访问的代理设置无法建立此保证。 OpenClaw 在启动之前拒绝这些路径上的受限运行。没有模型策略的角色保留其现有的本机连接和可选挂钩行为。在不合格的操作符执行处于活动状态时引入模型策略会取消直接拥有的和其他明确绑定的工作，包括其不合格的子项。

当工作人员在没有模型策略的情况下运行并且合格的本机挂钩被禁用或不可用时，本机执行可以将接受的输入混合到现有轮次中，或将来自多个发送者的排队输入组合到新轮次中，而不保留唯一的发送者属性。在贡献发送者的授权结束或受到限制之后，先前接受的不再被唯一地归因的不受限制的输入可以在接收执行的有效权限下继续。仅匹配的本地根并不能证明唯一的归属。 OpenClaw 不会中断独立授权接收器的工作来猜测它消耗了哪个输入。

此限制并不免除新限制的工作或撤销直接或以其他方式明确约束的源。准确的归因需要合格的本机挂钩集成。访客访问需要明确的模型策略；其Codex运行需要合格的集成，因此其正常的限制流量不能进入此可选人员配置。

部署模式

基础 Codex 部署

使用 OpenAI 模型的快速启动配置，其有效的官方 HTTPS 路由有资格隐式选择 Codex：

{  plugins: {    entries: {      codex: {        enabled: true,      },    },  },  agents: {    defaults: {      model: "openai/gpt-6-astra",    },  },}

混合提供商部署

配置一个 Claude main agent，并添加一个命名的 Codex agent：

{  plugins: {    entries: {      codex: {        enabled: true,      },    },  },  agents: {    ownership: "explicit",    defaults: {      model: "anthropic/claude-opus-4-6",    },    entries: {      main: {        model: "anthropic/claude-opus-4-6",      },      codex: {        name: "Codex",        model: "openai/gpt-6-astra",      },    },  },}

该显式车队没有默认代理；目标main or codex通过一次会话，--agent，或绑定。这main代理使用其正常的提供者路径。这codex代理用途Codexapp-server何时生效OpenAI路线保持兼容；添加显式模型范围agentRuntime.id: "codex"什么时候Codex应该是必需的。

部署需要Codex

当捆绑插件可用时，符合条件的确切官方 HTTPS OpenAI 路由可以解析为 Codex。为配置的要求添加显式运行时策略以使用 Codex：

{  models: {    providers: {      openai: {        agentRuntime: {          id: "codex",        },      },    },  },  agents: {    defaults: {      model: "openai/gpt-6-astra",    },  },  plugins: {    entries: {      codex: {        enabled: true,      },    },  },}

在强制使用 Codex 的情况下，如果插件被禁用、应用程序服务器太旧或无法启动，或者 route/auth 支持在没有声明后备的情况下被拒绝，则 OpenClaw 会提前失败。编写的请求覆盖可以改为使用 选择时间 OpenClaw 回退 来保留确切的请求。一旦Codex启动，其故障就不会通过OpenClaw重放。