OpenAI

OpenAI 提供 GPT 系列模型，通用能力强，是全球使用最广泛的大模型提供商之一。OpenClaw 内置了 OpenAI Provider，配置 API Key 即可使用。

模型与价格

模型	输入/1M	输出/1M	上下文	定位
GPT-5.4	$2.50	$15.00	272K	最新旗舰
GPT-5.4（>272K）	$5.00	$15.00	1.05M	超长上下文
GPT-5.2	$1.75	$14.00	—	上一代
GPT-5	$1.25	$10.00	—	性价比之选

注意上下文价格阶梯

GPT-5.4 超过 272K 上下文后，输入价格翻倍（$2.50 → $5.00）。如果你的项目代码量较大，建议关注实际 token 消耗，避免意外高额账单。

配置步骤

1. 获取 API Key

前往 OpenAI Platform 创建 API Key。

2. 设置环境变量

export OPENAI_API_KEY=sk-xxx

或者在 ~/.openclaw/openclaw.json 中配置：

{
  "models": {
    "providers": [
      {
        "name": "openai",
        "apiKey": "sk-xxx"
      }
    ]
  }
}

3. 验证连接

openclaw models status --probe

使用建议

模型选择

• 日常编码：GPT-5 性价比最高，$1.25/1M 输入价格适合高频使用
• 复杂推理：GPT-5.4 是最新旗舰，适合架构设计、代码审查等深度任务
• 超长代码库：GPT-5.4 支持最高 1.05M 上下文，但注意价格翻倍

搭配 Fallback

推荐将 OpenAI 与低价模型组合使用：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "openai/gpt-5.4",
        "fallbacks": ["openai/gpt-5", "deepseek/deepseek-chat"]
      }
    }
  }
}

常见问题

国内访问问题

OpenAI API 在国内无法直连，你有以下选择：

• 配置网络代理
• 使用 OpenRouter 等聚合平台中转
• 使用兼容 OpenAI API 的国产模型（如 DeepSeek）作为替代

API 限流（429 错误）

OpenAI 对新账号有较严格的速率限制。建议：

• 配置 Fallback 机制，限流时自动切换备用模型
• 在 OpenAI 后台提升用量等级（Usage Tier）