OpenAI
OpenClaw 对直接 API 密钥认证和 ChatGPT/Codex 订阅认证均使用同一个提供程序 ID:openai。openai/* 是标准模型路由。对于 runtime 策略未设置或为 auto 的嵌入式代理回合,OpenAI 的路由事实决定 OpenClaw 是否可隐式选择捆绑的 Codex 应用服务器运行时。openai/* 前缀本身不会选择运行时。
- 代理模型 - 通过显式
agentRuntime配置或 OpenAI 的隐式路由策略所选择的运行时来使用openai/*。使用 Codex 认证登录以用于 ChatGPT/Codex 订阅,或在需要基于密钥计费时配置 API 密钥认证配置文件。 - 非代理 OpenAI API - 通过
OPENAI_API_KEY或openaiAPI 密钥认证配置文件直接访问 OpenAI Platform,按使用量计费。 - 旧配置 -
codex/*和openai-codex/*引用会被openclaw doctor --fix修复为openai/*加上模型作用域的agentRuntime.id: "codex"。
OpenAI 明确支持在外部工具和工作流(如 OpenClaw)中使用订阅 OAuth。
本页是索引。OpenAI 的文档分布在九个页面,每页对应一类读者任务。请打开与你的任务匹配的页面。
| 页面 | 何时阅读 |
|---|---|
| OpenAI 设置 | 你在连接账户:API 密钥和 Codex 订阅路径、路由摘要、OAuth 恢复以及长上下文选择加入。 |
| OpenAI 认证 | 根据模型访问权限、插件、使用情况跟踪和权限,选择 Codex 登录、API 密钥或 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 贡献、传输、快速模式、压缩、严格 Agentic 模式或代理兼容性。 |
各章节迁移位置¶
单页版本发布的所有锚点在此仍可解析,因此像 /providers/openai#implicit-agent-runtime 这样的现有链接仍然有效。每个条目指向当前包含相应内容的页面。
- 开始使用
- 路由摘要
- 配置示例
- 路由摘要
- 配置示例
- 检查并恢复 Codex OAuth 路由
- 状态指示器
- Doctor 警告
- 上下文窗口默认值和长上下文选择加入
- 嵌入式 OpenClaw 转换
- 原生 Codex 转换
- 目录恢复
- API 密钥(OpenAI Platform)
- 获取你的 API 密钥
- 运行入门流程
- 验证模型可用
- Codex 订阅
- 运行 Codex OAuth
- 使用标准 OpenAI 模型路由
- 验证 Codex 认证可用
- GPT-5 提示词贡献
- 高级配置
- 配置
- CLI
- 传输(WebSocket 与 SSE)
- 快速模式
- OpenAI API 使用 service_tier 的快速模式
- 服务端压缩(Responses API)
- 显式启用
- 自定义阈值
- 禁用
- 严格智能体 GPT 模式
- 原生与 OpenAI 兼容路由
相关¶
对于托管执行、文件处理以及聊天中的连接工具,请参阅 Agents API 指南。
选择提供商、模型引用和故障转移行为。
共享图像工具参数和提供商选择。
共享视频工具参数和提供商选择。
身份验证详情和凭据重用规则。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw