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 → Usage（跨会话分析）

• 显示所选日期范围内由转录派生的 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 使用与费用。

密钥是如何发现的¶

• 身份验证配置文件：SQLite 存储，代理本地配置文件会覆盖共享的直读基础配置。请参阅 Auth 凭据语义。
• 环境变量：例如 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、阿里云 Model Studio 编程计划、MiniMax 编程计划、Z.AI/GLM 编程计划，以及启用了 Extra Usage 的 Anthropic Claude 登录路径。

定价配置请参阅 Models，显示说明请参阅 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：

旧版 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，费用将遵循该技能的提供商。

参见 技能。

相关¶

• Token 使用与成本
• Prompt 缓存
• 用量跟踪