API 使用量與費用
本文件列出可能觸發 API 金鑰的功能，以及其費用顯示的位置。重點在 OpenClaw 中可能產生供應商使用量或付費 API 呼叫的功能。
費用顯示位置（聊天 + CLI）
逐 session 費用快照
/status顯示目前 session 的模型、上下文使用量和最近回應的 token 數。- 若模型使用 API 金鑰驗證，
/status還會顯示最近回覆的預估費用。
逐訊息費用腳注
/usage full在每個回覆後附加使用量腳注，包含預估費用（僅限 API 金鑰）。/usage tokens僅顯示 token 數；OAuth 流程隱藏費用金額。
CLI 使用量窗口（供應商配額）
openclaw status --usage和openclaw channels list顯示供應商使用量窗口（配額快照，非逐訊息費用）。
詳情與範例參見 Token 使用與費用。
金鑰的發現方式
OpenClaw 可從以下來源取得憑證：
- Auth profiles（逐代理，儲存在
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.entries.<name>.apiKey），可能將金鑰匯出至技能行程環境。
可能花費金鑰的功能
1) 核心模型回應（聊天 + 工具）
每次回覆或工具呼叫使用當前的模型供應商（OpenAI、Anthropic 等）。這是使用量和費用的主要來源。
定價設定參見 模型，顯示方式參見 Token 使用與費用。
2) 媒體理解（音訊/圖片/影片）
入站媒體在回覆前可能被摘要/轉錄。這使用模型/供應商 API。
- 音訊：OpenAI / Groq / Deepgram（當金鑰存在時自動啟用）。
- 圖片：OpenAI / Anthropic / Google。
- 影片：Google。
參見 媒體理解。
3) 記憶體 embedding + 語義搜尋
語義記憶體搜尋在設定為遠端供應商時使用 embedding API：
memorySearch.provider = "openai"-> OpenAI embeddingsmemorySearch.provider = "gemini"-> Gemini embeddingsmemorySearch.provider = "voyage"-> Voyage embeddingsmemorySearch.provider = "mistral"-> Mistral embeddingsmemorySearch.provider = "ollama"-> Ollama embeddings（本地/自託管；通常無託管 API 計費）- 本地 embeddings 失敗時選用回退至遠端供應商
使用 memorySearch.provider = "local" 可保持本地（無 API 使用量）。
參見 記憶體。
4) 網頁搜尋工具
web_search 使用 API 金鑰，依供應商可能產生使用費用：
- Brave Search API：
BRAVE_API_KEY或tools.web.search.apiKey - Gemini（Google Search）：
GEMINI_API_KEY或tools.web.search.gemini.apiKey - Grok（xAI）：
XAI_API_KEY或tools.web.search.grok.apiKey - Kimi（Moonshot）：
KIMI_API_KEY、MOONSHOT_API_KEY或tools.web.search.kimi.apiKey - Perplexity Search API：
PERPLEXITY_API_KEY、OPENROUTER_API_KEY或tools.web.search.perplexity.apiKey
Brave Search 免費額度： 每個 Brave 方案包含每月 $5 的續約免費額度。Search 方案為每 1,000 次請求 $5，因此該額度可免費涵蓋每月 1,000 次請求。在 Brave 儀表板中設定使用上限以避免意外費用。
參見 網頁工具。
5) 網頁抓取工具（Firecrawl）
web_fetch 在有 API 金鑰時可呼叫 Firecrawl：
FIRECRAWL_API_KEY或tools.web.fetch.firecrawl.apiKey
若未設定 Firecrawl，工具回退至直接 fetch + readability（無付費 API）。
參見 網頁工具。
6) 供應商使用量快照（status/health）
部分狀態指令呼叫供應商使用量端點以顯示配額窗口或驗證健康。這些通常為低量呼叫但仍觸及供應商 API：
openclaw status --usageopenclaw models status --json
參見 模型 CLI。
7) 壓縮保護摘要
壓縮保護可使用當前模型摘要 session 歷史，觸發供應商 API。
參見 Session 管理 + 壓縮。
8) 模型掃描 / 探測
openclaw models scan 可探測 OpenRouter 模型，啟用探測時使用 OPENROUTER_API_KEY。
參見 模型 CLI。
9) 語音通話（speech）
語音模式設定後可觸發 ElevenLabs：
ELEVENLABS_API_KEY或talk.apiKey
參見 語音模式。
10) 技能（第三方 API）
技能可在 skills.entries.<name>.apiKey 中儲存 apiKey。若技能使用該金鑰呼叫外部 API，費用依技能的供應商而定。
參見 技能。