本页内容

本页内容

供应商

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 或 openai API-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)仍然有效。每个条目都指向现在保存内容的页面。

OpenAI设置

OpenAI模型

OpenAI 运行时和 Codex auth

OpenAI覆盖范围和成本

OpenAI图像生成

OpenAI 语音和语音

Azure OpenAI 端点

OpenAI高级配置

相关内容

有关聊天中的托管执行、文件处理和连接工具,请参阅 Agents API 指南。

决策模型

捆绑的 openai 插件通过 OpenClaw 的 决策模型角色 支持测试版 OpenAI Decisions API。配置 OPENAI_API_KEY 或 openai API-key 身份验证配置文件,然后在决策选择器中选择 openai/gpt-6-luna 或设置:

json5
{  agents: { defaults: { decisionModel: "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 登录。

本页有帮助吗?