本页内容
本页内容
供应商
OpenAI
OpenClaw 使用一个提供商 ID openai 进行直接 API-key 身份验证和 ChatGPT/Codex 订阅身份验证。 openai/*为标准模型路线。对于未设置运行时策略或 auto 的嵌入式代理轮流,OpenAI 的路由事实决定 OpenClaw 是否可以隐式选择捆绑的 Codex 应用程序服务器运行时。 openai/* 前缀本身并不能选择运行时。
- 代理模型 -
openai/*通过显式agentRuntime配置或OpenAI的隐式路由策略选择的运行时。使用 Codex 身份验证登录以供 ChatGPT/Codex 订阅使用,或者在需要基于密钥的计费时配置 API-key 身份验证配置文件。 - 非代理 OpenAI API - 通过
OPENAI_API_KEY或openaiAPI-key 身份验证配置文件直接访问 OpenAI 平台,按使用计费。 - 旧配置 -
codex/*和openai-codex/*参考由openclaw doctor --fix修复为openai/*加上模型范围的agentRuntime.id: "codex"。
OpenAI 明确支持在 OpenClaw 等外部工具和工作流程中使用订阅 OAuth。
此页是一个索引。 OpenAI 共九页,每个读者作业一页。打开与您的任务匹配的页面。
| 页面 | 读它的时候 |
|---|---|
| OpenAI 设置 | 您正在连接帐户:API-key 和 Codex 订阅路径、路由摘要、OAuth 恢复以及长上下文选择加入。 |
| OpenAI认证 | 根据模型访问、插件、使用情况跟踪和权限选择 Codex 登录名、API 密钥或 SIWC。 |
| OpenAI模型 | 您正在选择模型参考:快速选择表、GPT-6 Astra、Sol、Luna 和 GPT-5.6 层。 |
| OpenAI 运行时和 Codex auth | 您需要知道哪个运行时运行 openai/* 轮次,以及本机 Codex 如何解析其帐户。 |
| OpenAI覆盖范围和成本 | 您需要功能矩阵、内存嵌入或如何报告订阅配额和平台计费。 |
| OpenAI图像生成 | 您正在通过捆绑的 openai 插件生成或编辑图像。 |
| OpenAI 语音和语音 | 您正在配置文本转语音、转录或实时语音,包括每个路由的身份验证顺序。 |
| Azure OpenAI 端点 | 您将捆绑的 openai 提供程序指向 Azure OpenAI 资源。 |
| OpenAI高级配置 | 您正在调整提示贡献、传输、快速模式、压缩、严格代理模式或代理兼容性。 |
各部分移动的地方
单页版本发布的每个锚点仍然在此处解析,因此现有链接(例如 /providers/openai#implicit-agent-runtime)仍然有效。每个条目都指向现在保存内容的页面。
- 入门
- 路线汇总
- 配置示例
- 路线汇总
- 配置示例
- 检查并恢复Codex OAuth路由
- 状态指示灯
- 医生警告
- 上下文窗口默认和长上下文选择加入
- 嵌入式OpenClaw翻译
- 原生 Codex 翻译
- 目录恢复
- API 密钥(OpenAI 平台)
- 获取您的 API 密钥
- 运行入门
- 验证模型是否可用
- 法典订阅
- Run Codex OAuth
- 使用标准OpenAI模型路线
- 验证 Codex 授权是否可用
- GPT-5 提示贡献
- 高级配置
- Config
- CLI
- 运输(WebSocket 与 SSE)
- 快速模式
- OpenAI API 使用 service_tier 的快速模式
- 服务器端压缩(响应API)
- 明确启用
- 自定义阈值
- 禁用
- 严格代理GPT模式
- Native 与 OpenAI- 兼容路由
相关内容
有关聊天中的托管执行、文件处理和连接工具,请参阅 Agents API 指南。
决策模型
捆绑的 openai 插件通过 OpenClaw 的 决策模型角色 支持测试版 OpenAI Decisions API。配置 OPENAI_API_KEY 或 openai API-key 身份验证配置文件,然后在决策选择器中选择 openai/gpt-6-luna 或设置:
该帐户和所选模型必须具有决策 API 访问权限。 OpenClaw 需要平台 API 密钥进行决策。它不包括 ChatGPT/Codex 订阅配置文件和在凭证解析之前使用 ChatGPT 令牌共享授予登录。请求使用配置的 OpenAI 提供程序标头和传输设置。自定义平台兼容的 baseUrl 必须实现 POST /decisions; ChatGPT 后端 URL 被拒绝。
布尔问题映射到谓词;选择保留其字符串标签;分数级别使用从零开始的评分标准位置。一个批次最多支持 200 个问题,每个选择问题最多有 255 个选项。较大的请求在凭证解析或 API 调用之前返回 unsupported-input。将独立的问题分成不同的批次,或减少替代方案。
结构化证据和标准被序列化为 JSON 文本。当前Decision V1合约带有text/JSON证据,因此该适配器不发送图像部分。每个问题的拒绝都会导致整个批次无法使用 unsupported-input;格式错误或不完整的答案将返回 invalid-response。保留概率、分数、提供商信心和 input/output 代币使用情况。
选择决策模型不会取代主要聊天模型或启用自动决策帮助。显式评估将提供的证据发送至 OpenAI 并使用平台计费。
harness和认证
配置决策模型时,OpenClaw 和 Codex 工具都会公开共享的 decision_evaluate 工具,并遵循正常的工具策略。 OpenAI 插件将其请求发送到 POST /v1/decisions。 Codex 的本机模型循环仍然使用响应。
| 主要模型harness | 主模型授权 | 决策权限和行为 |
|---|---|---|
| OpenClaw | 平台 API 密钥 | 共享工具解析兼容的 OpenAI API 密钥。 |
| OpenClaw | ChatGPT OAuth | 共享工具需要单独的 OpenAI API-key 配置文件或 OPENAI_API_KEY。 |
| Codex | 平台 API 密钥 | 该共享工具独立于 Codex 的本机凭证来解析 OpenClaw OpenAI API 密钥。 |
| Codex | ChatGPT OAuth | 本机 Codex 登录仍可用于聊天。共享工具需要 OpenClaw OpenAI API-key 配置文件或 OPENAI_API_KEY。 |
通过自动 OAuth-only 发现,评估将返回 credentials-unavailable,而无需 API 请求。显式不兼容的提供者凭证绑定仍然是终端; OpenClaw 不能替代其他帐户。通过 OpenClaw 的现有 OpenAI 身份验证设置配置决策 API 密钥,无需更改主要模型或 Codex 登录。