模型提供商 • 5 分钟阅读
OpenAI
在 OpenClaw 中使用 OpenAI：支持 API Key 或 Codex 订阅鉴权
OpenAI 为 GPT 系列模型提供开发者 API。Codex 支持使用 <strong>ChatGPT 登录</strong>（订阅访问）或 <strong>API Key 登录</strong>（按量计费访问）。Codex 云端需要 ChatGPT 登录。
Tutorial.step
方案 A：OpenAI API Key（OpenAI Platform）
<strong>适用：</strong> 直接 API 访问与按量计费。
在 OpenAI 控制台获取你的 API Key。
#
Tutorial.step
CLI 设置
Bash
openclaw onboard --auth-choice openai-api-key openclaw onboard --openai-api-key "$OPENAI_API_KEY"
#
Tutorial.step
配置片段
Json5
{
env: { OPENAI_API_KEY: "sk-..." },
agents: { defaults: { model: { primary: "openai/gpt-5.2" } } },
}Tutorial.step
方案 B：OpenAI Code（Codex）订阅
<strong>适用：</strong> 使用 ChatGPT/Codex 订阅访问而不是 API Key。
Codex 云端需要 ChatGPT 登录，而 Codex CLI 支持 ChatGPT 登录或 API Key 登录。
#
Tutorial.step
CLI 设置
Bash
openclaw onboard --auth-choice openai-codex openclaw models auth login --provider openai-codex
#
Tutorial.step
配置片段
Json5
{
agents: { defaults: { model: { primary: "openai-codex/gpt-5.2" } } },
}Tutorial.step
备注
- 模型引用统一使用 '<code className="bg-white/10 px-1.5 py-0.5 rounded text-emerald-300 text-sm">'provider/model'</code>'（参见 '<a href="/concepts/models" className="text-emerald-400 hover:text-emerald-300 transition-colors">'/concepts/models'</a>'）。
- 鉴权细节与复用规则见 '<a href="/concepts/oauth" className="text-emerald-400 hover:text-emerald-300 transition-colors">'/concepts/oauth'</a>'。