Skip to content
OpenClaw Docs

使用量追蹤

它是什麼

Section titled “它是什麼”
  • 直接從提供者的使用量端點提取提供者使用量/配額。
  • 無估算成本；僅顯示提供者回報的視窗。
  • 人類可讀的狀態輸出會標準化為 X% left，即使上游 API 回報的是已用配額、剩餘配額，或僅是原始計數。
  • 當即時會話快照稀疏時，工作階段層級的 /status 和 session_status 可以回退到最新的文字記錄使用量項目。該回退機制會填補遺失的 token/cache 計數器，可以恢復作用中的執行時期模型標籤，並且在工作階段中繼資料遺失或較少時，傾向於使用較大的提示導向總計。既有的非零即時值優先。

顯示位置

Section titled “顯示位置”
  • /status 在對話中：包含 Session 權杖與預估成本（僅限 API 金鑰）的豐富 Emoji 狀態卡片。當可用時，提供者使用量會以標準化的 X% left 視窗顯示 目前的模型提供者 使用情況。
  • 聊天中的 /usage off|tokens|full：個別回應的使用量頁尾（OAuth 僅顯示 token）。
  • 聊天中的 /usage cost：從 OpenClaw 工作階段日誌彙總的本機成本摘要。
  • CLI：openclaw status --usage 會列印完整的各提供者明細。
  • CLI：openclaw channels list 會在提供者設定旁列印相同的使用量快照（使用 --no-usage 跳過）。
  • macOS 選單列：Context 下的「Usage」區段（僅在可用時顯示）。

提供者 + 憑證

Section titled “提供者 + 憑證”
  • Anthropic (Claude)：驗證設定檔中的 OAuth 權杖。
  • GitHub Copilot：驗證設定檔中的 OAuth 權杖。
  • Gemini CLI：驗證設定檔中的 OAuth 權杖。
    • JSON 使用量會回退至 stats；stats.cached 會標準化為 cacheRead。
  • OpenAI Codex：驗證設定檔中的 OAuth 權杖（如有 accountId 則會使用）。
  • MiniMax：API 金鑰或 MiniMax OAuth 設定檔。OpenClaw 將 minimax、minimax-cn 和 minimax-portal 視為相同的 MiniMax 配額 介面，若存在則優先使用已儲存的 MiniMax OAuth，否則退回到 MINIMAX_CODE_PLAN_KEY、MINIMAX_CODING_API_KEY 或 MINIMAX_API_KEY。 使用量輪詢會從 models.providers.minimax-portal.baseUrl 或 models.providers.minimax.baseUrl 推導 Coding Plan 主機（當已設定時），否則使用 MiniMax CN 主機。 MiniMax 的原始 usage_percent / usagePercent 欄位代表 剩餘 配額，因此 OpenClaw 會在顯示前將其反轉；當存在以計數為基礎的欄位時則優先採用。
    • Coding-plan 視窗標籤優先取自提供者的小時/分鐘欄位（當存在時）， 然後退回到 start_time / end_time 期間。
    • 如果 coding-plan 端點回傳 model_remains，OpenClaw 優先採用 chat-model 項目，當缺乏明確的 window_hours / window_minutes 欄位時，會從時間戳記推導視窗標籤，並在計畫標籤中包含模型 名稱。
  • Xiaomi MiMo：透過 env/config/auth store 的 API 金鑰 (XIAOMI_API_KEY)。
  • z.ai：透過 env/config/auth store 的 API 金鑰。

當無法解析可用的提供商用量認證時，用量資訊將被隱藏。提供商 可以提供外掛特定的用量認證邏輯；否則 OpenClaw 會回退至 從認證設定檔、環境變數 或設定中匹配 OAuth/API 金鑰憑證。

相關

Section titled “相關”