OpenAI

OpenAI 为 GPT 模型提供开发者 API。Codex 支持 ChatGPT 登录（订阅访问）或 API key 登录（按用量计费）。Codex 云端需要 ChatGPT 登录。

方式 A：OpenAI API key（OpenAI Platform）

适合场景： 直接 API 访问和按用量计费。 从 OpenAI 控制台获取你的 API key。

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 key。 Codex 云端需要 ChatGPT 登录，而 Codex CLI 支持 ChatGPT 或 API key 登录。

CLI 设置

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

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

配置示例

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

注意事项