覆盖范围和成本

使用与成本跟踪¶

OpenClaw 将订阅配额与 Platform API 计费分开：

ChatGPT/Codex OAuth 显示订阅计划、配额窗口和额度余额。
OPENAI_ADMIN_KEY 在 Control UI 使用情况 中显示提供商报告的 30 天组织成本和 completions 使用情况，包括每日支出、请求/Token 总数、顶级模型和成本类别。
OPENAI_PROJECT_ID 可选择将 Admin API 历史记录限定到一个项目。
OpenClaw 从不向组织 API 发送 OPENAI_API_KEY 或 openai 推理配置；这些凭据可能属于自定义、Azure 或 agent 本地端点。

显式 Admin 密钥优先于 OAuth。提供商报告的历史记录不会与 OpenClaw 基于会话推导的估算成本合并；它可能包含来自其他客户端的 API 活动以及提供商侧的计费调整。

OpenAI 的 API Usage Dashboard 文档说明了使用数据所需的组织所有者和显式 Usage Dashboard 权限要求。

提供商、模型、运行时和通道是独立的层。如果这些标签被混在一起，请在更改配置前阅读 Agent 运行时。

OpenClaw 功能覆盖¶

OpenAI 能力	OpenClaw 对应项	状态
Chat / Responses	`openai/<model>` 模型提供商	是
Codex 订阅模型	`openai/<model>` 配合 OpenAI OAuth	是
旧版 Codex 模型引用	旧版 Codex 模型引用、`codex-cli/<model>`	由 doctor 修复为 `openai/<model>`
Codex app-server 框架	运行时未设置/`auto` 的 Codex 兼容 HTTPS 路由，或显式 `agentRuntime.id: codex`	是
服务端网络搜索	原生 OpenAI Responses 工具	是，当启用网络搜索且未固定其他提供商时
图像	`image_generate`	是
文本转语音	`tts.provider: "openai"` / `tts`	是
批量语音转文本	`tools.media.audio` / 媒体理解	是
流式语音转文本	Voice Call `streaming.provider: "openai"`	是
实时语音	Voice Call `realtime.provider: "openai"` / Control UI Talk `talk.realtime.provider: "openai"`	是（认证顺序取决于所选 Realtime 路由；见下文）
嵌入	记忆嵌入提供商	是

Note

已发布的 GPT-Live 浏览器和 Gateway 中继 WebRTC 会先尝试 OpenClaw ChatGPT OAuth 配置，然后回退到 Platform API 密钥认证。普通 GA 浏览器 Realtime 会先尝试 Platform 认证，并且仅在未配置 Platform 凭据来源时才回退到 OAuth。直接后端套接字以及未列出或私有的实时路由需要 Platform API 密钥认证。

Platform 认证按以下顺序解析：已配置的实时 API 密钥、openai API 密钥配置，然后是 OPENAI_API_KEY。Voice Call、Discord 实时语音、直接后端套接字、未列出或私有的实时路由，以及实时转录仍需要 Platform 认证。

如果使用 API 密钥认证时报告缺少计费，请在 platform.openai.com/account/billing 为支持你实时凭据的组织充值 Platform 额度当使用 API 密钥认证时。实时语音接受由 openclaw onboard --auth-choice openai-api-key 创建的 openai API 密钥认证配置、通过 talk.realtime.providers.openai.apiKey 为 Control UI Talk 设置的 Platform API 密钥，或 plugins.entries.voice-call.config.realtime.providers.openai.apiKey 为 Voice Call 设置的密钥，或 OPENAI_API_KEY 环境变量。

在 Control UI Video Talk 中使用 Platform 认证时，OpenAI WebRTC 会按需接收摄像头上下文：当模型调用 describe_view 时，浏览器会通过实时数据通道发送一张有界 JPEG。 OpenClaw 不会将连续摄像头轨道附加到 OpenAI 会话。

记忆嵌入¶

OpenClaw 可以使用 OpenAI 或 OpenAI 兼容的嵌入端点，用于 memory_search 索引和查询嵌入：

{
  memory: {
    search: {
      provider: "openai",
      model: "text-embedding-3-small",
    },
  },
}

对于需要非对称嵌入标签的 OpenAI 兼容端点，请在 memory.search 下设置 queryInputType 和 documentInputType。OpenClaw 会将它们作为提供商特定的 input_type 请求字段转发：查询嵌入使用 queryInputType；已索引的记忆块和批量索引使用 documentInputType。完整示例请参见记忆配置参考。

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 cl/openclaw