9.3 OpenAI

OpenAI GPT模型配置指南

概述

OpenClaw 支持通过两种方式使用 OpenAI 的 GPT 模型:使用 API 密钥进行直接 API 访问,或通过 ChatGPT 订阅使用 Codex OAuth 认证。

认证方式

1. API 密钥认证

适用场景: 直接 API 访问和基于使用量的计费

使用环境变量 OPENAI_API_KEY 进行认证。

2. Codex 订阅(OAuth)

适用场景: 已有 ChatGPT 订阅,希望复用订阅访问权限

通过 ChatGPT OAuth 流程进行认证,无需额外的 API 密钥。

快速开始

使用 API 密钥

# 引导式配置
openclaw onboard --auth-choice openai-api-key

# 设置环境变量
export OPENAI_API_KEY=sk-your-api-key-here

# 设置为默认模型
openclaw models set openai/gpt-5.2

使用 Codex 订阅

# 引导式配置(OAuth 流程)
openclaw onboard --auth-choice openai-codex

# 设置为默认模型
openclaw models set openai-codex/gpt-5.2

模型引用格式

OpenAI 模型使用以下格式引用:

• API 模式: openai/model-name (例如: openai/gpt-5.2)
• Codex 模式: openai-codex/model-name (例如: openai-codex/gpt-5.2)

配置示例

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

常用命令

# 列出可用的 OpenAI 模型
openclaw models list --provider openai

# 粘贴 API 令牌
openclaw models auth paste-token --provider openai

# 通过 OAuth 登录
openclaw models auth login --provider openai --set-default