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 传输和服务端压缩