API 使用量與費用

OpenClaw 中可呼叫付費供應商 API 的功能對照、各功能讀取認證資訊的位置，以及所產生費用的顯示位置。

費用顯示位置

/status（每個工作階段的快照）

• 顯示目前工作階段的模型、情境用量，以及上一則回應的權杖數。
• 當 OpenClaw 具有用量中繼資料及作用中模型的本機定價時，會加入上一則回覆的估算費用，包括具有明確定價且不使用 API 金鑰的供應商，例如 Bedrock aws-sdk 模型。
• 如果即時工作階段快照的資料不足，/status 會從最新的逐字稿用量項目復原權杖／快取計數器和作用中模型標籤。現有的非零即時值優先於逐字稿資料；當儲存的總數缺漏或較小時，與提示詞大小相當的逐字稿總數仍可優先採用。

/usage（每則訊息的頁尾）

• /usage full 會在每則回覆後附加用量頁尾；若已設定本機定價且有可用的用量中繼資料，也會包含估算費用。
• /usage tokens 僅顯示權杖數。訂閱型 OAuth／權杖及命令列介面執行階段只會顯示權杖數，除非它們提供相容的用量中繼資料及明確的本機價格。
• /usage cost 會輸出本機費用摘要；/usage off 會停用頁尾。
• Gemini 命令列介面注意事項：stream-json 和舊版 json 輸出都會在 stats 下提供用量。OpenClaw 會將 stats.cached 正規化為 cacheRead，並在需要時從 stats.input_tokens - stats.cached 推導輸入權杖數。

Control UI → Usage（跨工作階段分析）

• 顯示所選日期範圍內由逐字稿推導的權杖總數及估算費用總額，並依供應商、模型、代理程式、頻道和權杖類型細分。
• 比較以所選範圍結束日期為終點的較短日曆期間。缺少的日期會計為零用量日曆日，不會略過這些日期以建立較密集的期間。
• 直接標示每日圖表的刻度。√ 徽章表示正在使用平方根壓縮，讓低用量日期仍保持可見。
• 這些總數描述可用的本機工作階段歷程，並非供應商發票或終身計費帳本。部分項目缺少定價時，UI 會發出警告。

命令列介面用量期間（供應商配額，而非每則訊息的費用）

• openclaw status --usage 和 openclaw channels list 會將供應商的用量期間顯示為 X% left。
• 目前支援用量期間的供應商：Anthropic、ClawRouter、DeepSeek、GitHub Copilot、Gemini 命令列介面、MiniMax、OpenAI（涵蓋 ChatGPT／Codex OAuth／權杖驗證）、Xiaomi 和 z.ai。完整的供應商／旗標清單請參閱模型命令列介面和頻道命令列介面。
• MiniMax 的原始 usage_percent／usagePercent 欄位回報剩餘配額，因此 OpenClaw 會將其反轉；若存在以計數為基礎的欄位，則以其為準。如果回應包含 model_remains 陣列，OpenClaw 會選擇聊天模型項目、在必要時從時間戳記推導期間標籤，並在方案標籤中納入模型名稱。
• 若有供應商專屬鉤子，會從中取得用量驗證；否則 OpenClaw 會改為使用驗證設定檔、環境或設定中相符的 OAuth／API 金鑰認證資訊。

詳細範例請參閱權杖使用量與費用。

金鑰的探索方式

• 驗證設定檔：每個代理程式各自儲存於 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、memory.search.*、talk.providers.*.apiKey。
• Skills：skills.entries.<name>.apiKey，可將金鑰匯出至 Skill 程序的環境。

可能使用金鑰並產生費用的功能

核心模型回應（聊天與工具）

每則回覆或工具呼叫都會在目前的模型供應商上執行。這是用量和費用的主要來源，包括在 OpenClaw 本機 UI 之外計費的訂閱型託管方案：OpenAI Codex、Alibaba Cloud Model Studio Coding Plan、MiniMax Coding Plan、Z.AI／GLM Coding Plan，以及已啟用 Extra Usage 的 Anthropic Claude 登入途徑。

定價設定請參閱模型，顯示方式請參閱權杖使用量與費用。

媒體理解（音訊／圖片／影片）

在回覆管線執行前，可透過供應商 API 摘要或轉錄傳入的媒體。各外掛會分別登錄所支援的供應商，且清單會隨新增外掛而變更；目前的清單與設定請參閱媒體理解。

圖片與影片生成

image_generate 和 video_generate 會路由至任何可用且已驗證的供應商。若其 agents.defaults.mediaModels 項目尚未設定，兩者皆可推斷以驗證資訊為基礎的預設供應商。

目前的供應商清單請參閱圖片生成和影片生成。

記憶嵌入與語意搜尋

當 memory.search.provider 指定遠端配接器（例如 openai、gemini、voyage、mistral、deepinfra、github-copilot、amazon-bedrock）時，語意記憶搜尋會使用嵌入 API。memory.search.provider = "lmstudio" 或 "ollama" 會針對本機／自行託管的伺服器執行，通常不會產生託管服務費用。memory.search.provider = "local" 會將所有作業保留在裝置上，不使用 API。選用的 memory.search.fallback 供應商可在本機嵌入失敗時接手處理。

請參閱記憶。

網頁搜尋工具

web_search 可能會依所選供應商產生用量費用。每個供應商會先從環境變數讀取金鑰，再從 plugins.entries.<id>.config.webSearch.apiKey 讀取：

舊版 tools.web.search.* 設定路徑仍可透過相容性轉接層載入，但已不再是建議使用的介面。

Brave Search 免費額度：每個方案每月都包含 $5 的循環免費額度。Search 方案每 1,000 次要求收費 $5，因此該額度每月可免費涵蓋 1,000 次要求。請在 Brave 儀表板中設定用量上限，以避免非預期費用。

請參閱網頁工具。

網頁擷取工具（Firecrawl）

web_fetch 可透過免金鑰入門存取呼叫 Firecrawl；加入 FIRECRAWL_API_KEY（或 plugins.entries.firecrawl.config.webFetch.apiKey）可取得更高限額。如果未設定 Firecrawl，此工具會改用直接擷取及隨附的 web-readability 外掛（不使用付費 API）。停用 plugins.entries.web-readability.enabled 可略過本機 Readability 擷取。

請參閱網頁工具。

供應商用量快照（狀態／健康情況）

openclaw status --usage 和 openclaw models status --json 會呼叫供應商用量端點，以顯示配額期間或驗證健康情況。呼叫量很低，但仍會存取供應商 API。

請參閱模型命令列介面。

壓縮防護摘要

壓縮防護可使用目前的模型摘要工作階段歷程，執行時會呼叫供應商 API。

請參閱工作階段管理與壓縮。

模型掃描／探測

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

請參閱模型命令列介面。

對話（語音）

設定完成後，對話模式可呼叫 ElevenLabs：ELEVENLABS_API_KEY 或 talk.providers.elevenlabs.apiKey。

請參閱對話模式。

Skills（第三方 API）

Skills 可將 apiKey 儲存在 skills.entries.<name>.apiKey 中。如果 Skill 使用該金鑰存取外部 API，費用會依該 Skill 的供應商計算。

請參閱Skills。

相關內容

• 權杖使用量與費用
• 提示詞快取
• 用量追蹤