API 使用和成本
API 使用与成本
Section titled “API 使用与成本”本文档列出了可以调用 API 密钥的功能及其成本显示位置。它重点介绍 可能产生提供商使用量或付费 API 调用的 OpenClaw 功能。
成本显示位置（聊天 + CLI）
Section titled “成本显示位置（聊天 + CLI）”每次会话成本快照
/status显示当前会话模型、上下文使用量和最后一次回复的 token 数。- 如果模型使用 API 密钥认证，
/status还会显示最后一次回复的 预估成本。
每条消息成本页脚
/usage full会在每次回复后附加使用情况页脚，包括 预估成本（仅限 API 密钥）。/usage tokens仅显示 token；OAuth 流程会隐藏美元成本。
CLI 使用窗口（提供商配额）
openclaw status --usage和openclaw channels list显示提供商使用量窗口（配额快照，而非单条消息的费用）。
有关详细信息和示例，请参阅 Token 使用与费用。
如何发现密钥
Section titled “如何发现密钥”OpenClaw 可以从以下位置获取凭据：
- Auth profiles（每个代理，存储在
auth-profiles.json中）。 - Environment variables（例如
OPENAI_API_KEY、BRAVE_API_KEY、FIRECRAWL_API_KEY）。 - Config（
models.providers.*.apiKey、tools.web.search.*、tools.web.fetch.firecrawl.*、memorySearch.*、talk.apiKey）。 - Skills（
skills.entries.<name>.apiKey）可能会将密钥导出到技能进程环境中。
可能消耗密钥的功能
Section titled “可能消耗密钥的功能”1) 核心模型响应（聊天 + 工具）
Section titled “1) 核心模型响应（聊天 + 工具）”每次回复或工具调用都使用当前模型提供商（OpenAI、Anthropic 等）。这是使用量和成本的主要来源。
有关价格配置，请参阅 模型；有关显示，请参阅 Token 使用与费用。
2) 媒体理解（音频/图像/视频）
Section titled “2) 媒体理解（音频/图像/视频）”传入的媒体可以在回复运行之前进行摘要/转录。这会使用模型/提供商 API。
- 音频：OpenAI / Groq / Deepgram（当密钥存在时现在会自动启用）。
- 图像：OpenAI / Anthropic / Google。
- 视频：Google。
请参阅 媒体理解。
3) 记忆嵌入 + 语义搜索
Section titled “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 工具
Section titled “4) Web search 工具”web_search 使用 API 密钥，并且根据您的提供商可能会产生使用费用：
- Brave 搜索 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 搜索 API：
PERPLEXITY_API_KEY、OPENROUTER_API_KEY或plugins.entries.perplexity.config.webSearch.apiKey
旧版 tools.web.search.* 提供商路径仍通过临时兼容性垫片加载，但它们不再是推荐的配置界面。
Brave 搜索免费额度：每个 Brave 计划均包含每月 $5 的续期免费额度。搜索计划价格为每 1,000 次请求 $5，因此该额度覆盖每月 1,000 次免费请求。在 Brave 仪表板中设置您的使用限制，以避免意外收费。
请参阅 Web 工具。
5) Web 抓取工具 (Firecrawl)
Section titled “5) Web 抓取工具 (Firecrawl)”当存在 Firecrawl 密钥时，web_fetch 可以调用 API：
FIRECRAWL_API_KEY或tools.web.fetch.firecrawl.apiKey
如果未配置 Firecrawl，该工具将回退到直接抓取 + 可读性处理（无付费 API）。
请参阅 Web 工具。
6) 提供商使用快照（状态/健康状况）
Section titled “6) 提供商使用快照（状态/健康状况）”某些状态命令会调用 提供商 usage endpoints（提供商使用端点）以显示配额窗口或身份验证健康状况。这些通常是低量调用，但仍然会访问提供商 API：
openclaw status --usageopenclaw models status --json
请参阅 模型 CLI。
7) 压缩保护摘要
Section titled “7) 压缩保护摘要”压缩保护机制可以使用 当前模型 摘要会话历史，运行时会调用提供商 API。
请参阅 会话管理 + 压缩。
8) 模型扫描 / 探测
Section titled “8) 模型扫描 / 探测”openclaw models scan 可以探测 OpenRouter 模型，并在启用探测时使用 OPENROUTER_API_KEY。
请参阅 模型 CLI。
9) 对话（语音）
Section titled “9) 对话（语音）”配置后，对话模式可以调用 ElevenLabs：
ELEVENLABS_API_KEY或talk.apiKey
请参阅 对话模式。
10) Skills（第三方 API）
Section titled “10) Skills（第三方 API）”Skills 可以在 skills.entries.<name>.apiKey 中存储 apiKey。如果技能使用该密钥调用外部 API，则可能会根据该技能的提供商产生费用。
请参阅 Skills。