From 28adbdece66ca2fb80558d5d81d7b9af86732ef8 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Fri, 24 Apr 2026 20:38:42 +0000 Subject: [PATCH] chore(i18n): refresh zh-CN translations --- docs/zh-CN/reference/api-usage-costs.md | 194 ++++++++++++------------ 1 file changed, 95 insertions(+), 99 deletions(-) diff --git a/docs/zh-CN/reference/api-usage-costs.md b/docs/zh-CN/reference/api-usage-costs.md index 726d5ef33..e36ab721b 100644 --- a/docs/zh-CN/reference/api-usage-costs.md +++ b/docs/zh-CN/reference/api-usage-costs.md @@ -1,134 +1,131 @@ --- read_when: - 你想了解哪些功能可能会调用付费 API - - 你需要审计密钥、费用和使用可见性 - - 你正在解释 /status 或 /usage 的费用报告 -summary: 审计哪些内容可能产生费用、使用了哪些密钥，以及如何查看使用情况 -title: API 使用情况和费用 + - 你需要审计密钥、费用和用量可见性 + - 你正在解释 `/status` 或 `/usage` 的费用报告 +summary: 审计哪些内容会产生费用、使用了哪些密钥，以及如何查看用量 +title: API 用量和费用 x-i18n: - generated_at: "2026-04-24T03:18:34Z" + generated_at: "2026-04-24T20:38:05Z" model: gpt-5.4 provider: openai - source_hash: d44b34a782a4090a074c49b91df3fa9733f13f16b3d39258b6cf57cf24043f43 + source_hash: 2958c0961b46961d942a5bb6e7954eda6bf3d0f659ae0bffb390a8502e00ff38 source_path: reference/api-usage-costs.md workflow: 15 --- -# API 使用情况与费用 +# API 用量和费用 -本文档列出**可能调用 API key 的功能**以及这些费用会显示在哪里。重点介绍 -可能产生提供商使用量或付费 API 调用的 OpenClaw 功能。 +本文档列出**可能调用 API 密钥的功能**以及这些费用会显示在哪里。它重点说明 +OpenClaw 中可能产生提供商用量或付费 API 调用的功能。 ## 费用显示位置（聊天 + CLI） -**每会话费用快照** +**按会话显示的费用快照** -- `/status` 会显示当前会话模型、上下文使用情况和上一次回复的 token。 -- 如果模型使用的是**API-key 认证**，`/status` 还会显示上一次回复的**估算费用**。 -- 如果实时会话元数据较少，`/status` 可以从最新的转录使用量 - 条目中恢复 token/cache 计数器和活动运行时模型标签。 - 现有的非零实时值仍然优先；当存储的总计缺失或更小时， - 基于 prompt 大小的转录总计也可能胜出。 +- `/status` 会显示当前会话模型、上下文使用情况以及上一次回复的 token 数。 +- 如果模型使用**API 密钥认证**，`/status` 还会显示上一条回复的**预估费用**。 +- 如果实时会话元数据较少，`/status` 可以从最新转录中的用量条目恢复 token / 缓存 + 计数器以及当前运行时模型标签。现有的非零实时数值仍然优先，且当存储的总量缺失或更小时， + 以 prompt 大小估算的转录总量可能会胜出。 -**每条消息的费用页脚** +**按消息显示的费用页脚** -- `/usage full` 会在每条回复后附加一个使用量页脚，其中包括**估算费用**（仅 API key）。 -- `/usage tokens` 仅显示 token；订阅式 OAuth/token 和 CLI 流程会隐藏美元费用。 +- `/usage full` 会在每条回复后附加一个用量页脚，其中包含**预估费用**（仅 API 密钥）。 +- `/usage tokens` 仅显示 token；订阅式 OAuth / token 和 CLI 流程会隐藏美元费用。 - Gemini CLI 说明：当 CLI 返回 JSON 输出时，OpenClaw 会从 - `stats` 中读取使用量，将 `stats.cached` 规范化为 `cacheRead`， - 并在需要时根据 `stats.input_tokens - stats.cached` 推导输入 token。 + `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` 中显示的逐消息美元估算。 +Anthropic 说明：Anthropic 员工告诉我们，OpenClaw 风格的 Claude CLI 用量 +再次被允许，因此 OpenClaw 将 Claude CLI 复用和 `claude -p` 的使用视为此集成中受支持的做法， +除非 Anthropic 发布新的政策。 +Anthropic 仍然不会提供 OpenClaw 可在 `/usage full` 中显示的按消息美元预估。 -**CLI 使用窗口（提供商配额）** +**CLI 用量窗口（提供商配额）** -- `openclaw status --usage` 和 `openclaw channels list` 会显示提供商的**使用窗口** - （配额快照，而不是逐消息费用）。 -- 面向人的输出会在各提供商之间统一为 `X% left`。 -- 当前支持使用窗口的提供商：Anthropic、GitHub Copilot、Gemini 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 会优先使用聊天模型条目， - 在需要时根据时间戳推导窗口标签，并在计划标签中包含模型名称。 -- 这些配额窗口的使用量认证会在可用时来自提供商特定 hook；否则 - OpenClaw 会回退为从认证配置文件、环境变量或配置中匹配 OAuth/API-key - 凭证。 +- MiniMax 说明：它原始的 `usage_percent` / `usagePercent` 字段表示的是剩余 + 配额，因此 OpenClaw 会在显示前将其反转。若存在基于计数的字段，则这些字段仍优先。 + 如果提供商返回 `model_remains`，OpenClaw 会优先选择聊天模型条目，在需要时根据时间戳推导窗口标签， + 并在套餐标签中包含模型名称。 +- 这些配额窗口的用量认证会在可用时来自提供商特定的钩子；否则 OpenClaw 会退回到从认证配置文件、 + 环境变量或配置中匹配 OAuth / API 密钥凭证。 -详见[Token 使用与费用](/zh-CN/reference/token-use)中的细节和示例。 +详情和示例请参见 [Token use & costs](/zh-CN/reference/token-use)。 ## 如何发现密钥 -OpenClaw 可从以下位置获取凭证： +OpenClaw 可以从以下位置获取凭证： -- **认证配置文件**（按智能体划分，存储在 `auth-profiles.json` 中）。 +- **认证配置文件**（按智能体区分，存储在 `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..apiKey`），它们可能会将密钥导出到 skill 进程环境变量中。 +- **Skills**（`skills.entries..apiKey`），它们可能会将密钥导出到 Skill 进程环境中。 -## 哪些功能可能消耗密钥 +## 可能消耗密钥的功能 -### 1）核心模型回复（聊天 + 工具） +### 1) 核心模型回复（聊天 + 工具） 每条回复或工具调用都会使用**当前模型提供商**（OpenAI、Anthropic 等）。这是 -使用量和费用的主要来源。 +用量和费用的主要来源。 -这也包括订阅式托管提供商，它们仍会在 -OpenClaw 本地 UI 之外计费，例如 **OpenAI Codex**、**Alibaba Cloud Model Studio +这也包括仍会在 OpenClaw 本地 UI 之外计费的订阅式托管提供商，例如 **OpenAI Codex**、**Alibaba Cloud Model Studio Coding Plan**、**MiniMax Coding Plan**、**Z.AI / GLM Coding Plan**，以及 -启用了 **Extra Usage** 的 Anthropic OpenClaw Claude 登录路径。 +Anthropic 的启用了 **Extra Usage** 的 OpenClaw Claude 登录路径。 -定价配置请参见 [Models](/zh-CN/providers/models)，显示方式请参见 [Token 使用与费用](/zh-CN/reference/token-use)。 +定价配置请参见 [Models](/zh-CN/providers/models)，显示方式请参见 [Token use & costs](/zh-CN/reference/token-use)。 -### 2）媒体理解（音频/图像/视频） +### 2) 媒体理解（音频 / 图像 / 视频） -在回复运行前，传入媒体可以先被总结/转录。这会使用模型/提供商 API。 +在生成回复之前，收到的媒体内容可能会先被摘要或转录。这会使用模型 / 提供商 API。 - 音频：OpenAI / Groq / Deepgram / Google / Mistral。 - 图像：OpenAI / OpenRouter / Anthropic / Google / MiniMax / Moonshot / Qwen / Z.AI。 - 视频：Google / Qwen / Moonshot。 -参见[媒体理解](/zh-CN/nodes/media-understanding)。 +请参见 [Media understanding](/zh-CN/nodes/media-understanding)。 -### 3）图像和视频生成 +### 3) 图像和视频生成 -共享生成能力也可能消耗提供商密钥： +共享生成能力也可能会消耗提供商密钥： - 图像生成：OpenAI / Google / fal / MiniMax - 视频生成：Qwen -当 `agents.defaults.imageGenerationModel` 未设置时， -图像生成可以推断一个基于认证的默认提供商。视频生成当前 -要求显式设置 `agents.defaults.videoGenerationModel`，例如 +当 +`agents.defaults.imageGenerationModel` 未设置时，图像生成可以推断一个由认证支持的默认提供商。视频生成当前仍需要显式设置 +`agents.defaults.videoGenerationModel`，例如 `qwen/wan2.6-t2v`。 -参见[图像生成](/zh-CN/tools/image-generation)、[Qwen Cloud](/zh-CN/providers/qwen) +请参见 [Image generation](/zh-CN/tools/image-generation)、[Qwen Cloud](/zh-CN/providers/qwen) 和 [Models](/zh-CN/concepts/models)。 -### 4）记忆嵌入 + 语义搜索 +### 4) Memory 嵌入 + 语义搜索 -配置为远程提供商时，语义记忆搜索会使用**嵌入 API**： +语义 Memory 搜索在配置为远程提供商时会使用**嵌入 API**： - `memorySearch.provider = "openai"` → OpenAI embeddings - `memorySearch.provider = "gemini"` → Gemini embeddings - `memorySearch.provider = "voyage"` → Voyage embeddings - `memorySearch.provider = "mistral"` → Mistral embeddings -- `memorySearch.provider = "lmstudio"` → LM Studio embeddings（本地/自托管） -- `memorySearch.provider = "ollama"` → Ollama embeddings（本地/自托管；通常不会产生托管 API 计费） +- `memorySearch.provider = "lmstudio"` → LM Studio embeddings（本地 / 自托管） +- `memorySearch.provider = "ollama"` → Ollama embeddings（本地 / 自托管；通常不会产生托管 API 计费） - 如果本地 embeddings 失败，可选择回退到远程提供商 -你可以通过设置 `memorySearch.provider = "local"` 保持完全本地（无 API 使用）。 +你可以通过设置 `memorySearch.provider = "local"` 保持本地运行（无 API 用量）。 -参见[Memory](/zh-CN/concepts/memory)。 +请参见 [Memory](/zh-CN/concepts/memory)。 -### 5）Web 搜索工具 +### 5) Web 搜索工具 -`web_search` 可能会根据你的提供商产生使用费用： +`web_search` 可能会根据你使用的提供商产生用量费用： - **Brave Search API**：`BRAVE_API_KEY` 或 `plugins.entries.brave.config.webSearch.apiKey` - **Exa**：`EXA_API_KEY` 或 `plugins.entries.exa.config.webSearch.apiKey` @@ -137,72 +134,71 @@ Coding Plan**、**MiniMax Coding Plan**、**Z.AI / GLM Coding Plan**，以及 - **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 主机以及 `ollama signin`；当主机要求时，也可复用普通 Ollama 提供商 bearer 认证 +- **Ollama Web 搜索**：默认无需密钥，但需要可访问的 Ollama 主机以及 `ollama signin`；如果主机要求认证，也可以复用普通的 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**：免密钥回退（无 API 计费，但为非官方且基于 HTML） -- **SearXNG**：`SEARXNG_BASE_URL` 或 `plugins.entries.searxng.config.webSearch.baseUrl`（免密钥/自托管；无托管 API 计费） +- **DuckDuckGo**：无密钥回退方案（无 API 计费，但为非官方且基于 HTML） +- **SearXNG**：`SEARXNG_BASE_URL` 或 `plugins.entries.searxng.config.webSearch.baseUrl`（无密钥 / 自托管；无托管 API 计费） -旧版 `tools.web.search.*` 提供商路径仍会通过临时兼容性 shim 加载，但它们已不再是推荐的配置入口。 +旧版 `tools.web.search.*` 提供商路径仍会通过临时兼容层加载，但它们已不再是推荐的配置入口。 -**Brave Search 免费额度：** 每个 Brave 套餐都包含每月 5 美元的可续期 -免费额度。Search 套餐费用为每 1,000 次请求 5 美元，因此该额度可覆盖 -每月 1,000 次免费请求。请在 Brave 控制台中设置你的使用限制， -以避免意外费用。 +**Brave Search 免费额度：** 每个 Brave 套餐都包含每月 \$5 的可续期免费额度。 +Search 套餐费用为每 1,000 次请求 \$5，因此该额度可覆盖 +每月 1,000 次请求且无需付费。请在 Brave 控制台中设置用量上限，以避免意外收费。 -参见[Web 工具](/zh-CN/tools/web)。 +请参见 [Web tools](/zh-CN/tools/web)。 -### 5）Web 抓取工具（Firecrawl） +### 5) Web 抓取工具（Firecrawl） -当存在 API key 时，`web_fetch` 可以调用 **Firecrawl**： +当存在 API 密钥时，`web_fetch` 可以调用 **Firecrawl**： - `FIRECRAWL_API_KEY` 或 `plugins.entries.firecrawl.config.webFetch.apiKey` -如果未配置 Firecrawl，该工具会回退到直接抓取 + readability（无付费 API）。 +如果未配置 Firecrawl，该工具会回退到直接抓取加内置的 `web-readability` 插件（无需付费 API）。禁用 `plugins.entries.web-readability.enabled` 可跳过本地 Readability 提取。 -参见[Web 工具](/zh-CN/tools/web)。 +请参见 [Web tools](/zh-CN/tools/web)。 -### 6）提供商使用量快照（status/health） +### 6) 提供商用量快照（状态 / 健康检查） -某些状态命令会调用**提供商使用量端点**，以显示配额窗口或认证健康状态。 -这些通常是低频调用，但仍会访问提供商 API： +某些状态命令会调用**提供商用量端点**来显示配额窗口或认证健康状态。 +这些调用通常量很低，但仍会访问提供商 API： - `openclaw status --usage` - `openclaw models status --json` -参见 [Models CLI](/zh-CN/cli/models)。 +请参见 [Models CLI](/zh-CN/cli/models)。 -### 7）压缩保护摘要 +### 7) 压缩保护摘要 -压缩保护机制可以使用**当前模型**来总结会话历史，这 -会在运行时调用提供商 API。 +压缩保护机制可以使用**当前模型**对会话历史进行摘要，这会在运行时 +调用提供商 API。 -参见[会话管理 + 压缩](/zh-CN/reference/session-management-compaction)。 +请参见 [Session management + compaction](/zh-CN/reference/session-management-compaction)。 -### 8）模型扫描 / 探测 +### 8) 模型扫描 / 探测 -`openclaw models scan` 可以探测 OpenRouter 模型，并在 -启用探测时使用 `OPENROUTER_API_KEY`。 +`openclaw models scan` 可以探测 OpenRouter 模型，并在启用 +探测时使用 `OPENROUTER_API_KEY`。 -参见 [Models CLI](/zh-CN/cli/models)。 +请参见 [Models CLI](/zh-CN/cli/models)。 -### 9）Talk（语音） +### 9) Talk（语音） -配置后，Talk 模式可以调用 **ElevenLabs**： +Talk 模式在配置后可以调用 **ElevenLabs**： - `ELEVENLABS_API_KEY` 或 `talk.providers.elevenlabs.apiKey` -参见 [Talk mode](/zh-CN/nodes/talk)。 +请参见 [Talk mode](/zh-CN/nodes/talk)。 -### 10）Skills（第三方 API） +### 10) Skills（第三方 API） -Skills 可以将 `apiKey` 存储在 `skills.entries..apiKey` 中。如果某个 skill 使用该密钥调用外部 -API，则可能根据该 skill 的提供商产生费用。 +Skills 可以将 `apiKey` 存储在 `skills.entries..apiKey` 中。如果某个 Skill 使用该密钥访问外部 +API，则它可能会按照该 Skill 提供商的规则产生费用。 -参见 [Skills](/zh-CN/tools/skills)。 +请参见 [Skills](/zh-CN/tools/skills)。 ## 相关内容 -- [Token 使用与费用](/zh-CN/reference/token-use) +- [Token use and costs](/zh-CN/reference/token-use) - [Prompt caching](/zh-CN/reference/prompt-caching) -- [使用量跟踪](/zh-CN/concepts/usage-tracking) +- [Usage tracking](/zh-CN/concepts/usage-tracking)