设置

比较 OpenAI 身份验证方法，以根据模型访问、托管插件、使用跟踪和权限进行选择。

开始使用¶

**最佳适用场景：**直接访问 API 并按使用量计费。

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

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

openclaw models list --provider openai

### 路由概览 {#route-summary}

| 模型引用        | 运行时策略或路由事实                                 | 路由                     | 认证                              |
| ---------------- | ------------------------------------------------------------- | ------------------------- | --------------------------------- |
| `openai/gpt-5.6` | 未设置/`auto`，精确匹配官方 HTTPS 原生路由，无请求覆盖 | 可能选择 Codex     | 有序 API 密钥认证配置文件      |
| `openai/gpt-5.6` | 提供方/模型 `agentRuntime.id: "openclaw"`                  | OpenClaw 嵌入式运行时 | 选定的 `openai` API 密钥配置文件 |
| `openai/gpt-5.5` | 显式提供方/模型 `agentRuntime.id`                     | 选定的智能体运行时    | 选定的 OpenAI API 密钥配置文件   |
| `openai/*`       | 编写的 Completions、自定义或请求覆盖 | OpenClaw 嵌入式运行时 | 凭证类型保持不变 |
| `openai/*`       | 明文官方 HTTP 端点                  | 被拒绝                 | 凭证不会被发送 |

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

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

**最佳适用场景：**使用你的 ChatGPT/Codex 订阅，借助原生 Codex 应用服务器执行，而不是单独的 API 密钥。Codex 云端需要 ChatGPT 登录。

openclaw onboard --auth-choice openai

openclaw models auth login --provider openai

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

openclaw config set agents.defaults.model.primary openai/gpt-6-astra

openclaw models list --provider openai

### 路由概览 {#route-summary}

| 模型引用                | 运行时策略或路由事实                                 | 路由                                                    | 认证                                               |
| ------------------------ | ------------------------------------------------------------- | -------------------------------------------------------- | -------------------------------------------------- |
| `openai/gpt-6-astra`     | 未设置/`auto`，精确匹配官方 HTTPS 原生路由，无请求覆盖 | 可能选择 Codex                                    | Codex 登录，或有序的 `openai` 认证配置文件 |
| `openai/gpt-5.6-terra`   | 未设置/`auto`，精确匹配官方 HTTPS 原生路由，无请求覆盖 | 可能选择 Codex                                    | Codex 登录（目录显示 Terra 时）       |
| `openai/gpt-5.6-luna`    | 未设置/`auto`，精确匹配官方 HTTPS 原生路由，无请求覆盖 | 可能选择 Codex                                    | Codex 登录（目录显示 Luna 时）        |

| openai/gpt-6-astra | 提供方/模型 agentRuntime.id: "openclaw" | OpenClaw 内嵌运行时，内部 Codex 认证传输 | 选定的 openai OAuth 配置文件 | | openai/gpt-5.5 | 显式提供方/模型 agentRuntime.id | 选定的代理运行时 | 选定的 OpenAI 认证配置文件 | | openai/* | 自定义 Completions、自定义设置或请求覆盖 | OpenClaw 内嵌运行时 | 凭证要求仍与路由相关 | | openai/* | 明文官方 HTTP 端点 | 已拒绝 | 不发送凭证 | | 旧版 Codex GPT-5.5 引用 | 由 doctor 修复 | 重写为 openai/gpt-5.5 | 已迁移的 OpenAI OAuth 配置文件 | | codex-cli/gpt-5.5 | 由 doctor 修复 | 重写为 openai/gpt-5.5 | Codex 应用服务器认证 |

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

{
  plugins: { entries: { codex: { enabled: true } } },
  agents: {
    defaults: {
      model: { primary: "openai/gpt-6-astra" },
    },
  },
  auth: {
    order: {
      openai: [
        "openai:user@example.com",
        "openai:api-key-backup",
      ],
    },
  },
}

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

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

openclaw doctor --fix
openclaw config validate

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

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

对于直接使用 API 密钥的 GPT-5.5 和 GPT-5.6，OpenAI 文档记录了 1050000 token 提供商窗口和 128000 最大输出 token 数。预留完整的输出配额，即可得到以下两种运行时配置共用的安全输入预算：

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

922000 是推导出的运行预算，而不是提供商单独发布的输入限制。两种运行时对该预算的转换方式不同：嵌入式 OpenClaw 会发送 Responses 压缩控制，而原生 Codex 拥有其 catalog 窗口和自动压缩。参见官方 模型对比 和 GPT-5.5 模型页面。

嵌入式 OpenClaw 转换¶

此示例将确切的 Sol 模型固定到嵌入式 OpenClaw 运行时，通过共享运行时控制启用 OpenAI API Fast 模式，并要求 OpenAI Responses 在 700000 个活动 token 时进行压缩：

        {
          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 会以不透明方式持久化该项，按路由、会话和身份验证隔离复用，重放该项，修剪被替换的前缀，将其通过 worker 转录提交传递，并使其不出现在显示和诊断中。切勿打印、记录或暴露加密内容。

在 OpenClaw 2026.8.1 上，一次由进程拥有的隔离 Gateway 运行验证了确切的 openai/gpt-5.6-sol 配置。密集轮次达到了 295098、586562 和 863664 个提示 token。第三轮发出并持久化了一个一等服务器压缩项；下一个请求重放了该确切的不透明项，修剪了其前缀，并使用了 9602 个提示 token。一个确定性的长响应产生了 5480 个输出 token，持久标记在压缩和 Gateway 重启后仍然存在，重启延迟为 12081 ms，每次调用都报告 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，并带有匹配的 app-server 覆盖项 model_auto_compact_token_limit_scope=total。然后 Codex 会应用其 95% 有效窗口预留，得到 875900 个活动 token。配置一个有序的 OpenAI API 密钥配置文件，并保持默认的隔离 agent 作用域 Codex home。完整的 catalog、app-server、身份验证和重启配方位于 Codex harness 长上下文。

这些示例是两个显式运行时选择，而不是一个自动选择的配置。模型作用域的 agentRuntime 和运行时拥有的压缩设置必须一起更改。只有当它们的模型引用或 agent 配置可区分时，OpenClaw 才能同时保留这两种选择；否则，请将模型运行时及其匹配配置作为一个原子更改进行切换。然后重启 Gateway 和原生 Codex app-server，运行 /model default -s，并开始一个新聊天。现有的原生 Codex 线程会保留创建时记录的提供商和模型。

一旦 GPT-5.5 或 GPT-5.6 请求超过 272000 个输入 token，OpenAI 就会应用更高的长上下文定价：整个符合条件的请求将按 2× 输入和缓存费率以及 1.5× 输出费率计费。Fast 模式定价因模型而异；GPT-5.6 Sol API Fast 模式目前比 Standard 再高 2 倍。对于该模型，长上下文 Fast 流量的组合价格因此是短上下文 Standard 输入端定价的 4 倍，短上下文 Standard 输出定价的 3 倍。大型提示会在轮次之间重新发送或压缩，因此即使可见回复很短，选择加入的会话也可能比默认会话成本高得多。参见 Fast 模式 和 OpenAI API 定价。API 仍是账户访问、实际限制和计费的权威来源。

目录恢复¶

当上游 Codex 目录元数据中存在 gpt-5.5 时，OpenClaw 会使用它。如果实时 Codex 发现省略了 gpt-5.5 行，而账户已认证，OpenClaw 会合成该 OAuth 模型行，以便 cron、子代理以及已配置的默认模型运行不会因 Unknown model 而失败。

使用 ChatGPT 登录（Beta）¶

使用 ChatGPT 登录（SIWC）进行应用级授权，以便在符合条件的 Responses API 请求中消耗你的 Codex 额度。在 ChatGPT 设置 → 用量 中查看共享额度使用情况。OpenClaw 不显示 SIWC 配额或按应用使用情况，也不设置按应用限制；ChatGPT 可能为你的账户提供应用级控制。

你的账户和工作区必须由 OpenAI 启用 SIWC 注册和令牌共享。

SIWC 目前尚不支持 OpenAI 托管插件或已连接应用。这些需要一个具有连接器调用范围的 Codex 凭据，而设备代码登录不会授予该范围。OpenClaw 工具和本地配置的插件仍可使用其自己的凭据。请参阅 OpenAI 身份验证 以比较这些方法。

在运行 OpenClaw 的计算机上运行以下命令：

openclaw models auth login --provider openai --method siwc

在登录期间批准令牌共享以启用模型调用。如果你仅授予身份权限，OpenClaw 会保存账户，但会在推理前要求你启用共享或选择其他凭据。

浏览器会返回到 http://localhost:8080/auth/callback。如果你的浏览器运行在另一台计算机上，请在开始登录前将其 8080 端口转发到 OpenClaw 的 IPv4 回环地址。对于 SSH 主机，请在你的浏览器所在计算机上保持以下命令运行：

ssh -N -L 8080:127.0.0.1:8080 user@gateway-host

在该计算机上打开登录链接。

要重新连接现有账户，请使用相同的 ChatGPT 用户和工作区登录。若要切换其中任意一项，请在登录提示中选择 连接不同的 ChatGPT 账户或工作区。

当前限制¶

• 支持开发者函数工具和网页搜索。OpenAI 托管插件、已连接应用、托管 MCP 工具、工具搜索和托管图像生成目前尚不支持。
• 当所选 Responses 模型接受文本、图像和文件时，它们可以作为输入。这不会授予访问 Files 上传 API、音频或视频输入或转录 API 的权限。
• SIWC 凭据不会授权图像生成、音频转录、语音合成或记忆嵌入。请为这些工具配置单独的兼容凭据。当没有图像生成提供商可用时，引导流程会继续使用代理的表情符号；头像为可选项。
• Responses 请求使用 HTTP 流式传输。OpenClaw 中的 WebSocket 推理和 SIWC 配额报告不可用。
• 在使用 Codex 运行时，SIWC 需要一个受管理的本地进程和一个隔离的代理主目录。支持自动上下文摘要；使用此凭据时，手动 /compact、远程执行和受监督会话不可用。

OpenClaw 通过 GET https://api.openai.com/v1/models 从所选账户发现 SIWC 模型选项，并使用与推理相同的配置文件访问令牌。仅提供标记为可显示的模型，并按其账户特定名称和顺序提供。切换配置文件会使用该配置文件的目录。成功返回的空列表会保持为空；被拒绝的凭据不会回退到静态模型访问。如果发现暂时不可用，OpenClaw 会保留静态提示并标记发现不可用。Codex app-server 捆绑或缓存的模型列表不能证明当前 SIWC 账户访问权限。

模型和额度资格由 OpenAI 强制执行。SIWC 不会导入 ChatGPT 对话或 Codex 历史记录。