OpenAI
OpenAI 提供 GPT 模型的开发者 API。OpenClaw 支持两种常见方式:API Key(按量计费)或 Codex 订阅(ChatGPT 登录)。
方式 A:OpenAI API Key(OpenAI Platform)
适合直接使用 OpenAI 平台的 API Key。
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.1-codex" } } },
}方式 B:Codex 订阅(ChatGPT/Codex 登录)
适合使用 ChatGPT/Codex 订阅认证(而不是 API Key)。在向导中走 OAuth 最稳妥:
openclaw onboard --auth-choice openai-codex或直接登录:
openclaw models auth login --provider openai-codex最小配置示例:
{
agents: { defaults: { model: { primary: "openai-codex/gpt-5.3-codex" } } },
}备注
- 模型引用统一使用
provider/model:/docs/concepts/models/ - 认证与复用规则:/docs/concepts/oauth/
下一步
- 配置入口与速查:/docs/reference/config/
- Provider 兜底:/docs/providers/failover/