OpenClaw 通过 openai/* 命名空间接入 OpenAI 平台，支持 Chat、图像、视频、语音、嵌入等全系列功能。
认证方式
API Key 认证（直接调用 OpenAI Platform）：
{
env: { OPENAI_API_KEY: "sk-..." },
agents: {
defaults: { model: { primary: "openai/gpt-5.5" } }
}
}Codex 订阅认证（复用 ChatGPT/Codex 订阅，无需 API key）：
{
agents: {
defaults: { model: { primary: "openai/codex-mini" } }
}
}命名约定
OpenAI 相关有三个易混淆的名称：
| 名称 | 含义 |
|---|---|
openai | 提供商标识符，用于模型路由 |
openai-codex | 旧版认证方式（legacy auth） |
codex | Codex 插件名称 |
所有 openai/* 模型请求均通过 Codex app-server harness 路由。
功能覆盖
| 功能 | 模型示例 |
|---|---|
| Chat / Responses | gpt-5.5, gpt-4.1 |
| 图像生成 | gpt-image-1 |
| 视频生成 | sora-1.5 |
| TTS（文字转语音） | gpt-4o-mini-tts |
| STT（语音转文字） | gpt-4o-transcribe |
| Realtime Voice | OpenAI Realtime API |
| Embeddings | text-embedding-3-small |
上下文窗口
gpt-5.5原生支持 1M token 上下文- OpenClaw 默认 cap 为 272,000 tokens，防止意外超额消费
- 如需突破 cap，需显式配置
params.maxContextTokens
内存嵌入
OpenClaw 使用 text-embedding-3-small 作为默认嵌入模型，用于 Memory 向量化存储。
修复命令
遇到认证或配置问题时：
openclaw doctor --fix自动检测并修复常见的 OpenAI 提供商配置问题。
相关
- providers — 所有提供商概览与对比
- model-providers — 模型选择与故障转移机制
- notes/memory — 内存嵌入与向量化