English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

技术参考

API 使用量和费用

本文档列出可能调用 API key 的功能以及其费用显示位置。它重点说明可能产生提供商用量或付费 API 调用的 OpenClaw 功能。

费用显示位置（聊天 + CLI）

每个会话的费用快照

  • /status 会显示当前会话模型、上下文用量以及上一次响应的 token。
  • 如果模型使用 API-key 认证，/status 还会显示上一次回复的预估费用。
  • 如果实时会话元数据较少，/status 可以从最新的 transcript 用量条目中恢复 token/cache 计数器以及活动运行时模型标签。现有的非零实时值仍然优先；当已存储总量缺失或更小时，prompt 大小的 transcript 总量可能胜出。

每条消息的费用页脚

  • /usage full 会在每条回复后附加用量页脚，包括预估费用（仅限 API-key）。
  • /usage tokens 仅显示 token；订阅式 OAuth/token 和 CLI 流程会隐藏美元费用。
  • Gemini CLI 注意事项：当 CLI 返回 JSON 输出时，OpenClaw 会从 stats 读取用量，将 stats.cached 标准化为 cacheRead，并在需要时根据 stats.input_tokens - stats.cached 推导输入 token。

Anthropic 注意事项：Anthropic 员工告诉我们，OpenClaw 风格的 Claude CLI 用量已再次允许，因此 OpenClaw 将 Claude CLI 复用和 claude -p 用量视为此集成中已获认可的用法，除非 Anthropic 发布新策略。Anthropic 仍未公开 OpenClaw 可在 /usage full 中显示的逐消息美元预估。

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

  • openclaw status --usage 和 openclaw channels list 会显示提供商用量窗口（配额快照，不是逐消息费用）。
  • 人类可读输出会在各提供商间统一为 X% left。
  • 当前用量窗口提供商：Anthropic、GitHub Copilot、Gemini CLI、OpenAI Codex、MiniMax、Xiaomi 和 z.ai。
  • MiniMax 注意事项：其原始 usage_percent / usagePercent 字段表示剩余配额，因此 OpenClaw 会在显示前将其反转。存在基于数量的字段时，它们仍然优先。如果提供商返回 model_remains，OpenClaw 会优先使用聊天模型条目，在需要时从时间戳推导窗口标签，并在计划标签中包含模型名称。
  • 这些配额窗口的用量认证会在可用时来自提供商特定钩子；否则 OpenClaw 会回退到从认证配置文件、环境变量或配置中匹配 OAuth/API-key 凭证。

详情和示例见 Token use & costs。

key 的发现方式

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

  • 认证配置文件（每个智能体，存储在 auth-profiles.json 中）。
  • 环境变量（例如 OPENAI_API_KEY、BRAVE_API_KEY、FIRECRAWL_API_KEY）。
  • 配置（models.providers.*.apiKey、plugins.entries.*.config.webSearch.apiKey、plugins.entries.firecrawl.config.webFetch.apiKey、memorySearch.*、talk.providers.*.apiKey）。
  • Skills（skills.entries.<name>.apiKey），可将 key 导出到 skill 进程环境中。

可能消耗 key 的功能

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

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

这也包括订阅式托管提供商，它们仍会在 OpenClaw 本地 UI 之外计费，例如 OpenAI Codex、Alibaba Cloud Model Studio Coding Plan、MiniMax Coding Plan、Z.AI / GLM Coding Plan，以及启用 Extra Usage 的 Anthropic OpenClaw Claude 登录路径。

价格配置见 Models，显示方式见 Token use & costs。

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

入站媒体可以在回复运行前被总结/转录。这会使用模型/提供商 API。

  • 音频：OpenAI / Groq / Deepgram / DeepInfra / Google / Mistral。
  • 图像：OpenAI / OpenRouter / Anthropic / DeepInfra / Google / MiniMax / Moonshot / Qwen / Z.AI。
  • 视频：Google / Qwen / Moonshot。

见 媒体理解。

3) 图像和视频生成

共享生成能力也可能消耗提供商 key：

  • 图像生成：OpenAI / Google / DeepInfra / fal / MiniMax
  • 视频生成：DeepInfra / Qwen

当 agents.defaults.imageGenerationModel 未设置时，图像生成可以推断一个由认证支持的默认提供商。视频生成目前需要显式设置 agents.defaults.videoGenerationModel，例如 qwen/wan2.6-t2v。

见 图像生成、Qwen Cloud 和 Models。

4) 记忆嵌入 + 语义搜索

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

  • memorySearch.provider = "openai" → OpenAI embeddings
  • memorySearch.provider = "gemini" → Gemini embeddings
  • memorySearch.provider = "voyage" → Voyage embeddings
  • memorySearch.provider = "mistral" → Mistral embeddings
  • memorySearch.provider = "deepinfra" → DeepInfra embeddings
  • memorySearch.provider = "lmstudio" → LM Studio embeddings（本地/自托管）
  • memorySearch.provider = "ollama" → Ollama embeddings（本地/自托管；通常没有托管 API 计费）
  • 如果本地嵌入失败，可选择回退到远程提供商

你可以使用 memorySearch.provider = "local" 让它保持本地运行（无 API 用量）。

见 Memory。

5) Web 搜索工具

web_search 可能会根据你的提供商产生用量费用：

  • Brave Search API：BRAVE_API_KEY 或 plugins.entries.brave.config.webSearch.apiKey
  • Exa：EXA_API_KEY 或 plugins.entries.exa.config.webSearch.apiKey
  • Firecrawl：FIRECRAWL_API_KEY 或 plugins.entries.firecrawl.config.webSearch.apiKey
  • Gemini (Google Search)：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
  • MiniMax Search：MINIMAX_CODE_PLAN_KEY、MINIMAX_CODING_API_KEY、MINIMAX_API_KEY 或 plugins.entries.minimax.config.webSearch.apiKey
  • Ollama Web 搜索：对于可访问且已登录的本地 Ollama 主机无需 key；直接搜索 https://ollama.com 使用 OLLAMA_API_KEY，受认证保护的主机可复用普通 Ollama 提供商 bearer 认证
  • Perplexity Search API：PERPLEXITY_API_KEY、OPENROUTER_API_KEY 或 plugins.entries.perplexity.config.webSearch.apiKey
  • Tavily：TAVILY_API_KEY 或 plugins.entries.tavily.config.webSearch.apiKey
  • DuckDuckGo：无需 key 的回退方案（无 API 计费，但非官方且基于 HTML）
  • SearXNG：SEARXNG_BASE_URL 或 plugins.entries.searxng.config.webSearch.baseUrl（无需 key/自托管；无托管 API 计费）

旧版 tools.web.search.* 提供商路径仍会通过临时兼容 shim 加载，但它们不再是推荐的配置表面。

Brave Search 免费额度： 每个 Brave 计划都包含每月续期的 $5 免费额度。Search 计划每 1,000 次请求收费 $5，因此该额度可免费覆盖每月 1,000 次请求。请在 Brave 仪表板中设置你的用量限制，以避免意外收费。

见 Web 工具。

5) Web 获取工具（Firecrawl）

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

  • FIRECRAWL_API_KEY 或 plugins.entries.firecrawl.config.webFetch.apiKey

如果未配置 Firecrawl，该工具会回退到直接获取并使用内置 web-readability 插件（无付费 API）。禁用 plugins.entries.web-readability.enabled 可跳过本地 Readability 提取。

见 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.providers.elevenlabs.apiKey

见 Talk 模式。

10) Skills（第三方 API）

Skills 可以在 skills.entries.<name>.apiKey 中存储 apiKey。如果某个 skill 使用该 key 调用外部 API，它可能会按该 skill 的提供商产生费用。

见 Skills。

相关内容