Use OpenAI via API keys or Codex subscription in OpenClaw

Read when…
  • You want to use OpenAI models in OpenClaw
  • You want Codex subscription auth instead of API keys

OpenAI

OpenAI 提供用于 GPT 模型的开发者 API。Codex 支持 ChatGPT 登录 用于订阅访问,或 API 密钥 登录用于基于使用量的访问。Codex 云需要 ChatGPT 登录。

选项 A: OpenAI API 密钥 (OpenAI 平台)

最适合: 直接 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 密钥登录。

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

注意事项