OpenAI

OpenClaw 使用同一个 provider id，openai，同时用于直接 API-key 身份验证和 ChatGPT/Codex 订阅身份验证。openai/* 是规范的模型路由。对于运行时策略未设置或为 auto 的嵌入式 Agent 轮次，OpenAI 的路由事实决定 OpenClaw 是否可以隐式选择捆绑的 Codex app-server 运行时。仅 openai/* 前缀不会选择运行时。

Agent 模型 - 通过显式 agentRuntime 配置或 OpenAI 的隐式路由策略所选的运行时使用 openai/*。若要使用 ChatGPT/Codex 订阅，请使用 Codex 身份验证登录；若希望按密钥计费，请配置一个 API-key 身份验证配置文件。
非 Agent 的 OpenAI API - 通过 OPENAI_API_KEY 或 openai API-key 身份验证配置文件直接访问 OpenAI Platform，按使用量计费。
旧版配置 - openclaw doctor --fix 会将 codex/* 和 openai-codex/* 引用修复为 openai/*，并添加模型范围的 agentRuntime.id: "codex"。

OpenAI 明确支持在 OpenClaw 等外部工具和工作流中使用订阅 OAuth。

本页是索引。OpenAI 的文档分布在九个页面中，每个页面面向一种读者任务。请打开与你的任务匹配的页面。

页面	何时阅读
OpenAI 设置	你正在连接一个账户：API-key 和 Codex 订阅路径、路由摘要、OAuth 恢复以及长上下文选择加入。
OpenAI 身份验证	根据模型访问、插件、使用量跟踪和权限，选择 Codex 登录、API key 或 SIWC。
OpenAI 模型	你正在选择模型引用：快速选择表、GPT-6 Astra、Sol、Luna 以及 GPT-5.6 层级。
OpenAI 运行时和 Codex 身份验证	你需要了解哪个运行时执行 `openai/*` 轮次，以及原生 Codex 如何解析其账户。
OpenAI 覆盖范围和成本	你想要查看功能矩阵、记忆嵌入，或了解订阅配额和 Platform 计费如何报告。
OpenAI 图像生成	你正在通过捆绑的 `openai` 插件生成或编辑图像。
OpenAI 语音和语音识别	你正在配置文本转语音、转录或实时语音，包括按路由的身份验证顺序。
Azure OpenAI 端点	你正在将捆绑的 `openai` 提供商指向一个 Azure OpenAI 资源。
OpenAI 高级配置	你正在调整 prompt 贡献、传输、Fast 模式、压缩、严格代理模式或代理兼容性。