跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
API 使用量與成本

本文件列出可能呼叫 API 金鑰的功能以及其成本顯示位置。它聚焦於可能產生供應商使用量或付費 API 呼叫的 OpenClaw 功能。

​
成本顯示位置（聊天 + CLI）

每個工作階段的成本快照
  • /status 會顯示目前工作階段模型、內容使用量，以及上一則回覆的 tokens。
  • 如果模型使用 API 金鑰驗證，/status 也會顯示上一則回覆的預估成本。
  • 如果即時工作階段中繼資料不足，/status 可以從最新逐字稿使用量項目中復原 token/cache 計數器與作用中的執行階段模型標籤。現有的非零即時值仍會優先，而當已儲存總計缺失或較小時，接近 prompt 大小的逐字稿總計可能會勝出。
每則訊息成本頁尾
  • /usage full 會在每則回覆附加使用量頁尾，包含預估成本（僅限 API 金鑰）。
  • /usage tokens 只顯示 tokens；訂閱式 OAuth/token 與 CLI 流程會隱藏美元成本。
  • Gemini CLI 注意事項：當 CLI 回傳 JSON 輸出時，OpenClaw 會從 stats 讀取使用量，將 stats.cached 正規化為 cacheRead，並在需要時從 stats.input_tokens - stats.cached 推導輸入 tokens。
Anthropic 注意事項：Anthropic 工作人員告訴我們，OpenClaw 風格的 Claude CLI 使用方式已再次允許，因此除非 Anthropic 發布新政策，OpenClaw 會將 Claude CLI 重用與 claude -p 使用視為此整合核准的用法。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 會偏好聊天模型項目，必要時從時間戳記推導視窗標籤，並在方案標籤中包含模型名稱。
  • 這些配額視窗的使用量驗證會在可用時來自供應商專用 hooks；否則 OpenClaw 會退回到從驗證設定檔、環境或設定中比對 OAuth/API 金鑰憑證。
詳情與範例請參閱 Token 使用量與成本。

​
金鑰如何被探索

OpenClaw 可以從下列來源取得憑證：
  • 驗證設定檔（每個 agent，儲存在 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），可能會將金鑰匯出到 skill 程序環境。

​
可能花費金鑰的功能

​
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 登入路徑。 價格設定請參閱模型，顯示方式請參閱 Token 使用量與成本。

​
2) 媒體理解（音訊/圖片/影片）

傳入媒體可在回覆執行前先被摘要/轉錄。這會使用模型/供應商 API。
  • 音訊：OpenAI / Groq / Deepgram / DeepInfra / Google / Mistral。
  • 圖片：OpenAI / OpenRouter / Anthropic / DeepInfra / Google / MiniMax / Moonshot / Qwen / Z.AI。
  • 影片：Google / Qwen / Moonshot。
請參閱媒體理解。

​
3) 圖片與影片生成

共用生成能力也可能花費供應商金鑰：
  • 圖片生成：OpenAI / Google / DeepInfra / fal / MiniMax
  • 影片生成：DeepInfra / Qwen
當 agents.defaults.imageGenerationModel 未設定時，圖片生成可以推斷以驗證為基礎的供應商預設值。影片生成目前需要明確的 agents.defaults.videoGenerationModel，例如 qwen/wan2.6-t2v。 請參閱圖片生成、Qwen Cloud 與模型。

​
4) 記憶嵌入 + 語意搜尋

當設定為遠端供應商時，語意記憶搜尋會使用嵌入 API：
  • memorySearch.provider = "openai" → OpenAI 嵌入
  • memorySearch.provider = "gemini" → Gemini 嵌入
  • memorySearch.provider = "voyage" → Voyage 嵌入
  • memorySearch.provider = "mistral" → Mistral 嵌入
  • memorySearch.provider = "deepinfra" → DeepInfra 嵌入
  • memorySearch.provider = "lmstudio" → LM Studio 嵌入（本機/自託管）
  • memorySearch.provider = "ollama" → Ollama 嵌入（本機/自託管；通常沒有託管 API 計費）
  • 如果本機嵌入失敗，可選擇退回到遠端供應商
你可以使用 memorySearch.provider = "local" 保持本機執行（無 API 使用量）。 請參閱記憶。

​
5) 網路搜尋工具

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 Search：對可連線且已登入的本機 Ollama 主機不需金鑰；直接使用 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：免金鑰備援（無 API 計費，但非官方且以 HTML 為基礎）
  • SearXNG：SEARXNG_BASE_URL 或 plugins.entries.searxng.config.webSearch.baseUrl（免金鑰/自託管；無託管 API 計費）
舊版 tools.web.search.* 供應商路徑仍會透過暫時相容性 shim 載入，但它們不再是建議的設定介面。 Brave Search 免費額度： 每個 Brave 方案都包含每月更新的 $5 免費額度。Search 方案每 1,000 次請求費用為 $5，因此該額度可免費涵蓋每月 1,000 次請求。請在 Brave 儀表板中設定你的使用量限制，以避免意外收費。 請參閱網路工具。

​
5) 網路擷取工具（Firecrawl）

當 API 金鑰存在時，web_fetch 可以呼叫 Firecrawl：
  • FIRECRAWL_API_KEY 或 plugins.entries.firecrawl.config.webFetch.apiKey
如果未設定 Firecrawl，此工具會退回到直接擷取加上內建的 web-readability plugin（無付費 API）。停用 plugins.entries.web-readability.enabled 可略過本機 Readability 擷取。 請參閱網路工具。

​
6) 供應商使用量快照（狀態/健康狀態）

某些狀態命令會呼叫供應商使用量端點，以顯示配額視窗或驗證健康狀態。這些通常是低流量呼叫，但仍會觸及供應商 API：
  • openclaw status --usage
  • openclaw models status --json
請參閱模型 CLI。

​
7) Compaction 保護摘要

Compaction 保護可使用目前模型摘要工作階段歷史，執行時會呼叫供應商 API。 請參閱工作階段管理 + Compaction。

​
8) 模型掃描 / 探測

openclaw models scan 可以探測 OpenRouter 模型，且在啟用探測時會使用 OPENROUTER_API_KEY。 請參閱模型 CLI。

​
9) Talk（語音）

Talk 模式可在設定後呼叫 ElevenLabs：
  • ELEVENLABS_API_KEY 或 talk.providers.elevenlabs.apiKey
請參閱 Talk 模式。

​
10) Skills（第三方 API）

Skills 可以在 skills.entries.<name>.apiKey 中儲存 apiKey。如果某個 skill 使用該金鑰呼叫外部 API，可能會依該 skill 供應商產生成本。 請參閱 Skills。

​
相關