覆盖范围和成本
用量与成本跟踪¶
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 索引和查询嵌入:
对于需要非对称嵌入标签的 OpenAI 兼容端点,请在 memory.search 下设置
queryInputType 和 documentInputType。OpenClaw 会将这些字段作为提供商特定的
input_type 请求字段转发:查询嵌入使用 queryInputType;已索引的记忆块和批量索引
使用 documentInputType。完整示例请参阅
Memory 配置参考。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw