路由与部署

哪些有效路由会选择 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。有效的模型级 Fast-mode 和截止时间控制不算作显式编写的请求参数。
• 不要在配置中使用旧版 Codex GPT 引用；运行 openclaw doctor --fix 来修复旧版引用和过期的会话路由固定。
• agentRuntime.id: "codex" 使 Codex 成为兼容路由的失败关闭要求。它不会让不兼容的有效路由变得兼容。
• agentRuntime.id: "openclaw" 在有意为之的情况下，将提供方或模型选入嵌入式 OpenClaw 运行时。
• /codex ... 控制来自聊天的原生 Codex 应用服务器会话。
• ACP/acpx 是独立的外部 harness 路径。仅在用户要求 ACP/acpx 或外部 harness 适配器时使用。

agents.defaults.imageModel 遵循相同的前缀拆分。普通 OpenAI 路由使用 openai/gpt-*，仅当图像理解应通过有界的 Codex app-server 轮次运行时使用 codex/gpt-*。Doctor 会将旧版 Codex GPT 引用重写为 openai/gpt-*。

操作员角色模型权限¶

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

重用原生子项不会永久附加其创建者的权限。在较早轮次结束后，具有明确来源归属的后续轮次会使用其提交操作员的权限。在原生钩子集成处于活动状态时，向活动轮次发送输入需要相同的原始权限，包括原生执行可以在该轮次中消费的后续请求。原生 Guardian 审查和已配置的记忆处理保留其现有服务权限，并从原生请求来源及其所属执行或已配置服务中验证。

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

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

此限制不会豁免新受限的工作，也不会豁免对直接绑定或以其他方式明确绑定来源的撤销。精确归属需要合格的原生钩子集成。访客访问需要显式模型策略；其 Codex 运行需要合格集成，因此其正常受限流程不能进入此可选工作人员配置。

部署模式¶

基础 Codex 部署¶

对于有效官方 HTTPS 路由有资格隐式选择 Codex 的 OpenAI 模型，使用快速入门配置：

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

混合提供商部署¶

配置一个 Claude main 代理并添加一个命名 Codex 代理：

{
  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",
      },
    },
  },
}

此显式舰队没有默认代理；使用会话、--agent 或绑定来指定 main 或 codex。main 代理使用其正常提供商路径。当 codex 代理的有效 OpenAI 路由保持兼容时，它使用 Codex app-server；当这应成为失败关闭要求时，添加显式模型范围的 agentRuntime.id: "codex"。

失败关闭 Codex 部署¶

当捆绑插件可用时，有资格的精确官方 HTTPS OpenAI 路由可以解析到 Codex。为书面失败关闭规则添加显式运行时策略：

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

当强制使用 Codex 时，如果插件已禁用、app-server 版本过旧或无法启动，或者路由/身份验证支持被拒绝且未声明回退，OpenClaw 会提前失败。已编写的请求覆盖项也可以改用选择时的 OpenClaw 回退，以保留精确的请求。一旦 Codex 启动，其失败不会通过 OpenClaw 重放。