> ## Documentation Index > Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt > Use this file to discover all available pages before exploring further. # उपयोग ट्रैकिंग ## यह क्या है * प्रदाता उपयोग/कोटा सीधे उनके उपयोग एंडपॉइंट से खींचता है। * कोई अनुमानित लागत नहीं; केवल प्रदाता-द्वारा रिपोर्ट की गई कोटा विंडो या खाता-स्थिति सारांश। * मानव-पठनीय कोटा-विंडो स्थिति आउटपुट को `X% left` में सामान्यीकृत किया जाता है, तब भी जब upstream API उपभुक्त कोटा, शेष कोटा, या केवल कच्ची गिनतियां रिपोर्ट करता है। रीसेट-योग्य कोटा विंडो के बिना प्रदाता इसके बजाय प्रदाता सारांश पाठ दिखा सकते हैं, जैसे बैलेंस। * सत्र-स्तरीय `/status` और `session_status`, जब लाइव सत्र स्नैपशॉट विरल हो, तो नवीनतम transcript उपयोग प्रविष्टि पर वापस जा सकते हैं। वह fallback अनुपस्थित token/cache काउंटर भरता है, सक्रिय runtime model label पुनर्प्राप्त कर सकता है, और जब सत्र metadata अनुपस्थित या छोटा हो तो बड़े prompt-केंद्रित कुल को प्राथमिकता देता है। मौजूदा गैर-शून्य लाइव मान फिर भी प्राथमिक रहेंगे। ## यह कहां दिखाई देता है * चैट में `/status`: emoji-समृद्ध स्थिति कार्ड, जिसमें सत्र tokens + अनुमानित लागत होती है (केवल API key)। उपलब्ध होने पर **वर्तमान model provider** के लिए प्रदाता उपयोग, सामान्यीकृत `X% left` विंडो या प्रदाता सारांश पाठ के रूप में दिखता है। * चैट में `/usage off|tokens|full`: प्रति-response उपयोग footer (OAuth केवल tokens दिखाता है)। * चैट में `/usage cost`: OpenClaw सत्र logs से संकलित स्थानीय लागत सारांश। * CLI: `openclaw status --usage` पूरा प्रति-प्रदाता breakdown प्रिंट करता है। * CLI: `openclaw channels list` प्रदाता config के साथ वही उपयोग snapshot प्रिंट करता है (छोड़ने के लिए `--no-usage` उपयोग करें)। * macOS menu bar: Context के अंतर्गत "Usage" section (केवल उपलब्ध होने पर)। ## डिफ़ॉल्ट उपयोग footer mode `/usage off|tokens|full` किसी सत्र के लिए footer सेट करता है और उस सत्र के लिए याद रखा जाता है। `messages.responseUsage` उन सत्रों के लिए वह mode seed करता है जिन्होंने कोई mode नहीं चुना है, ताकि हर बार `/usage` टाइप किए बिना footer डिफ़ॉल्ट रूप से चालू हो सके। हर channel के लिए एक mode सेट करें, या `default` fallback वाला per-channel map: ```jsonc theme={"theme":{"light":"min-light","dark":"min-dark"}} { "messages": { "responseUsage": "tokens", // or: { "default": "off", "discord": "full" } }, } ``` ### तीन अलग-अलग सत्र अवस्थाएं किसी सत्र के `responseUsage` field की तीन representable अवस्थाएं होती हैं, प्रत्येक की semantics अलग होती है: | अवस्था | संग्रहीत मान | प्रभावी mode | | ------------------- | --------------------------------- | ---------------------------------------------------------------------------- | | **Unset / inherit** | `undefined` (अनुपस्थित) | `messages.responseUsage` config default, फिर `off` पर falls through। | | **Explicit off** | `"off"` (संग्रहीत) | हमेशा off — कोई non-off config default footer को फिर से enable नहीं कर सकता। | | **Explicit on** | `"tokens"` या `"full"` (संग्रहीत) | वही mode, config default चाहे जो हो। | ### प्राथमिकता प्रभावी mode = सत्र override → channel config entry → `default` → `off`. स्पष्ट `/usage off` सत्र में literal value `"off"` के रूप में **persist** होता है, "unset" जैसा नहीं। इसका मतलब है कि non-off `messages.responseUsage` default, user द्वारा स्पष्ट रूप से disable करने के बाद footer को फिर से चालू नहीं कर सकता। ### रीसेट करना बनाम बंद करना * `/usage off` — footer को बंद करने के लिए बाध्य करता है और उस विकल्प को persist करता है। configured non-off default इसे override नहीं कर सकता। * `/usage reset` (aliases: `inherit`, `clear`, `default`) — सत्र override को clear करता है। फिर सत्र प्रभावी config default (`messages.responseUsage`) को **inherit** करता है। यदि कोई default configured नहीं है, तो footer off रहता है (पहले जैसा अपरिवर्तित)। इसे स्पष्ट रूप से footer चालू किए बिना "default पर वापस जाने" के लिए उपयोग करें। * पूरा सत्र reset (`/reset` या `/new`) या session rollover स्पष्ट usage-mode preference को **preserve** करता है, ताकि user की display choice session rollovers के बाद भी बनी रहे। केवल `/usage reset` (और इसके aliases) ही वास्तव में override को clear करते हैं। ### Toggle व्यवहार बिना arguments के `/usage` cycle करता है: off → tokens → full → off। cycle का starting point **effective** current mode होता है (session override unset होने पर config default पर falls through), इसलिए cycle हमेशा उससे consistent रहता है जो user footer में देखता है। ### Config बिना config के पिछला व्यवहार बना रहता है (footer `/usage` तक off)। session override clear करने और configured default को फिर से inherit करने के लिए `/usage reset` उपयोग करें। ## Custom `/usage full` footer `/usage full` उपलब्ध fields होने पर model, reasoning, fast/slow, context window, turn tokens, cache, और cost वाला built-in compact footer दिखाता है। कोई template file आवश्यक नहीं है। `messages.usageTemplate` केवल advanced custom layouts के लिए है। value एक JSON file path (`~` समर्थित) या inline object है, और valid होने पर यह built-in footer को replace करता है: ```json theme={"theme":{"light":"min-light","dark":"min-dark"}} { "messages": { "usageTemplate": "~/.openclaw/usage-footer.json" } } ``` Missing या empty templates चुपचाप built-in footer पर fall back करते हैं। Unreadable या invalid configured templates भी built-in footer पर fall back करते हैं और operator warning emit करते हैं। Custom templates को built-in shape से शुरू करें, फिर जिन parts को बदलना चाहते हैं उन्हें edit करें: ```jsonc theme={"theme":{"light":"min-light","dark":"min-dark"}} { "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": "usage.has_split_tokens", "text": " ↕️ {usage.input_tokens|num|?}/{usage.output_tokens|num|?}", }, { "when": "usage.has_total_only_tokens", "text": " ↕️ {usage.total_tokens|num}" }, { "when": "usage.cache_hit_pct", "text": " 🗄 {usage.cache_hit_pct|pct}" }, { "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": "usage.has_split_tokens", "text": " ↕️ {usage.input_tokens|num|?}/{usage.output_tokens|num|?}", }, { "when": "usage.has_total_only_tokens", "text": " ↕️ {usage.total_tokens|num}" }, { "when": "usage.cache_hit_pct", "text": " 🗄 {usage.cache_hit_pct|pct}" }, { "when": "cost.turn_usd", "text": " 💰{cost.turn_usd|fixed:4}" }, ], }, }, } ``` ### Shape ```jsonc theme={"theme":{"light":"min-light","dark":"min-dark"}} { "schema": "openclaw.usageBar.v1", "scales": { "": "low-to-high glyphs" }, // string (1 glyph/char) or array "aliases": { "": { "": "