उपयोग ट्रैकिंग

​

यह क्या है

• प्रत्येक प्रदाता के उपयोग एंडपॉइंट से सीधे प्रदाता उपयोग/कोटा प्राप्त करता है। प्रदाता बिलिंग का कोई अनुमान नहीं; केवल प्रदाता द्वारा रिपोर्ट किए गए प्लान के नाम, कोटा विंडो, शेष राशियाँ, व्यय, बजट, दैनिक लागत इतिहास, टोकन/मॉडल श्रेय या खाता-स्थिति सारांश।
• मानव-पठनीय कोटा-विंडो आउटपुट को X% left में सामान्यीकृत किया जाता है, भले ही कोई प्रदाता उपभोग किया गया कोटा, शेष कोटा या केवल अपरिष्कृत गणनाएँ रिपोर्ट करे। रीसेट की जा सकने वाली कोटा विंडो के बिना प्रदाता इसके बजाय प्रदाता सारांश पाठ दिखाते हैं (उदाहरण के लिए, शेष राशि)।
• लाइव सत्र स्नैपशॉट में टोकन/मॉडल डेटा न होने पर, सत्र-स्तरीय /status और session_status टूल सत्र के ट्रांसक्रिप्ट लॉग का फ़ॉलबैक के रूप में उपयोग करते हैं। वह फ़ॉलबैक अनुपलब्ध टोकन/कैश काउंटर भरता है, सक्रिय रनटाइम मॉडल लेबल पुनर्प्राप्त कर सकता है और सत्र मेटाडेटा अनुपलब्ध या छोटा होने पर प्रॉम्प्ट-उन्मुख बड़े कुल को प्राथमिकता देता है (totalTokensFresh !== true, शून्य या ट्रांसक्रिप्ट से प्राप्त मान से कम)। शून्येतर लाइव मान हमेशा फ़ॉलबैक पर प्राथमिकता पाते हैं।

​

यह कहाँ दिखाई देता है

• चैट में /status: सत्र टोकन और अनुमानित लागत वाला स्थिति कार्ड (केवल API कुंजी मॉडल)। उपलब्ध होने पर वर्तमान मॉडल प्रदाता के लिए प्रदाता उपयोग, सामान्यीकृत X% left विंडो या प्रदाता सारांश पाठ के रूप में दिखाई देता है।
• चैट में /usage off|tokens|full: प्रत्येक प्रतिक्रिया के लिए उपयोग फ़ुटर।
• चैट में /usage cost: OpenClaw सत्र लॉग से एकत्रित स्थानीय लागत सारांश।
• CLI: openclaw status --usage प्रत्येक प्रदाता के उपयोग/कोटा का पूरा विवरण प्रिंट करता है।
• CLI: openclaw models status OAuth/टोकन प्रमाणीकरण प्रोफ़ाइल सूचीबद्ध करता है और जिन प्रदाताओं के पास उपयोग विंडो है, उनके पास उसका सारांश दिखाता है।
• Control UI: उपयोग में OpenClaw के सत्र से प्राप्त टोकन और अनुमानित-लागत विश्लेषण के ऊपर प्रदाता प्लान और बिलिंग कार्ड दिखते हैं। Anthropic और OpenAI Admin API क्रेडेंशियल प्रदाता द्वारा रिपोर्ट किया गया आज का, 7-दिन और 30-दिन का व्यय, दैनिक रुझान, टोकन कुल, शीर्ष मॉडल और लागत श्रेणियाँ जोड़ते हैं।
• Control UI: चैट कंपोज़र के कॉन्टेक्स्ट रिंग पॉपओवर में सदस्यता प्रदाताओं के लिए प्लान उपयोग दिखता है—रीसेट समय सहित प्रत्येक विंडो की पट्टियाँ (5-घंटे, साप्ताहिक, मॉडल-सीमित), ज्ञात होने पर प्रदाता प्लान (उदाहरण के लिए Max (20x)) और अतिरिक्त-उपयोग क्रेडिट। प्लान के माध्यम से बिल किए गए सत्र प्रति-टोकन डॉलर अनुमान छिपाते हैं; API द्वारा बिल किए गए सत्र Est. cost और प्रकार के अनुसार लागत विवरण बनाए रखते हैं। Claude Code CLI (claude-cli) सेटअप उसी Anthropic सदस्यता उपयोग का पुनः उपयोग करते हैं।
• macOS मेनू बार: प्रदाता उपयोग स्नैपशॉट उपलब्ध होने पर Context के नीचे मूल “Usage” अनुभाग दिखाई देता है। मेनू बार देखें।

​

Anthropic और OpenAI लागत इतिहास

• Anthropic सदस्यता/सेटअप क्रेडेंशियल Claude कोटा विंडो और वैकल्पिक अतिरिक्त-उपयोग बजट दिखाना जारी रखते हैं। इसके बजाय संगठन का Usage and Cost API इतिहास दिखाने के लिए ANTHROPIC_ADMIN_KEY या ANTHROPIC_ADMIN_API_KEY सेट करें। sk-ant-admin से शुरू होने वाले Anthropic प्रदाता क्रेडेंशियल का स्वचालित रूप से पता लगाया जाता है।
• OpenAI ChatGPT/Codex OAuth प्लान, कोटा विंडो और क्रेडिट शेष दिखाना जारी रखता है। इसके बजाय संगठन की लागत और completions-usage इतिहास दिखाने के लिए OPENAI_ADMIN_KEY सेट करें; इसे किसी एक प्रोजेक्ट तक सीमित करने के लिए वैकल्पिक रूप से OPENAI_PROJECT_ID सेट करें। OpenClaw कभी भी OPENAI_API_KEY, प्रदाता कॉन्फ़िगरेशन या प्रमाणीकरण प्रोफ़ाइल के अनुमान क्रेडेंशियल संगठन API को नहीं भेजता, क्योंकि वे कुंजियाँ कस्टम एंडपॉइंट से संबंधित हो सकती हैं।

​

डिफ़ॉल्ट उपयोग फ़ुटर मोड

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

​

सत्र की तीन अलग-अलग स्थितियाँ

​

प्राथमिकता

​

रीसेट करना बनाम बंद करना

• /usage 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>": "निम्न-से-उच्च ग्लिफ़" }, // स्ट्रिंग (1 ग्लिफ़/वर्ण) या ऐरे
  "aliases": { "<table>": { "<value>": "<label>" } },
  "output": {
    "sep": "", // शेष खंडों को जोड़ता है
    "default": [/* pieces */], // किसी भी इंटरफ़ेस के लिए फ़ॉलबैक
    "surfaces": {
      "discord": [/* pieces */],
      "telegram": [/* pieces */],
    },
  },
}

​

अनुबंध पथ

​

क्रियाएँ

​

अंश के रूप

• { "text": "📚 {context.max_tokens|num}" }: लिटरल + इंटरपोलेशन।
• { "when": "<path>", "text": "..." }: केवल तभी रेंडर करें जब पथ सत्य हो।
• { "map": "<path>", "cases": { "true": "⚡", "false": "🐌" } }: मान से ग्लिफ़ (एक _default केस बेमेल मानों को समाहित करता है)।
• { "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 टोकन। यदि OAuth टोकन में user:profile स्कोप नहीं है, तो सेट होने पर claude.ai वेब सत्र (CLAUDE_AI_SESSION_KEY, CLAUDE_WEB_SESSION_KEY, या CLAUDE_WEB_COOKIE में एक sessionKey= कुकी) पर फ़ॉलबैक करता है। जब Anthropic इन्हें रिपोर्ट करता है, तब मॉडल-स्कोप सीमाएँ और सक्षम अतिरिक्त-उपयोग का मासिक व्यय/बजट शामिल किए जाते हैं। इसके बजाय एक स्पष्ट Anthropic Admin API कुंजी, या स्वतः पहचानी गई sk-ant-admin... प्रदाता प्रोफ़ाइल, 30-दिन की संगठन लागत और Messages API इतिहास दिखाती है।
• ClawRouter: API कुंजी (CLAWROUTER_API_KEY)। कॉन्फ़िगर होने पर मासिक बजट विंडो और प्रकारयुक्त USD बजट दिखाता है; अन्यथा समग्र व्यय और अनुरोध/टोकन/लागत सारांश दिखाता है।
• DeepSeek: env/config/auth स्टोर के माध्यम से API कुंजी (DEEPSEEK_API_KEY)। प्रदाता द्वारा रिपोर्ट की गई प्रत्येक मुद्रा की शेष राशि दिखाता है।
• GitHub Copilot: प्रमाणीकरण प्रोफ़ाइल में OAuth टोकन।
• Gemini CLI: प्रमाणीकरण प्रोफ़ाइल में OAuth टोकन।
• MiniMax: API कुंजी या MiniMax OAuth प्रमाणीकरण प्रोफ़ाइल। OpenClaw minimax, minimax-cn, और minimax-portal को एक ही MiniMax कोटा सतह मानता है, उपलब्ध होने पर संग्रहीत MiniMax OAuth को प्राथमिकता देता है, और अन्यथा MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY, या MINIMAX_API_KEY पर फ़ॉलबैक करता है। कॉन्फ़िगर होने पर उपयोग पोलिंग, Coding Plan होस्ट को models.providers.minimax-portal.baseUrl या models.providers.minimax.baseUrl से प्राप्त करती है, और अन्यथा MiniMax CN होस्ट का उपयोग करती है। MiniMax के कच्चे usage_percent / usagePercent फ़ील्ड का अर्थ शेष कोटा है, इसलिए OpenClaw प्रदर्शन से पहले उन्हें उलट देता है; उपलब्ध होने पर संख्या-आधारित फ़ील्ड को प्राथमिकता मिलती है।
  • विंडो लेबल उपलब्ध होने पर प्रदाता के घंटे/मिनट फ़ील्ड से आते हैं, फिर start_time / end_time अवधि पर फ़ॉलबैक करते हैं।
  • यदि coding-plan एंडपॉइंट model_remains लौटाता है, तो OpenClaw चैट-मॉडल प्रविष्टि को प्राथमिकता देता है, स्पष्ट window_hours / window_minutes फ़ील्ड अनुपस्थित होने पर टाइमस्टैम्प से विंडो लेबल प्राप्त करता है, और योजना लेबल में मॉडल का नाम शामिल करता है।
• OpenAI (Codex/ChatGPT योजना): प्रमाणीकरण प्रोफ़ाइल में OAuth टोकन (खाता आईडी उपलब्ध होने पर ChatGPT-Account-Id हेडर भेजा जाता है)। रिपोर्ट होने पर ChatGPT योजना, रीसेट की जा सकने वाली Codex विंडो और क्रेडिट शेष दिखाता है। क्रेडिट प्रदाता क्रेडिट ही रहते हैं; OpenClaw उन्हें डॉलर के रूप में लेबल नहीं करता। OPENAI_ADMIN_KEY तब 30-दिन की संगठन लागत और completions-usage इतिहास जोड़ता है, जब कुंजी के पास Usage Dashboard पहुँच हो। इनफ़रेंस क्रेडेंशियल कभी भी संगठन API को अग्रेषित नहीं किए जाते।
• OpenRouter: API कुंजी या OAuth-समर्थित API कुंजी (OPENROUTER_API_KEY या कोई प्रमाणीकरण प्रोफ़ाइल)। खाता क्रेडिट एंडपॉइंट को कुंजी कोटा एंडपॉइंट के साथ जोड़ता है, ताकि जब क्रेडेंशियल उन्हें एक्सेस कर सके, तब खाते की शेष राशि/व्यय, कुंजी बजट और दैनिक/साप्ताहिक/मासिक उपयोग दिखाई दें। कोई भी एंडपॉइंट स्वतंत्र रूप से स्नैपशॉट को समृद्ध कर सकता है।
• Venice: env/config/auth स्टोर के माध्यम से API कुंजी (VENICE_API_KEY)। रिपोर्ट होने पर USD और DIEM शेष राशि के साथ DIEM युग आवंटन उपयोग दिखाता है।
• Xiaomi MiMo: दो अलग-अलग उपयोग सतहें। उपयोग के अनुसार भुगतान में API कुंजी (XIAOMI_API_KEY) का उपयोग होता है; Token Plan एक अलग कुंजी (XIAOMI_TOKEN_PLAN_API_KEY) का उपयोग करता है। वर्तमान में दोनों में से कोई भी कोटा विंडो रिपोर्ट नहीं करता।
• z.ai: env/config/auth स्टोर के माध्यम से API कुंजी (ZAI_API_KEY या Z_AI_API_KEY)।

​

संबंधित

• टोकन उपयोग और लागत
• API उपयोग और लागत
• प्रॉम्प्ट कैशिंग
• मेन्यू बार