🦞OpenClaw ClawBook

OpenAI

OpenAI 提供 GPT 模型系列的开发者 API。OpenClaw 支持 API 密钥和 Codex 订阅两种认证方式。

方式一:API 密钥

适用于直接 API 访问和按量计费。从 OpenAI Platform 控制台获取密钥。

# 交互式设置
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-4o" }
    }
  }
}

方式二:Codex 订阅

使用 ChatGPT/Codex 订阅进行访问,无需 API 密钥。Codex 云端需要 ChatGPT 登录。

# 通过向导进行 OAuth 登录
openclaw onboard --auth-choice openai-codex

# 或直接运行 OAuth
openclaw models auth login --provider openai-codex

配置示例:

{
  agents: {
    defaults: {
      model: { primary: "openai-codex/gpt-4o" }
    }
  }
}

可用模型

模型说明
openai/gpt-4o多模态旗舰模型
openai/gpt-4o-mini轻量快速版本
openai/o3推理模型
openai/o4-mini轻量推理模型

使用 openclaw models list 查看完整可用模型列表。

注意事项

  • 模型引用格式 openai/model-name(API 密钥)或 openai-codex/model-name(订阅)
  • API 密钥和订阅可以同时配置,按 Provider 分别使用
  • 多 Key 可用逗号分隔写在 OPENAI_API_KEYS 环境变量中
  • 支持 WebSocket 传输和服务端压缩