跳转至

覆盖范围和成本

用量与成本跟踪

OpenClaw 区分订阅配额与 Platform API 计费:

  • ChatGPT/Codex OAuth 显示订阅方案、配额窗口和积分余额。
  • OPENAI_ADMIN_KEY 在 Control UI 的 Usage(用量)中显示提供商报告的 30 天组织成本和补全用量,包括每日支出、请求/Token 总数、热门模型和成本类别。
  • OPENAI_PROJECT_ID 可选地将 Admin API 历史记录限定到单个项目。
  • OpenClaw 绝不会将 OPENAI_API_KEY 或 openai 推理配置文件发送到组织 API;这些凭据可能属于自定义、Azure 或智能体本地端点。

显式设置的 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 适配器 兼容 Codex 的 HTTPS 路由,runtime 未设置/auto,或显式设置 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。直接后端套接字以及未列出或私有的 realtime 路由需要 Platform API 密钥认证。

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

如果 API 密钥认证提示缺少计费信息,在使用 API 密钥认证时,请前往 platform.openai.com/account/billing 为你的 realtime 凭据所属的组织充值 Platform 积分。Realtime 语音接受由 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 设置的 Platform API 密钥,或 OPENAI_API_KEY 环境变量。

在 Control UI Video Talk 使用 Platform 认证时,OpenAI WebRTC 会按需接收摄像头上下文: 当模型调用 describe_view 时,浏览器会通过 realtime 数据通道发送一张大小受限的 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。完整示例请参阅 Memory 配置参考。

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