API 使用与成本
OpenClaw 中可调用付费提供商 API 的功能地图,说明每个功能从哪里读取凭据,以及相应成本在哪里显示。
成本显示位置¶
/status(每会话快照)
- 显示当前会话模型、上下文用量和上一条响应的 token。
- 当 OpenClaw 拥有活动模型的用量元数据和本地定价时,会为上一条回复添加估算成本,包括明确定价的非 API 密钥提供商,例如 Bedrock
aws-sdk模型。 - 如果实时会话快照信息较少,
/status会从最新的转录用量条目中恢复 token/缓存计数器和活动模型标签。已有的非零实时值优先于转录数据;当存储的总量缺失或更小时,按提示词大小计算的转录总量仍可能优先。
/usage(每条消息页脚)
/usage full会为每条回复附加用量页脚,包括在已配置本地定价且可用量元数据可用时的估算成本。/usage tokens仅显示 token。订阅式 OAuth/token 和 CLI 运行时仅显示 token,除非它们提供兼容的用量元数据以及明确的本地价格。/usage cost打印本地成本摘要;/usage off禁用页脚。- Gemini CLI 说明:
stream-json和旧版json输出都在stats下携带用量。OpenClaw 会将stats.cached规范化为cacheRead,并在需要时从stats.input_tokens - stats.cached推导输入 token。
控制 UI → 用量(跨会话分析)
- 显示所选日期范围内由转录推导出的 token 和估算成本总计,并按提供商、模型、代理、渠道和 token 类型细分。
- 命名会话使用其存储的代理所有者。不同代理下的相同会话 ID 仍保持独立,包括在历史谱系被分组时。
- 会话重置后,分组历史仍然可见,即使新会话还没有第一条消息。筛选和 JSON 导出会保留缺少模型价格的条目细分。
- 比较以所选范围结束日期结尾的较短日历窗口。缺失日期计为零用量日历日;不会跳过它们以创建更密集的窗口。
- 直接标注每日图表刻度。
√徽章表示平方根压缩正在使低用量日期保持可见。 - 这些总计描述的是可用的本地会话历史,而不是提供商发票或终身计费台账。当某些条目缺少定价时,UI 会发出警告。
CLI 用量窗口(提供商配额,而非每条消息成本)
openclaw status --usage和openclaw channels list以X% left显示提供商用量窗口。- 用量窗口提供商,对照 2026.9.3 检查:Anthropic、ClawRouter、DeepSeek、GitHub Copilot、MiniMax、OpenAI(涵盖 ChatGPT/Codex OAuth/token 认证)、OpenRouter、Venice、xAI、Xiaomi、Xiaomi Token Plan 和 z.ai。提供商插件提供这些快照,因此已安装的插件可以添加一个。有关完整的提供商/标志列表,请参阅 Models CLI 和 Channels CLI。
- MiniMax 的原始
usage_percent/usagePercent字段报告剩余配额,因此 OpenClaw 会反转它们;存在基于计数的字段时,这些字段优先。如果响应包含model_remains数组,OpenClaw 会选择聊天模型条目,在需要时从时间戳推导窗口标签,并将模型名称包含在计划标签中。 - 用量认证在可用时来自提供商特定钩子,否则 OpenClaw 会回退到从认证配置文件、环境变量或配置中匹配 OAuth/API 密钥凭据。
有关详细示例,请参阅 Token 使用与成本。
Note
截至 2026-07-05,Anthropic 已确认,除非其发布新政策,否则 Claude CLI 复用(包括 claude -p)是受认可的集成模式;在依赖它之前,请重新检查 Anthropic 的当前条款。Anthropic 不公开每条消息的美元估算,因此 /usage full 无法显示 Claude CLI 用量的成本。
密钥发现方式¶
- 认证配置文件:SQLite 存储,代理本地配置文件会覆盖共享读透基础。请参阅 认证凭据语义。
- 环境变量:例如
OPENAI_API_KEY、BRAVE_API_KEY、FIRECRAWL_API_KEY。 - 配置:
models.providers.*.apiKey、plugins.entries.*.config.webSearch.apiKey、plugins.entries.firecrawl.config.webFetch.apiKey、memory.search.*、talk.providers.*.apiKey。 - 技能:
skills.entries.<name>.apiKey,它可能将该密钥导出到技能进程环境变量中。
可能消耗密钥的功能¶
核心模型响应(聊天 + 工具)¶
每条回复或工具调用都在当前模型提供商上运行。这是用量和成本的主要来源,包括在 OpenClaw 本地 UI 之外计费的订阅式托管计划:OpenAI Codex、Alibaba Cloud Model Studio Coding Plan、MiniMax Coding Plan、Z.AI/GLM Coding Plan,以及启用 Extra Usage 的 Anthropic Claude 登录路径。
有关定价配置,请参阅 模型;有关显示,请参阅 Token 使用与成本。
媒体理解(音频/图像/视频)¶
传入媒体可以在回复流水线运行之前通过提供商 API 进行摘要或转录。提供商支持按插件注册,并会随着插件的添加而变化;有关当前列表和配置,请参阅 媒体理解。
图像和视频生成¶
image_generate 和 video_generate 会路由到任何可用的已认证提供商。当它们的 agents.defaults.mediaModels 条目未设置时,两者都可以推断出基于认证的提供商默认值。
记忆嵌入和语义搜索¶
当 memory.search.provider 指定远程适配器(例如 openai、gemini、voyage、mistral、deepinfra、github-copilot、amazon-bedrock)时,语义记忆搜索会使用嵌入 API。memory.search.provider = "lmstudio" 或 "ollama" 针对本地/自托管服务器运行,通常没有托管计费。memory.search.provider = "local" 将所有内容保留在设备上,不使用 API。可选的 memory.search.fallback 提供商可以覆盖本地嵌入失败。
参见 记忆.
Web 搜索工具¶
web_search 可能会根据所选提供商产生使用费用。每个提供商会先从环境变量读取密钥,然后读取 plugins.entries.<id>.config.webSearch.apiKey:
| 提供商 | 环境变量 |
|---|---|
| Brave Search | BRAVE_API_KEY |
| DuckDuckGo | 无需密钥;非官方,基于 HTML,无计费 |
| Exa | EXA_API_KEY |
| Firecrawl | FIRECRAWL_API_KEY |
| Gemini (Google Search) | GEMINI_API_KEY |
| Grok (xAI) | xAI OAuth 配置文件或 XAI_API_KEY |
| Kimi (Moonshot) | KIMI_API_KEY 或 MOONSHOT_API_KEY |
| MiniMax Search | MINIMAX_CODE_PLAN_KEY、MINIMAX_CODING_API_KEY、MINIMAX_OAUTH_TOKEN 或 MINIMAX_API_KEY |
| Ollama Web Search | 对于可访问的已登录本地主机无需密钥;直接 https://ollama.com 搜索使用 OLLAMA_API_KEY;受认证保护的主机复用普通 Ollama 提供商的 Bearer 认证 |
| Parallel | PARALLEL_API_KEY |
| Perplexity Search API | PERPLEXITY_API_KEY 或 OPENROUTER_API_KEY |
| SearXNG | SEARXNG_BASE_URL;无需密钥/自托管,无托管计费 |
| Tavily | TAVILY_API_KEY |
旧版 tools.web.search.* 配置路径仍会通过兼容性垫片加载,但不再推荐作为使用入口。
Brave Search 免费额度:每个套餐包含每月 $5 的续期免费额度。Search 套餐每 1,000 次请求收费 $5,因此该额度可无费用覆盖每月 1,000 次请求。请在 Brave 仪表板中设置用量限制,以避免意外收费。
参见 Web 工具.
Web 抓取工具(Firecrawl)¶
web_fetch 可以以无密钥入门访问调用 Firecrawl;添加 FIRECRAWL_API_KEY(或 plugins.entries.firecrawl.config.webFetch.apiKey)以获得更高限制。如果未配置 Firecrawl,该工具会回退到直接抓取以及捆绑的 web-readability 插件(无付费 API)。禁用 plugins.entries.web-readability.enabled 以跳过本地 Readability 提取。
参见 Web 工具.
提供商用量快照(状态/健康)¶
openclaw status --usage 和 openclaw models status --json 会调用提供商用量端点以显示配额窗口或认证健康状态。这些调用量较低,但仍会访问提供商 API。
参见 模型 CLI.
压缩保护摘要¶
压缩保护机制可以使用当前模型对会话历史进行摘要,运行时将调用提供商 API。
参见 会话管理与压缩.
模型扫描 / 检查¶
openclaw models scan 可以检查 OpenRouter 模型,并在启用检查时使用 OPENROUTER_API_KEY。
参见 模型 CLI.
Talk(语音)¶
Talk 模式在配置后可以调用 ElevenLabs:ELEVENLABS_API_KEY 或 talk.providers.elevenlabs.apiKey。
参见 Talk 模式.
技能(第三方 API)¶
技能可以在 skills.entries.<name>.apiKey 中存储 apiKey。如果技能使用该密钥访问外部 API,费用遵循该技能的提供商。
参见 技能.
相关¶
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw