跳转至

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