API 用量与费用

本文档列出了 可能调用 API Key 的功能 及其费用来源，专注于 OpenClaw 中会产生提供商用量或付费 API 调用的功能。

费用在哪里显示（聊天与 CLI）

每会话费用快照

• /status 显示当前会话模型、上下文用量以及上一条回复的 token 数。
• 如果模型使用 API Key 认证，/status 还会显示上一条回复的预估费用。

每条消息费用页脚

• /usage full 在每条回复后附加用量页脚，包含预估费用（仅限 API Key 方式）。
• /usage tokens 只显示 token 数；OAuth 流程隐藏美元费用。

CLI 用量窗口（提供商配额）

• openclaw status --usage 和 openclaw channels list 显示提供商的用量窗口（配额快照，非每条消息费用）。

详情与示例参见 Token 用量与费用。

密钥的发现方式

OpenClaw 从以下位置读取凭据：

• Auth profiles（按 agent 存储，位于 auth-profiles.json）。
• 环境变量（如 OPENAI_API_KEY、BRAVE_API_KEY、FIRECRAWL_API_KEY）。
• 配置文件（models.providers.*.apiKey、tools.web.search.*、tools.web.fetch.firecrawl.*、memorySearch.*、talk.apiKey）。
• 技能（skills.entries.<name>.apiKey），可能将密钥导出到技能进程的环境变量中。

可能消耗密钥的功能

1) 核心模型响应（聊天与工具调用）

每一条回复或工具调用都会使用当前模型提供商（OpenAI、Anthropic 等），这是用量和费用的主要来源。

参见 Models（价格配置）和 Token 用量与费用（显示方式）。

2) 媒体理解（音频/图片/视频）

收到的媒体内容在回复之前会被摘要/转录，这一步使用模型/提供商 API。

• 音频：OpenAI / Groq / Deepgram（存在密钥时自动启用）。
• 图片：OpenAI / Anthropic / Google。
• 视频：Google。

参见 媒体理解。

3) 记忆嵌入与语义搜索

语义记忆搜索在配置远程提供商时会使用嵌入 API：

• memorySearch.provider = "openai" → OpenAI 嵌入
• memorySearch.provider = "gemini" → Gemini 嵌入
• memorySearch.provider = "voyage" → Voyage 嵌入
• memorySearch.provider = "mistral" → Mistral 嵌入
• memorySearch.provider = "ollama" → Ollama 嵌入（本地/自托管，通常无托管 API 计费）
• 可选：本地嵌入失败时回退到远程提供商

设置 memorySearch.provider = "local" 可保持本地模式（不消耗 API 用量）。

参见 记忆系统。

4) 网络搜索工具

web_search 使用 API Key，根据提供商不同可能产生用量费用：

• Brave Search API：BRAVE_API_KEY 或 plugins.entries.brave.config.webSearch.apiKey
• Gemini（Google 搜索）：GEMINI_API_KEY 或 plugins.entries.google.config.webSearch.apiKey
• Grok（xAI）：XAI_API_KEY 或 plugins.entries.xai.config.webSearch.apiKey
• Kimi（Moonshot）：KIMI_API_KEY、MOONSHOT_API_KEY 或 plugins.entries.moonshot.config.webSearch.apiKey
• Perplexity Search API：PERPLEXITY_API_KEY、OPENROUTER_API_KEY 或 plugins.entries.perplexity.config.webSearch.apiKey

旧版 tools.web.search.* 路径仍可通过临时兼容层加载，但不再是推荐的配置方式。

Brave Search 免费额度：每个 Brave 套餐每月赠送 $5 循环免费额度。Search 套餐每 1000 次请求收费 $5，因此每月可免费使用 1000 次请求。请在 Brave 控制台设置用量上限，避免意外超额扣费。

参见 Web 工具。

5) 网页抓取工具（Firecrawl）

web_fetch 在存在 API Key 时会调用 Firecrawl：

• FIRECRAWL_API_KEY 或 tools.web.fetch.firecrawl.apiKey

未配置 Firecrawl 时，工具会回退到直接抓取 + 可读性解析（无付费 API 调用）。

参见 Web 工具。

6) 提供商用量快照（状态/健康检查）

部分状态命令会调用提供商用量端点来显示配额窗口或认证状态。这些请求量通常较小，但仍会访问提供商 API：

• openclaw status --usage
• openclaw models status --json

参见 Models CLI。

7) 压缩安全机制摘要

压缩安全机制可能使用当前模型对会话历史进行摘要，触发时会调用提供商 API。

参见 会话管理与压缩。

8) 模型扫描/探测

openclaw models scan 可以探测 OpenRouter 模型，启用探测时会使用 OPENROUTER_API_KEY。

参见 Models CLI。

9) Talk（语音合成）

Talk 模式在配置后可调用 ElevenLabs：

• ELEVENLABS_API_KEY 或 talk.apiKey

参见 Talk 模式。

10) 技能（第三方 API）

技能可以在 skills.entries.<name>.apiKey 中存储密钥。如果某个技能使用该密钥调用外部 API，费用按该技能提供商的标准计算。

参见 技能。

让你清楚知道自己的龙虾在花谁的钱——这正是本文档的价值所在。