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" } } }
}
注意事项
- 模型引用始终使用 provider/model 格式(参见 /concepts/models)。
- 认证详情和重用规则请参阅 /concepts/oauth。