OpenClaw 接入 GPT/OpenAI 模型教程

2026-02-11 · 5 分钟模型接入

概述

OpenAI 的 GPT 系列模型是全球使用最广泛的大语言模型之一。OpenClaw 提供两种方式接入 OpenAI：标准 API Key 方式和 Codex 订阅方式，本教程将分别介绍。

方式一：API Key 接入

这是最通用的方式，适合持有 OpenAI API 账户的用户。

获取 API Key

配置步骤

使用 OpenClaw 内置的初始化命令完成配置：

openclaw onboard --provider openai --auth-choice api-key

按照提示输入你的 API Key。你也可以通过环境变量设置：

export OPENAI_API_KEY="sk-proj-xxxxxxxxxxxx"

配置文件示例

{
  providers: {
    openai: {
      type: "openai",
      apiKey: "${OPENAI_API_KEY}"
    }
  },
  agents: {
    default: {
      model: "openai/gpt-5.2"
    }
  }
}

方式二：Codex 订阅接入

如果你拥有 OpenAI Codex 订阅，可以通过 openai-codex 提供者直接使用订阅额度，无需单独的 API 费用。

openclaw onboard --provider openai-codex

系统会引导你完成 Codex 授权流程。配置文件中的提供者类型稍有不同：

{
  providers: {
    "openai-codex": {
      type: "openai-codex"
    }
  },
  agents: {
    default: {
      model: "openai-codex/gpt-5.2"
    }
  }
}

提示：Codex 方式的模型引用前缀是 openai-codex/ 而非 openai/，注意区分。

模型引用格式

OpenClaw 中 OpenAI 模型使用统一的命名格式：

openai/gpt-5.2
openai/gpt-4o
openai/o3-mini
openai/o3

Codex 方式则对应：

openai-codex/gpt-5.2
openai-codex/gpt-4o

实用配置技巧

设置温度和采样参数

{
  agents: {
    creative: {
      model: "openai/gpt-5.2",
      temperature: 0.8,
      maxTokens: 4096
    },
    coder: {
      model: "openai/gpt-5.2",
      temperature: 0.1,
      maxTokens: 8192
    }
  }
}

配合代理使用

中国大陆用户访问 OpenAI API 通常需要代理。可以在环境变量中设置：

export HTTPS_PROXY="http://127.0.0.1:7890"
export OPENAI_API_KEY="sk-proj-xxxxxxxxxxxx"

或在配置文件中指定自定义 base URL（适用于中转服务）：

{
  providers: {
    openai: {
      type: "openai",
      apiKey: "${OPENAI_API_KEY}",
      baseUrl: "https://your-proxy.example.com/v1"
    }
  }
}

验证配置

完成配置后，运行以下命令确认模型可用：

openclaw models status

检查输出中 OpenAI 相关模型是否显示 connected 状态。

你也可以快速发送一条测试消息：

openclaw chat --model openai/gpt-5.2 --message "你好，请做自我介绍"

常见问题

Q：提示 429 Rate Limit 错误？ OpenAI API 有速率限制。新账户的限额较低，可以在 OpenAI 后台申请提升额度，或在 OpenClaw 中配置请求重试间隔。

Q：API Key 方式和 Codex 订阅哪个更划算？ 如果你已有 Codex 订阅，用订阅额度更划算。如果是按需使用，API Key 按量付费更灵活。两种方式可以同时配置，通过不同的 Agent 分别调用。

Q：能否同时使用 OpenAI 和 Anthropic 模型？ 可以。OpenClaw 支持多提供者共存，只需在配置文件中分别定义即可。不同 Agent 可以指向不同的模型。