OpenAI

OpenAI 提供 GPT 系列模型的 API 访问，也通过 Codex 支持 ChatGPT 订阅账户的 OAuth 认证。OpenAI 明确支持在外部工具/工作流（如 OpenClaw）中使用订阅 OAuth。

方案 A：OpenAI API 密钥

适合：直接 API 访问，按用量计费。

在 OpenAI 控制台 获取 API 密钥。

向导配置

openclaw onboard --auth-choice openai-api-key
# 或非交互式
openclaw onboard --openai-api-key "$OPENAI_API_KEY"

配置文件

{
  env: { OPENAI_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "openai/gpt-5.4" } } },
}

当前 OpenAI API 主要模型：gpt-5.4、gpt-5.4-pro

方案 B：Codex 订阅（ChatGPT OAuth）

适合：使用 ChatGPT/Codex 订阅而非 API 付费。

Codex cloud 需要 ChatGPT 账户登录；Codex CLI 支持 ChatGPT 或 API 密钥登录。

向导配置（Codex OAuth）

# 在向导中运行 Codex OAuth
openclaw onboard --auth-choice openai-codex

# 或直接运行 OAuth
openclaw models auth login --provider openai-codex

配置文件（Codex 订阅）

{
  agents: { defaults: { model: { primary: "openai-codex/gpt-5.4" } } },
}

注意：openai/* 和 openai-codex/* 是两个不同的 provider，分别对应 API 密钥和订阅 OAuth。

流式传输

OpenAI/Codex 默认使用 auto 传输方式（WebSocket 优先，降级到 SSE）：

{
  agents: {
    defaults: {
      models: {
        "openai/gpt-5.4": {
          params: {
            transport: "auto",  // auto | sse | websocket
          },
        },
      },
    },
  },
}

对于 openai/*（Responses API），OpenClaw 默认启用 WebSocket 预热（openaiWsWarmup: true），可降低首次响应延迟。

常用 OpenAI 模型

模型 ID	说明
openai/gpt-5.4	当前主力 API 模型
openai/gpt-5.4-pro	增强版
openai-codex/gpt-5.4	Codex 订阅路径

常见问题

401 未授权：

• API 密钥可能已过期或被吊销
• 重新在 OpenAI 控制台生成密钥并更新配置

Codex OAuth token 过期：

• 重新运行 openclaw models auth login --provider openai-codex