mirror of
https://github.com/openclaw/openclaw.git
synced 2026-03-13 19:10:39 +00:00
929a3725d3
* docs(navigation): canonicalize paths and align zh nav * chore(docs): remove stray .DS_Store * docs(scripts): add non-mint docs link audit * docs(nav): fix zh source paths and preserve legacy redirects (#11428) (thanks @sebslight) * chore(docs): satisfy lint for docs link audit script (#11428) (thanks @sebslight)
137 lines
4.9 KiB
Markdown
137 lines
4.9 KiB
Markdown
---
|
||
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 用量与费用](/reference/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 用量与费用](/reference/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)。
|