Skip to main content
OpenClaw 功能中可调用付费提供商 API 的部分、各自读取凭据的位置，以及产生的成本会显示在哪里。

​
成本显示位置

/status（每个会话的快照）
  • 显示当前会话模型、上下文使用情况以及上一条回复的 token 数。
  • 当 OpenClaw 拥有使用元数据以及当前模型的本地定价时，会为上一条回复添加估算成本，包括像 Bedrock aws-sdk 模型这类明确标价的非 API key 提供方。
  • 如果实时会话快照信息较少，/status 会从最近的 transcript usage 条目中恢复 token/cache 计数器和当前模型标签。现有的非零实时值优先于 transcript 数据；当存储的总计缺失或更小时，按提示大小计算的 transcript 总计仍可能胜出。
/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。
控制界面 → 使用情况（跨会话分析）
  • 显示所选日期范围内基于 transcript 的 token 总数和估算成本总计，并按提供方、模型、agent、渠道以及 token 类型进行细分。
  • 对比以所选范围结束日期为终点的更短日历窗口。缺失日期按零使用量的日历日计算；不会被跳过以生成更密集的窗口。
  • 直接标注每日图表刻度。√ 徽标表示平方根压缩正在保持低使用量日期可见。
  • 这些总计描述的是可用的本地会话历史，不是提供方账单或终身计费台账。对于某些条目缺少定价时，界面会发出警告。
CLI 使用窗口（提供方配额，不是每条消息成本）
  • openclaw status --usage 和 openclaw channels list 将提供方的使用窗口显示为 X% left。
  • 当前支持使用窗口的提供方：Anthropic、ClawRouter、DeepSeek、GitHub Copilot、MiniMax、OpenAI（涵盖 ChatGPT/Codex OAuth/token 身份验证）、Xiaomi 和 z.ai。完整的提供方/标志列表请参见 模型 CLI 和 渠道 CLI。
  • MiniMax 的原始 usage_percent / usagePercent 字段报告的是剩余配额，因此 OpenClaw 会对其进行反转；如果存在按数量统计的字段，则优先使用这些字段。如果响应包含 model_remains 数组，OpenClaw 会选择聊天模型条目，在需要时根据时间戳推导窗口标签，并将模型名称包含在方案标签中。
  • 使用身份验证信息在可用时来自提供方专用钩子，否则 OpenClaw 会从身份验证配置文件、环境变量或配置中回退到匹配的 OAuth/API key 凭据。
参见 Token 使用与成本 获取详细示例。
Anthropic 已确认 Claude CLI 复用（包括 claude -p）是一种被认可的集成模式，除非其发布新的政策。Anthropic 不提供每条消息的美元估算，因此 /usage full 无法显示 Claude CLI 使用的成本。

​
密钥如何被发现

  • Auth profiles: 每个代理单独配置，存储在 auth-profiles.json 中。
  • Environment variables: 例如 OPENAI_API_KEY、BRAVE_API_KEY、FIRECRAWL_API_KEY。
  • Config: models.providers.*.apiKey、plugins.entries.*.config.webSearch.apiKey、plugins.entries.firecrawl.config.webFetch.apiKey、memory.search.*、talk.providers.*.apiKey。
  • Skills: skills.entries.<name>.apiKey，它可能会将密钥导出到技能进程的 env 中。

​
会花费密钥的功能

​
核心模型回复（聊天 + 工具）

每次回复或工具调用都会在当前模型提供商上运行。这是使用量和成本的主要来源，包括在 OpenClaw 本地 UI 之外计费的订阅式托管计划：OpenAI Codex、Alibaba Cloud Model Studio Coding Plan、MiniMax Coding Plan、Z.AI/GLM Coding Plan，以及启用了 Extra Usage 的 Anthropic Claude 登录路径。 参见 模型 了解价格配置，参见 令牌使用量和成本 了解展示方式。

​
媒体理解（音频/图像/视频）

传入的媒体可在回复流水线运行前，通过提供商 API 进行摘要或转写。提供商支持按插件注册，并会随着插件增加而变化；参见 媒体理解 获取当前列表和配置。

​
图像和视频生成

image_generate 和 video_generate 会路由到当前可用的任一已认证提供商。两者都可以在其 agents.defaults.mediaModels 条目未设置时，推断出基于认证的提供商默认值。 参见 图像生成 和 视频生成 获取当前提供商列表。

​
记忆嵌入和语义搜索

当 memory.search.provider 指定远程适配器时，语义记忆搜索会使用 embedding API（例如 openai、gemini、voyage、mistral、deepinfra、github-copilot、amazon-bedrock）。memory.search.provider = "lmstudio" 或 "ollama" 会在本地/自托管服务器上运行，通常没有托管计费。memory.search.provider = "local" 则完全在设备端运行，不会产生 API 使用量。可选的 memory.search.fallback 提供商可用于覆盖本地 embedding 失败的情况。 参见 记忆。

​
网页搜索工具

web_search 的使用费用取决于所选提供商。每个提供商会先从环境变量读取密钥，然后再读取 plugins.entries.<id>.config.webSearch.apiKey： 旧版 tools.web.search.* 配置路径仍会通过兼容层加载，但已不再是推荐方式。 Brave Search 免费额度：每个计划都包含每月 5 美元的可续期免费额度。Search 计划的价格为每 1,000 次请求 5 美元，因此该额度可覆盖每月 1,000 次请求且无需额外付费。请在 Brave 仪表板中设置使用上限，以避免意外收费。 参见 网页工具。

​
网页抓取工具（Firecrawl）

web_fetch 可通过 Firecrawl 使用免密钥的入门访问；如需更高限额，请添加 FIRECRAWL_API_KEY（或 plugins.entries.firecrawl.config.webFetch.apiKey）。如果未配置 Firecrawl，该工具会回退为直接抓取，并使用捆绑的 web-readability 插件（不使用付费 API）。禁用 plugins.entries.web-readability.enabled 可跳过本地 Readability 提取。 参见 网页工具。

​
提供商使用量快照（状态/运行状况）

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 可以将 apiKey 存储在 skills.entries.<name>.apiKey 中。如果某个 skill 使用该密钥访问外部 API，则费用取决于该 skill 的提供商。 参见 Skills。

​
相关内容