API 使用與成本

本文檔列出了可調用 API 金鑰的功能及其費用顯示位置。它專注於可能產生供應商用量或付費 API 呼叫的 OpenClaw 功能。

費用顯示位置（聊天 + CLI）

每個會話的成本快照

/status 顯示目前會話的模型、內容用量以及最後一次回應的 token 數。
如果 OpenClaw 具有使用量元數據以及目前模型的本地定價， /status 也會顯示上次回覆的 預估費用。這可以包括具有明確定價的非 API 金鑰提供商，例如 Bedrock aws-sdk 模型。
如果即時會話元數據稀少，/status 可以從最新的文字記錄使用條目中還原 token/cache 計數器和目前的運行時模型標籤。現有的非零即時值仍然優先採用，且當儲存的總數缺失或較小時，提示大小的文字記錄總數可能會勝出。

每則訊息的成本頁尾

/usage full 會在每個回覆附加使用量頁尾，包括 預估費用，當目前模型設定了本地定價且有可用的使用量元數據時。
/usage tokens 僅顯示 token；訂閱式的 OAuth/token 和 CLI 流程仍然僅顯示 token，除非該運行時提供相容的使用量元數據並設定明確的本地價格。
Gemini CLI 說明：當 CLI 返回 JSON 輸出時，OpenClaw 會從 stats 讀取使用量，將 stats.cached 正規化為 cacheRead，並在需要時從 stats.input_tokens - stats.cached 推導輸入 token。

Anthropic 說明：Anthropic 人員告訴我們，OpenClaw 風格的 Claude CLI 使用再次被允許，因此除非 Anthropic 發布新政策，否則 OpenClaw 將 Claude CLI 重用和 claude -p 使用視為此整合的核准行為。 Anthropic 仍然未公開 OpenClaw 可以在 /usage full 中顯示的每則訊息美元估計值。

CLI 用量視窗（供應商配額）

openclaw status --usage 和 openclaw channels list 顯示提供商 使用量視窗 （配額快照，而非每則訊息費用）。
Human 輸出在不同提供商間正規化為 X% left。
目前的用量視窗供應商：Anthropic、GitHub Copilot、Gemini CLI、 OpenAI Codex、MiniMax、Xiaomi 和 z.ai。
MiniMax 說明：其原始的 usage_percent / usagePercent 欄位表示剩餘配額，因此 OpenClaw 會在顯示前將其反轉。計數型欄位在存在時仍然優先採用。如果提供商返回 model_remains，OpenClaw 偏好聊天模型條目，在需要時從時間戳記推導視窗標籤，並在方案標籤中包含模型名稱。
這些配額視窗的使用權限授權來自供應商專屬的掛鉤（如有）；否則 OpenClaw 會退而求其次，從授權設定檔、環境變數或設定中匹配 OAuth/API 金鑰憑證。

詳情與範例請參閱 Token 使用量與成本。

如何探索金鑰

OpenClaw 可以從以下來源取得憑證：

Auth profiles (每個代理專屬，儲存於 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.entries.<name>.apiKey) 可能會將金鑰匯出至技能處理程序環境變數中。

會消耗金鑰的功能

1) 核心模型回應（聊天 + 工具）

每次回覆或工具呼叫都會使用 目前的模型供應商（OpenAI、Anthropic 等）。這是使用量和成本的主要來源。

這也包括訂閱式託管供應商，它們仍然在 OpenClaw 本地 UI 之外計費，例如 OpenAI Codex、阿里雲模型工作室編程方案、MiniMax 編程方案、Z.AI / GLM 編程方案，以及啟用 額外使用量 的 Anthropic OpenClaw Claude 登入路徑。

價格設定請參閱 Models，顯示方式請參閱 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 與 Models。

4) 記憶嵌入 (embeddings) + 語意搜尋

當為遠端供應商設定時，語意記憶搜尋會使用 嵌入 API：

memorySearch.provider = "openai" → OpenAI embeddings
memorySearch.provider = "gemini" → Gemini embeddings
memorySearch.provider = "voyage" → Voyage embeddings
memorySearch.provider = "mistral" → Mistral embeddings
memorySearch.provider = "deepinfra" → DeepInfra embeddings
memorySearch.provider = "lmstudio" → LM Studio embeddings (本機/自託管)
memorySearch.provider = "ollama" → Ollama embeddings (本機/自託管；通常不產生託管 API 費用)
如果本機 embeddings 失敗，可選擇回退至遠端提供者

您可以使用 memorySearch.provider = "local" 將其保留在本機 (不使用 API)。

請參閱記憶體。

5) Web search tool

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 OAuth 設定檔、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 auth
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 儀表板中設定使用量上限，以避免意外費用。

請參閱 Web 工具。

5) Web 取用工具 (Firecrawl)

當有 API 金鑰時，web_fetch 可以呼叫 Firecrawl：

FIRECRAWL_API_KEY 或 plugins.entries.firecrawl.config.webFetch.apiKey

如果未設定 Firecrawl，工具會回退為直接取得並加上內建的 web-readability 外掛程式 (無付費 API)。停用 plugins.entries.web-readability.enabled 以跳過本機 Readability 提取。

請參閱 Web 工具。

6) 提供者使用量快照 (狀態/健康狀況)

部分狀態指令會呼叫 提供者使用量端點 以顯示配額視窗或驗證健康狀況。這些通常是低量呼叫，但仍會存取提供者 API：

openclaw status --usage
openclaw models status --json

請參閱 Models CLI。

7) 壓縮防護摘要

壓縮防護功能可以使用 目前模型 摘要工作階段歷史記錄，這會在執行時呼叫提供者 API。

請參閱 Session 管理 + 壓縮。

8) 模型掃描 / 探測

openclaw models scan 可以探測 OpenRouter 模型，並在啟用探測時使用 OPENROUTER_API_KEY。