跳转到主要内容

​
OpenAI

OpenAI provides developer APIs for GPT models. Codex supports ChatGPT sign-in for subscription access or API key sign-in for usage-based access. Codex cloud requires ChatGPT sign-in.

​
方式 A：OpenAI API 密钥（OpenAI Platform）

Best for: direct API access and usage-based billing. **适用于：**直接 API 访问和按量计费。 从 OpenAI 控制台获取你的 API 密钥。

​
CLI 设置

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.2" } } },
}

​
方式 B：OpenAI Code（Codex）订阅

**适用于：**使用 ChatGPT/Codex 订阅访问而非 API 密钥。 Codex 云端需要 ChatGPT 登录，而 Codex CLI 支持 ChatGPT 或 API 密钥登录。 Codex cloud requires ChatGPT sign-in, while the Codex CLI supports ChatGPT or API key sign-in.

​
CLI setup (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.2" } } },
}

​
注意事项