@gguf/claw

--- read_when: - 你想了解哪些功能可能调用付费 API - 你需要审核密钥、费用和用量可见性 - 你正在解释 /status 或 /usage 的费用报告 summary: 审核哪些功能会产生费用、使用了哪些密钥以及如何查看用量 title: API 用量与费用 x-i18n: generated_at: "2026-02-01T21:37:08Z" model: claude-opus-4-5 provider: pi source_hash: 807d0d88801e919a8246517820644db1e6271d165fa376b2e637f05a9121d8b1 source_path: reference/api-usage-costs.md workflow: 15 --- # API 用量与费用本文档列出了**可能调用 API 密钥的功能**及其费用的显示位置。重点介绍 OpenClaw 中可能产生提供商用量或付费 API 调用的功能。 ## 费用显示位置（聊天 + CLI） **每会话费用快照** - `/status` 显示当前会话模型、上下文用量和上次响应的 token 数。 - 如果模型使用 **API 密钥认证**，`/status` 还会显示上次回复的**预估费用**。 **每条消息费用页脚** - `/usage full` 在每条回复后附加用量页脚，包括**预估费用**（仅限 API 密钥）。 - `/usage tokens` 仅显示 token 数；OAuth 流程会隐藏美元费用。 **CLI 用量窗口（提供商配额）** - `openclaw status --usage` 和 `openclaw channels list` 显示提供商**用量窗口**（配额快照，非每条消息的费用）。详情和示例请参阅 [Token 用量与费用](/token-use)。 ## 密钥的发现方式 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`），可能会将密钥导出到 Skills 进程的环境变量中。 ## 可能消耗密钥的功能 ### 1）核心模型响应（聊天 + 工具）每次回复或工具调用都使用**当前模型提供商**（OpenAI、Anthropic 等）。这是用量和费用的主要来源。定价配置请参阅[模型](/providers/models)，显示方式请参阅 [Token 用量与费用](/token-use)。 ### 2）媒体理解（音频/图像/视频）入站媒体可以在回复生成前进行摘要/转录。这会使用模型/提供商 API。 - 音频：OpenAI / Groq / Deepgram（当密钥存在时**自动启用**）。 - 图像：OpenAI / Anthropic / Google。 - 视频：Google。请参阅[媒体理解](/nodes/media-understanding)。 ### 3）记忆嵌入 + 语义搜索语义记忆搜索在配置为远程提供商时使用**嵌入 API**： - `memorySearch.provider = "openai"` → OpenAI 嵌入 - `memorySearch.provider = "gemini"` → Gemini 嵌入 - 本地嵌入失败时可选回退到 OpenAI 你可以使用 `memorySearch.provider = "local"` 保持本地运行（无 API 用量）。请参阅[记忆](/concepts/memory)。 ### 4）网页搜索工具（Brave / 通过 OpenRouter 使用 Perplexity） `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 次请求** - **需要信用卡**进行验证（除非升级否则不会收费）请参阅[网页工具](/tools/web)。 ### 5）网页抓取工具（Firecrawl） `web_fetch` 在存在 API 密钥时可以调用 **Firecrawl**： - `FIRECRAWL_API_KEY` 或 `tools.web.fetch.firecrawl.apiKey` 如果未配置 Firecrawl，该工具会回退到直接抓取 + 可读性提取（无付费 API）。请参阅[网页工具](/tools/web)。 ### 6）提供商用量快照（状态/健康检查）某些状态命令会调用**提供商用量端点**以显示配额窗口或认证健康状态。这些通常是低频调用，但仍会访问提供商 API： - `openclaw status --usage` - `openclaw models status --json` 请参阅[模型 CLI](/cli/models)。 ### 7）压缩保护摘要压缩保护功能可以使用**当前模型**对会话历史进行摘要，运行时会调用提供商 API。请参阅[会话管理 + 压缩](/reference/session-management-compaction)。 ### 8）模型扫描/探测 `openclaw models scan` 可以探测 OpenRouter 模型，启用探测时会使用 `OPENROUTER_API_KEY`。请参阅[模型 CLI](/cli/models)。 ### 9）语音对话（Talk）语音对话模式在配置后可以调用 **ElevenLabs**： - `ELEVENLABS_API_KEY` 或 `talk.apiKey` 请参阅[语音对话模式](/nodes/talk)。 ### 10）Skills（第三方 API） Skills 可以在 `skills.entries.<name>.apiKey` 中存储 `apiKey`。如果 Skills 使用该密钥调用外部 API，则会根据 Skills 的提供商产生费用。请参阅[Skills](/tools/skills)。