Appearance
本页列出 OpenClaw 中所有可能调用 API Key 产生费用的功能，以及费用显示在哪里。对于养龙虾的成本控制来说，这份清单是必读的——每一项功能背后可能都有计费逻辑，搞清楚才能避免意外账单。
API 用量与费用
本页列出 OpenClaw 中可能调用 API Key 产生费用的功能，以及费用会显示在哪里。
费用显示在哪里
每次会话费用快照
/status显示当前会话模型、上下文用量和最后一次响应的 token 数- 使用 API Key 认证时，
/status还会显示最后一次回复的估算费用 - 如果实时元数据稀少，
/status会从最新的 transcript usage 条目中恢复 token/缓存计数器和运行时模型标签
每条消息费用页脚
/usage full：每条回复末尾追加用量摘要，包括估算费用（仅 API Key 可见）/usage tokens：只显示 token 数；订阅式 OAuth/token 认证隐藏美元费用
Anthropic 注意：根据 Anthropic 2026-04-04 公告，通过 OpenClaw 使用 Claude 登录路径属于第三方使用，需要开启 Extra Usage 按量单独计费。Anthropic 不暴露每条消息的美元估算，
/usage full无法显示具体金额。
CLI 配额快照（非每条消息费用）
openclaw status --usage和openclaw channels list显示提供商配额窗口（不是每条消息费用）- 统一显示为
X% 剩余 - 当前支持配额快照的提供商：Anthropic、GitHub Copilot、Gemini CLI、OpenAI Codex、MiniMax、小米、z.ai
- MiniMax 注意：原始字段
usage_percent/usagePercent表示剩余配额，OpenClaw 在显示前会取反。存在 count 类字段时优先使用；提供商返回model_remains时，OpenClaw 优先使用 chat-model 条目，从时间戳推导窗口标签，并在计划标签中包含模型名称
Key 的来源
OpenClaw 按以下顺序发现凭据：
- Auth profiles（按 Agent，存储在
auth-profiles.json） - 环境变量（如
OPENAI_API_KEY、BRAVE_API_KEY） - 配置项（
models.providers.*.apiKey、plugins.entries.*.config.webSearch.apiKey等） - Skills（
skills.entries.<name>.apiKey，可导出到技能进程环境变量）
哪些功能会花钱
1. 核心模型响应（聊天 + 工具调用）
每次回复或工具调用都使用当前模型提供商（OpenAI、Anthropic 等），这是费用的主要来源。
订阅式托管提供商同样会在 OpenClaw 之外计费，包括：OpenAI Codex、阿里云 Model Studio Coding Plan、MiniMax Coding Plan、Z.AI / GLM Coding Plan，以及开启了 Extra Usage 的 Anthropic OpenClaw 登录路径。
2. 媒体理解（音频/图像/视频）
入站媒体在回复前会先进行摘要/转录，使用模型/提供商 API：
- 音频：OpenAI / Groq / Deepgram / Google / Mistral
- 图像：OpenAI / OpenRouter / Anthropic / Google / MiniMax / Moonshot / Qwen / Z.AI
- 视频：Google / Qwen / Moonshot
3. 图像和视频生成
- 图像生成：OpenAI / Google / fal / MiniMax
- 视频生成：Qwen
图像生成在 agents.defaults.imageGenerationModel 未设置时会自动推断提供商。视频生成目前需要显式设置 agents.defaults.videoGenerationModel（如 qwen/wan2.6-t2v）。
4. 记忆嵌入 + 语义搜索
语义记忆搜索在配置了远程提供商时使用嵌入 API：
| 配置 | 提供商 |
|---|---|
memorySearch.provider = "openai" | OpenAI 嵌入 |
memorySearch.provider = "gemini" | Gemini 嵌入 |
memorySearch.provider = "voyage" | Voyage 嵌入 |
memorySearch.provider = "mistral" | Mistral 嵌入 |
memorySearch.provider = "ollama" | Ollama（本地，通常无托管计费） |
使用 memorySearch.provider = "local" 可完全保持本地，不产生 API 调用。
5. 网页搜索工具
web_search 根据提供商不同可能产生费用：
| 提供商 | 环境变量 |
|---|---|
| Brave Search API | BRAVE_API_KEY |
| Exa | EXA_API_KEY |
| Firecrawl | FIRECRAWL_API_KEY |
| Gemini（Google Search） | GEMINI_API_KEY |
| Grok（xAI） | XAI_API_KEY |
| Kimi（Moonshot） | KIMI_API_KEY / MOONSHOT_API_KEY |
| MiniMax Search | MINIMAX_CODE_PLAN_KEY / MINIMAX_CODING_API_KEY / MINIMAX_API_KEY |
| Ollama 网页搜索 | 默认免费；需要可访问的 Ollama 主机，通过 ollama signin 授权；主机有认证要求时可复用普通 Ollama Provider bearer auth |
| Perplexity | PERPLEXITY_API_KEY / OPENROUTER_API_KEY |
| Tavily | TAVILY_API_KEY |
| DuckDuckGo | 免费降级（非官方 HTML） |
| SearXNG | 免费/自托管（SEARXNG_BASE_URL） |
Brave 免费额度：每个 Brave 计划包含每月 $5 的自动续期免费额度，Search 计划每 1000 次请求 $5，即每月 1000 次请求免费。建议在 Brave 控制台设置使用上限，避免意外费用。
6. 网页抓取工具（Firecrawl）
web_fetch 工具在存在 API Key 时会调用 Firecrawl：
FIRECRAWL_API_KEY或plugins.entries.firecrawl.config.webFetch.apiKey- 未配置 Firecrawl 时，工具降级为直接抓取 + readability（无付费 API）
7. 提供商配额快照（status/health）
部分状态命令调用提供商用量端点显示配额窗口：
openclaw status --usageopenclaw models status --json
这些是低频调用，但仍会触达提供商 API。
8. 上下文压缩保障摘要
上下文压缩保障功能在运行时会用当前模型对会话历史进行摘要，会产生提供商 API 调用。
9. 语音合成（TTS）
配置了 ElevenLabs 时会触发：
ELEVENLABS_API_KEY或talk.providers.elevenlabs.apiKey
10. Skills（第三方 API）
Skills 可在 skills.entries.<name>.apiKey 中存储 Key。如果技能使用该 Key 调用外部 API，会按该技能的提供商规则计费。
常见问题
Q: 怎么查看某次会话花了多少钱？
A: 使用 API Key 认证时，/status 显示最后一次回复的估算费用，/usage full 为每条回复追加费用页脚。订阅式 OAuth 认证（如 Claude 登录、Codex 订阅）无法显示美元金额，只能看 token 数。
Q: Brave Search 的免费额度够用吗？
A: 每月 1000 次请求免费，日均约 33 次，对于个人使用通常够用。如果超量，建议在 Brave 控制台设置用量上限，或降级到 DuckDuckGo（完全免费但质量稍低）。
Q: 我启用了语义记忆搜索，每次对话都会调用嵌入 API 吗？
A: 只有在实际执行记忆写入或检索时才会调用嵌入 API，不是每次对话都调用。使用 memorySearch.provider = "local" 可以完全避免远程 API 调用，代价是嵌入质量可能略低。