OpenAI 设置

API 密钥（OpenAI 平台）

最适合： 直接 API 访问和按使用量计费。

openclaw onboard --auth-choice openai-api-key

openclaw onboard --openai-api-key "$OPENAI_API_KEY"

openclaw models list --provider openai

路由摘要

配置示例

{  env: { vars: { OPENAI_API_KEY: "example-openai-key-not-real" } },  agents: { defaults: { model: { primary: "openai/gpt-6-astra" } } },}

直接 API 的裸 gpt-5.6 别名也受支持，并会解析为 Sol 层级。如果此 API 组织不公开 GPT-5.6，请明确将 primary 设置为 openai/gpt-5.5。

要从 OpenAI API 尝试 ChatGPT 当前的 Instant 模型，请将模型设置为 openai/chat-latest：

{  env: { vars: { OPENAI_API_KEY: "example-openai-key-not-real" } },  agents: { defaults: { model: { primary: "openai/chat-latest" } } },}

chat-latest 是移动别名。新的 OpenAI API-key 设置改为使用 openai/gpt-6-astra。裸直接 API openai/gpt-5.6 别名仍然受支持并解析为 Sol。现有的显式初选（包括 openai/gpt-5.5）保持不变。 chat-latest 别名仅接受 medium 文本详细信息；对于该模型，OpenClaw 强制 medium 提供任何其他请求的详细信息。

Codex 订阅

最适合： 使用你的 ChatGPT/Codex 订阅，通过原生 Codex app-server 执行，而不是单独的 API 密钥。Codex 云需要 ChatGPT 登录。

openclaw onboard --auth-choice openai

openclaw models auth login --provider openai

openclaw models auth login --provider openai --device-code

openclaw models list --provider openai

路由摘要

配置示例

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

通过 API-key 备份，将所选模型保留在 openai/* 下，并将授权顺序放在 openai 下。 OpenClaw 首先尝试订阅，然后尝试 API 密钥，同时留在 Codex harness上：

{  plugins: { entries: { codex: { enabled: true } } },  agents: {    defaults: {      model: { primary: "openai/gpt-6-astra" },    },  },  auth: {    order: {      openai: [        "openai:[email protected]",        "openai:api-key-backup",      ],    },  },}

检查并恢复 Codex OAuth 路由

openclaw models statusopenclaw models auth list --provider openaiopenclaw config get agents.defaults.model --jsonopenclaw config get models.providers.openai.agentRuntime --json

对于特定代理，添加 --agent <id>：

openclaw models status --agent <id>openclaw models auth list --agent <id> --provider openai

如果较旧的配置仍包含传统 Codex GPT 引用，或在没有显式运行时配置的情况下仍有过期的 OpenAI 运行时会话固定，请修复它：

openclaw doctor --fixopenclaw config validate

如果 models auth list --provider openai 显示没有可用配置文件，请再次登录：

openclaw models auth login --provider openaiopenclaw models status --probe --probe-provider openai

对于同一代理中的多个 Codex OAuth 登录，请使用 --profile-id，然后通过认证排序或 /model ...@<profileId> -s 控制它们：

openclaw models auth login --provider openai --profile-id openai:ritsukoopenclaw models auth login --provider openai --profile-id openai:lain

在依赖配置文件顺序之前，请运行 openclaw doctor --fix 以迁移旧的传统 OpenAI Codex 前缀配置文件 id 和顺序条目。

状态指示器

聊天中的 /status 会显示当前会话正在使用哪个模型运行时。当符合条件的隐式路由或显式 provider/model 运行时策略选择它时，捆绑的 Codex app-server harness 会显示为 Runtime: OpenAI Codex。

Doctor 警告

如果配置或会话状态中仍保留传统 Codex 模型引用或过期的 OpenAI 运行时固定， openclaw doctor --fix 会将它们重写为带有 Codex 运行时的 openai/*，除非显式配置了 OpenClaw。

上下文窗口默认值和长上下文选择加入

OpenClaw 将原生模型容量和活动运行时预算视为两个独立的值：

• contextWindow 声明模型的本机窗口。
• contextTokens 限制 OpenClaw 为活动输入使用的窗口大小。

ChatGPT/Codex OAuth 遵循实时 Codex 帐户目录。当前目录通常宣传 GPT-5.6. Direct API-key GPT-5.5 和 GPT-5.6 模型的 272000 令牌活动窗口也默认为 272000 contextTokens，即使平台 API 公开了更大的本机窗口。这使得正常的延迟、质量和成本配置文件在不同的身份验证模式下保持一致。在该确切模型条目上使用 models.providers.openai.models[].contextTokens 覆盖直接模型的主动输入预算。

对于直接 API-key GPT-5.5 和 GPT-5.6，OpenAI 记录了 1050000 令牌提供程序窗口和 128000 最大输出令牌。保留全部输出限额可提供以下两个运行时配方使用的共享安全输入预算：

1050000 total - 128000 maximum output = 922000 safe active inputautomatic compaction threshold = 700000 active tokens

922000 是推导出的运行预算，并非提供商单独公布的输入限制。两个运行时会以不同方式转换该预算：嵌入式 OpenClaw 发送 Responses 压缩控制，而原生 Codex 管理自己的目录窗口和自动压缩。请参阅官方的 模型比较 和 GPT-5.5 模型页面。

嵌入式 OpenClaw 转换

此示例将精确的 Sol 模型固定到嵌入式 OpenClaw 运行时， 通过共享运行时控制启用 OpenAI API 快速模式，并要求 OpenAI Responses 在 700000 个活动令牌处执行压缩：

{  models: {    providers: {      openai: {        models: [          {            id: "gpt-5.6-sol",            name: "GPT-5.6 Sol",            contextWindow: 1050000,            contextTokens: 922000,            maxTokens: 128000,          },        ],      },    },  },  agents: {    defaults: {      model: { primary: "openai/gpt-5.6-sol" },      models: {        "openai/gpt-5.6-sol": {          agentRuntime: { id: "openclaw" },          params: {            fastMode: true,            responsesServerCompaction: true,            responsesCompactThreshold: 700000,          },        },      },    },  },}

OpenAI Responses 自动压缩会生成一个加密的 compaction 输出项。无状态客户端会将最新项带入下一次请求，并可以丢弃所有更早的输入项。 OpenClaw 会以不透明方式持久化该项，按路由、会话和认证阻止不当重用， 重放该项，清理被替换的前缀，使其经过工作进程转录提交，并从显示内容和诊断信息中移除。 切勿打印、记录或暴露加密内容。

在 OpenClaw 2026.8.1 上运行的进程拥有的隔离网关验证了这一确切的 openai/gpt-5.6-sol 配置。密集回合达到295098、586562和863664提示令牌。第三回合发出并持久保存一流的服务器压缩项；下一个请求重播了该确切的不透明项目，修剪了其前缀，并使用了 9602 提示标记。长响应产生 5480 输出令牌，持久标记在压缩和网关重新启动中幸存下来，重新启动延迟为 12081 毫秒，每次调用都报告 serviceTier: priority，整个套件花费了 220.03 秒。这些时间是观察结果，而不是服务水平保证。

原生 Codex 转换

保持相同的 OpenClaw 模型选择，但将 Codex 设为显式运行时， 并且不要向此模型条目添加 Responses 压缩参数：

{  agents: {    defaults: {      model: { primary: "openai/gpt-5.6-sol" },      models: {        "openai/gpt-5.6-sol": {          agentRuntime: { id: "codex" },          params: { fastMode: true },        },      },    },  },}

Codex 必须接收 context_window 和 max_context_window 的 922000，auto_compact_token_limit 的 700000，以及与 model_auto_compact_token_limit_scope=total 匹配的应用程序服务器覆盖。 Codex 然后应用其 95% 的有效窗口储备，产生 875900 活跃代币。配置有序的 OpenAI API-key 配置文件，并保留默认的隔离代理范围 Codex 主目录。完整的目录、应用程序服务器、身份验证和重新启动配方位于 Codex harness长上下文 中。

这些示例是两个明确的运行时选择，而不是一个会自动选择的配置。 以模型为范围的 agentRuntime 和由运行时负责的压缩设置必须同步更改。 OpenClaw 只有在两者的模型引用或代理配置可区分时，才能同时保留这两种选择； 否则，应将模型运行时及其匹配配置作为一个原子更改一起切换。然后重启 Gateway 和原生 Codex app-server，运行 /model default -s，并开始新的聊天。 现有的原生 Codex 线程会保留创建时记录的提供商和模型。

目录恢复

OpenClaw 在可用时会对 gpt-5.5 使用上游 Codex 目录元数据。若实时 Codex 发现在账户已通过认证时仍省略了 gpt-5.5 行，OpenClaw 会合成该 OAuth 模型行， 以免 cron、子代理以及配置的默认模型运行因 Unknown model 而失败。