API 用量与费用
本文档列出了可能调用 API 密钥的功能以及费用显示位置。重点介绍 OpenClaw 中可能产生 Provider 用量或付费 API 调用的功能。
费用显示位置（聊天 + CLI）
单次 Session 费用快照
/status显示当前 Session 的模型、Context 用量和最后一次响应的 Token 数。- 如果模型使用 API 密钥认证，
/status还会显示最后一次回复的预估费用。
单条消息费用页脚
/usage full会在每条回复后附加用量页脚，包括预估费用（仅限 API 密钥）。/usage tokens只显示 Token 数；OAuth 流程会隐藏费用金额。
CLI 用量窗口（Provider 配额）
openclaw status --usage和openclaw channels list显示 Provider 的用量窗口（配额快照，而非单条消息费用）。
详见 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（
skills.entries.<name>.apiKey），可能会将密钥导出到 Skill 进程环境。
可能产生费用的功能
1) 核心模型响应（聊天 + 工具）
每次回复或工具调用都会使用当前模型 Provider（OpenAI、Anthropic 等）。这是用量和费用的主要来源。
详见模型了解定价配置，Token 使用与费用了解显示方式。
2) 媒体理解（音频/图片/视频）
输入的媒体可能会在回复前被总结或转录。这会使用模型/Provider API。
- 音频：OpenAI / Groq / Deepgram（现在在密钥存在时自动启用）。
- 图片：OpenAI / Anthropic / Google。
- 视频：Google。
详见媒体理解。
3) Memory embeddings + 语义搜索
语义记忆搜索在配置为远程 Provider 时会使用 embedding API：
memorySearch.provider = "openai"→ OpenAI embeddingsmemorySearch.provider = "gemini"→ Gemini embeddings- 可选：本地 embeddings 失败时回退到 OpenAI
你可以用 memorySearch.provider = "local" 保持本地运行（不使用 API）。
详见 Memory。
4) Web 搜索工具（Brave / Perplexity via OpenRouter）
web_search 使用 API 密钥，可能产生用量费用：
- Brave Search API：
BRAVE_API_KEY或tools.web.search.apiKey - Perplexity（通过 OpenRouter）：
PERPLEXITY_API_KEY或OPENROUTER_API_KEY
Brave 免费额度（很慷慨）：
- 每月 2,000 次请求
- 每秒 1 次请求
- 需要信用卡验证（除非升级否则不收费）
详见 Web 工具。
5) Web 抓取工具（Firecrawl）
web_fetch 在存在 API 密钥时可以调用 Firecrawl：
FIRECRAWL_API_KEY或tools.web.fetch.firecrawl.apiKey
如果没有配置 Firecrawl，工具会回退到直接抓取 + readability（不使用付费 API）。
详见 Web 工具。
6) Provider 用量快照（状态/健康检查）
一些状态命令会调用 Provider 用量端点来显示配额窗口或认证健康状态。这些通常是低频调用，但仍会访问 Provider API：
openclaw status --usageopenclaw models status --json
详见 Models CLI。
7) Compaction 保护机制总结
Compaction 保护机制可以使用当前模型总结 Session 历史，运行时会调用 Provider API。
8) 模型扫描/探测
openclaw models scan 可以探测 OpenRouter 模型，启用探测时会使用 OPENROUTER_API_KEY。
详见 Models CLI。
9) Talk（语音）
Talk 模式在配置后可以调用 ElevenLabs：
ELEVENLABS_API_KEY或talk.apiKey
详见 Talk 模式。
10) Skills（第三方 API）
Skills 可以在 skills.entries.<name>.apiKey 中存储 apiKey。如果 Skill 使用该密钥调用外部 API，会根据 Skill 的 Provider 产生费用。
详见 Skills。