OpenClaw 🦞

API 使用与成本

API 使用与成本

本文档列出了可以调用 API 密钥的功能以及它们的成本显示位置。它专注于可能产生提供商使用量或付费 API 调用的 OpenClaw 功能。

成本显示位置（聊天 + CLI）

每会话成本快照

  • /status 显示当前会话的模型、上下文使用情况和上次响应的 tokens。
  • 如果模型使用API 密钥认证，/status 还会显示上次回复的估算成本。

每条消息的成本页脚

  • /usage full 为每条回复附加一个使用量页脚，包括估算成本（仅限 API 密钥）。
  • /usage tokens 仅显示 tokens；OAuth 流程隐藏美元成本。

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

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

详见 Token 使用与成本 获取详情和示例。

密钥如何被发现

OpenClaw 可以从以下位置获取凭据：

  • 认证配置文件（每个代理，存储在 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），可能会将密钥导出到技能进程环境中。

可能花费密钥的功能

1) 核心模型响应（聊天 + 工具）

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

详见 模型 获取定价配置，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) 网络搜索工具（Brave / Perplexity 通过 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 次请求
  • 需要信用卡进行验证（除非升级否则不收费）

详见 网络工具。

5) 网络抓取工具（Firecrawl）

当存在 API 密钥时，web_fetch 可以调用Firecrawl：

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

如果未配置 Firecrawl，工具将回退到直接抓取 + 可读性处理（无付费 API）。

详见 网络工具。

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

一些状态命令调用提供商使用量端点以显示配额窗口或认证健康状态。 这些通常是低容量调用，但仍会触及提供商 API：

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

详见 模型 CLI。

7) 压缩保护摘要

压缩保护可以使用当前模型摘要会话历史，运行时调用提供商 API。

详见 会话管理 + 压缩。

8) 模型扫描/探测

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

详见 模型 CLI。

9) Talk（语音）

配置后，Talk 模式可以调用ElevenLabs：

  • ELEVENLABS_API_KEY 或 talk.apiKey

详见 Talk 模式。

10) Skills（第三方 API）

Skills 可以在 skills.entries.<name>.apiKey 中存储 apiKey。如果技能使用该密钥进行外部 API 调用，可能会根据技能的提供商产生成本。

详见 Skills。