Huajiの小窝.

openclaw怎么调用gpt中的模型

2026/03/09
loading

这几天openclaw不知道为什么突然这么火,写一个调用模型教程,节点需要自备。

OpenClaw 官方文档写得很明确:它支持把 OpenAI 作为 provider,并且模型名要写成 provider/model 这种格式,例如 openai/gpt-5.2openai-codex/gpt-5.2

方案一:用 OpenAI API Key

适合按量计费、直接走 API。

前置要求:一个api key

先准备好你的 OpenAI API Key,然后在命令行里执行:

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

或者非交互方式:

1
openclaw onboard --openai-api-key "$OPENAI_API_KEY"

官方文档给的配置示例是:

1
2
3
4
5
6
7
8
9
10
11
12
{
"env": {
"OPENAI_API_KEY": "sk-..."
},
"agents": {
"defaults": {
"model": {
"primary": "openai/gpt-5.2"
}
}
}
}

这些写法都来自 OpenClaw 的 OpenAI provider 文档。(OpenClaw)

方案二:用 ChatGPT / Codex 登录

前置要求:一个有订阅gpt的账号,成本相对较低

命令是:

1
2
3
openclaw onboard --auth-choice openai-codex
openclaw models set openai-codex/gpt-5.2
openclaw models status

如果 onboarding 没走完整,也可以先补登录:

1
openclaw models auth login --provider openai-codex

官方示例里,对应模型配置是:

1
2
3
4
5
6
7
8
9
{
"agents": {
"defaults": {
"model": {
"primary": "openai-codex/gpt-5.2"
}
}
}
}

其中官方说明还提到:Codex 云端需要 ChatGPT 登录。(OpenClaw)

省流:

  • 想稳定直接调用 GPT 接口:选 OpenAI API Key
  • 想用 ChatGPT/Codex 订阅方式:选 openai-codex

一个常见坑

OpenClaw 的模型名不是只写 gpt-5.2,而是要写完整 provider 前缀,比如:

1
openai/gpt-5.2

或者:

1
openai-codex/gpt-5.2

这是官方特别强调的格式。

CATALOG
  1. 1. 方案一:用 OpenAI API Key
  2. 2. 方案二:用 ChatGPT / Codex 登录
  3. 3. 省流: