使用情況追蹤

​

這是什麼

• 直接從各提供者的使用量端點擷取提供者使用量/配額。不估算提供者帳單；只顯示提供者回報的方案名稱、配額視窗、餘額、花費、預算、每日成本歷史、token/模型歸因，或帳戶狀態摘要。
• 人類可讀的配額視窗輸出會正規化為 X% left，即使提供者回報的是已用配額、剩餘配額，或只有原始計數也是如此。沒有可重設配額視窗的提供者，會改為顯示提供者摘要文字（例如餘額）。
• 工作階段層級的 /status 和 session_status 工具，在即時工作階段快照缺少 token/模型資料時，會回退使用工作階段的逐字記錄日誌。該回退會補齊缺少的 token/快取計數器，可以還原使用中的執行階段模型標籤，並且在工作階段中繼資料缺失或較小時（totalTokensFresh !== true、零，或低於從逐字記錄推導出的值），偏好較大的提示導向總量。非零即時值一律優先於回退值。

​

顯示位置

• 聊天中的 /status：包含工作階段 token 和估算成本（僅限 API 金鑰模型）的狀態卡。提供者使用量會在可用時，針對目前模型提供者顯示，格式為正規化的 X% left 視窗或提供者摘要文字。
• 聊天中的 /usage off|tokens|full：每次回應的使用量頁尾。
• 聊天中的 /usage cost：從 OpenClaw 工作階段日誌彙總的本機成本摘要。
• 命令列介面：openclaw status --usage 會列印完整的逐提供者使用量/配額明細。
• 命令列介面：openclaw models status 會列出 OAuth/token 驗證設定檔，並在每個有使用量視窗的提供者旁顯示使用量視窗摘要。
• Control UI：Usage 會在 OpenClaw 從工作階段推導出的 token 和估算成本分析上方，顯示提供者方案與帳單卡。Anthropic 和 OpenAI Admin API 憑證會加入提供者回報的今日、7 日與 30 日花費、每日趨勢、token 總量、熱門模型和成本類別。
• macOS 選單列：當提供者使用量快照可用時，根層級的「Usage」區段會出現在 Context 下方。請參閱 選單列。

​

Anthropic 和 OpenAI 成本歷史

• Anthropic 訂閱/設定憑證會繼續顯示 Claude 配額視窗和選用的額外使用量預算。設定 ANTHROPIC_ADMIN_KEY 或 ANTHROPIC_ADMIN_API_KEY，即可改為顯示組織 Usage 和 Cost API 歷史。以 sk-ant-admin 開頭的 Anthropic 提供者憑證會自動偵測。
• OpenAI ChatGPT/Codex OAuth 會繼續顯示方案、配額視窗和點數餘額。設定 OPENAI_ADMIN_KEY，即可改為顯示組織成本與 completions 使用量歷史；也可選擇設定 OPENAI_PROJECT_ID，將範圍限定到單一專案。OpenClaw 絕不會將來自 OPENAI_API_KEY、提供者設定或驗證設定檔的推論憑證傳送到組織 API，因為這些金鑰可能屬於自訂端點。

​

預設使用量頁尾模式

{
  "messages": {
    "responseUsage": "tokens",
    // or: { "default": "off", "discord": "full" }
  },
}

​

三種不同的工作階段狀態

​

優先順序

​

重設與關閉

• /usage off 會強制關閉頁尾並持久儲存該選擇。已設定的非 off 預設值無法覆寫此選擇。
• /usage reset（別名：default、inherit、inherited、clear、unpin）會清除工作階段覆寫。接著工作階段會繼承有效的設定預設值（messages.responseUsage）。如果未設定預設值，頁尾會保持關閉。
• 完整工作階段重設（/reset 或 /new）或工作階段輪替會保留明確的使用量模式偏好，讓使用者的顯示選擇在工作階段輪替後仍然存在。只有 /usage reset（及其別名）會清除覆寫。

​

切換行為

​

設定

​

自訂 /usage full 頁尾

{
  "messages": {
    "usageTemplate": "~/.openclaw/usage-footer.json"
  }
}

{
  "schema": "openclaw.usageBar.v1",
  "scales": {
    "braille": "⠐⡀⡄⡆⡇⣇⣧⣷⣿",
    "block": "░▏▎▍▌▋▊▉█",
    "shade": "░▒▓█",
    "moon": "🌑🌘🌗🌖🌕",
    "level": "▁▂▃▄▅▆▇█",
    "weather": ["🥶", "☁️", "🌥", "⛅️", "🌤", "☀️"],
    "plants": ["🪾", "🍂", "🌱", "☘️", "🍀", "🌿"],
    "moons6": ["🌑", "🌚", "🌘", "🌗", "🌖", "🌝"],
  },
  "aliases": {
    "models": {
      "claude-opus-4-6": "opus46",
      "claude-opus-4-8": "opus48",
      "claude-sonnet-4-6": "sonnet46",
      "claude-haiku-4-5": "haiku45",
      "gpt-5.5": "gpt5.5",
    },
    "reasoning": {
      "off": "🌑",
      "minimal": "🌚",
      "low": "🌘",
      "medium": "🌗",
      "high": "🌕",
      "xhigh": "🌝",
    },
  },
  "output": {
    "sep": "",
    "default": [
      { "text": "{model.provider}{identity.emoji|🤖}{model.display_name|alias:models}" },
      { "map": "model.is_fallback", "cases": { "true": "🔄" } },
      { "map": "model.is_override", "cases": { "true": "📌" } },
      { "when": "model.reasoning", "text": "{model.reasoning|alias:reasoning}" },
      { "map": "state.fast_mode", "cases": { "true": "⚡️", "false": "🐌" } },
      {
        "when": "context.max_tokens",
        "text": " | 📚[{context.pct_used|meter:5:braille}]{context.max_tokens|num}",
      },
      { "when": "cost.turn_usd", "text": " 💰{cost.turn_usd|fixed:4}" },
    ],
    "surfaces": {
      "discord": [
        { "text": "-# -\n" },
        { "text": "-# {model.provider}{identity.emoji|🤖}{model.display_name|alias:models}" },
        { "map": "model.is_fallback", "cases": { "true": "🔄" } },
        { "map": "model.is_override", "cases": { "true": "📌" } },
        { "when": "model.reasoning", "text": "{model.reasoning|alias:reasoning}" },
        { "map": "state.fast_mode", "cases": { "true": "⚡️", "false": "🐌" } },
        {
          "when": "context.max_tokens",
          "text": " | 📚[{context.pct_used|meter:5:braille}]{context.max_tokens|num}",
        },
        { "when": "cost.turn_usd", "text": " 💰{cost.turn_usd|fixed:4}" },
      ],
    },
  },
}

​

形狀

{
  "schema": "openclaw.usageBar.v1",
  "scales": { "<name>": "low-to-high glyphs" }, // string (1 glyph/char) or array
  "aliases": { "<table>": { "<value>": "<label>" } },
  "output": {
    "sep": "", // joins surviving pieces
    "default": [
      /* pieces */
    ], // fallback for any surface
    "surfaces": {
      "discord": [
        /* pieces */
      ],
      "telegram": [
        /* pieces */
      ],
    },
  },
}

​

契約路徑

​

動詞

​

片段形式

• { "text": "📚 {context.max_tokens|num}" }：字面值 + 插值。
• { "when": "<path>", "text": "..." }：僅在路徑為 truthy 時轉譯。
• { "map": "<path>", "cases": { "true": "⚡", "false": "🐌" } }：值轉字形（_default case 涵蓋未匹配值）。
• { "each": "<array-path>", "item": "{label}" }：迭代陣列值路徑（目前沒有合約路徑是陣列）。

​

範例

{
  "schema": "openclaw.usageBar.v1",
  "scales": { "braille": "⠐⡀⡄⡆⡇⣇⣧⣷⣿" },
  "aliases": { "reasoning": { "medium": "🌗", "high": "🌕" } },
  "output": {
    "surfaces": {
      "discord": [
        { "text": "{model.display_name}" },
        { "when": "model.reasoning", "text": " {model.reasoning|alias:reasoning}" },
        { "map": "state.fast_mode", "cases": { "true": " ⚡", "false": " 🐌" } },
        {
          "when": "context.max_tokens",
          "text": " | 📚 [{context.pct_used|meter:5:braille}]{context.max_tokens|num}",
        },
      ],
    },
  },
}

​

供應商 + 憑證

• Anthropic (Claude)：驗證設定檔中的 OAuth token。如果 OAuth token 缺少 user:profile scope，設定時會回退到 claude.ai 網頁工作階段（CLAUDE_AI_SESSION_KEY, CLAUDE_WEB_SESSION_KEY，或 CLAUDE_WEB_COOKIE 中的 sessionKey= cookie）。 當 Anthropic 回報時，會包含模型範圍限制與已啟用的額外用量每月花費/預算。 明確的 Anthropic Admin API 金鑰，或自動偵測到的 sk-ant-admin... 供應商設定檔， 則會改為顯示 30 天組織成本與 Messages API 歷史記錄。
• ClawRouter：API 金鑰（CLAWROUTER_API_KEY）。設定時會顯示每月預算視窗 與型別化 USD 預算；否則顯示彙總花費與請求/token/成本摘要。
• DeepSeek：透過 env/config/auth store 的 API 金鑰（DEEPSEEK_API_KEY）。 顯示每個供應商回報的貨幣餘額。
• GitHub Copilot：驗證設定檔中的 OAuth token。
• Gemini 命令列介面：驗證設定檔中的 OAuth token。
• 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 host，否則使用 MiniMax CN host。 MiniMax 的原始 usage_percent / usagePercent 欄位表示剩餘 配額，因此 OpenClaw 會在顯示前將它們反轉；存在時以計數型欄位優先。
  • 視窗標籤會在存在時來自供應商的小時/分鐘欄位，然後 回退到 start_time / end_time 範圍。
  • 如果 coding-plan 端點回傳 model_remains，OpenClaw 會優先使用 chat-model 項目，在明確的 window_hours / window_minutes 欄位不存在時 從時間戳推導視窗標籤，並在方案標籤中包含模型名稱。
• OpenAI（Codex/ChatGPT 方案）：驗證設定檔中的 OAuth token（存在 account id 時會傳送 ChatGPT-Account-Id header）。顯示 ChatGPT 方案、可重設的 Codex 視窗，以及回報時的 credit 餘額。Credit 仍是供應商 credit；OpenClaw 不會將它們標示為美元。當金鑰具備 Usage Dashboard 存取權時，OPENAI_ADMIN_KEY 會加入 30 天組織成本與 completions-usage 歷史記錄。 推論憑證絕不會轉送至組織 API。
• OpenRouter：API 金鑰或 OAuth 支援的 API 金鑰（OPENROUTER_API_KEY 或驗證 設定檔）。結合 account credits 端點與 key quota 端點， 因此當憑證可存取時，會顯示帳戶餘額/花費、金鑰預算，以及每日/每週/每月用量。 任一端點都可以獨立豐富快照。
• Venice：透過 env/config/auth store 的 API 金鑰（VENICE_API_KEY）。回報時會顯示 USD 與 DIEM 餘額，以及 DIEM epoch allocation 用量。
• Xiaomi MiMo：兩個獨立的用量介面。Pay-as-you-go 使用 API 金鑰 （XIAOMI_API_KEY）；Token Plan 使用另一個金鑰（XIAOMI_TOKEN_PLAN_API_KEY）。 目前兩者都不回報配額視窗。
• z.ai：透過 env/config/auth store 的 API 金鑰（ZAI_API_KEY 或 Z_AI_API_KEY）。

​

相關

• Token 使用量與成本
• API 用量與成本
• Prompt 快取
• 選單列