--- read_when: - आप प्रदाता के उपयोग/कोटा इंटरफ़ेस जोड़ रहे हैं - आपको उपयोग ट्रैकिंग के व्यवहार या प्रमाणीकरण आवश्यकताओं की व्याख्या करनी होगी summary: उपयोग ट्रैकिंग की उपलब्ध सुविधाएँ और क्रेडेंशियल संबंधी आवश्यकताएँ title: उपयोग ट्रैकिंग x-i18n: generated_at: "2026-07-27T19:38:52Z" model: gpt-5.6 postprocess_version: locale-links-v1 prompt_version: 32 provider: openai source_hash: 5a1bc9aeb95cd80a48ab57a18fcd24894fdd6fb71e10e8bea8bae67a8688b78e source_path: concepts/usage-tracking.md workflow: 16 --- ## यह क्या है - प्रत्येक प्रदाता के उपयोग एंडपॉइंट से सीधे प्रदाता उपयोग/कोटा प्राप्त करता है। प्रदाता बिलिंग का कोई अनुमान नहीं; केवल प्रदाता द्वारा रिपोर्ट किए गए प्लान के नाम, कोटा विंडो, शेष राशियाँ, व्यय, बजट, दैनिक लागत इतिहास, टोकन/मॉडल श्रेय या खाता-स्थिति सारांश। - मानव-पठनीय कोटा-विंडो आउटपुट को `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" अनुभाग दिखाई देता है। [मेनू बार](/hi/platforms/mac/menu-bar) देखें। `openclaw channels list` अब प्रदाता उपयोग प्रिंट नहीं करता; इसके बजाय यह उपयोगकर्ताओं को `openclaw status` या `openclaw models list` की ओर निर्देशित करता है। ## Anthropic और OpenAI लागत इतिहास सदस्यता कोटा और API बिलिंग प्रदाता के अलग-अलग इंटरफ़ेस हैं: - 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 को नहीं भेजता, क्योंकि वे कुंजियाँ कस्टम एंडपॉइंट से संबंधित हो सकती हैं। Admin क्रेडेंशियल को प्राथमिकता मिलती है, क्योंकि वे संगठन की वास्तविक बिलिंग प्रदान करते हैं। OpenClaw प्रदाता द्वारा रिपोर्ट किए गए इन कुल मानों को अपने स्थानीय सत्र अनुमानों के साथ संयोजित नहीं करता; दोनों अनुभाग जानबूझकर अलग-अलग प्रश्नों के उत्तर देते हैं। ## डिफ़ॉल्ट उपयोग फ़ुटर मोड `/usage off|tokens|full` किसी सत्र के लिए फ़ुटर सेट करता है और उसे उस सत्र के लिए याद रखा जाता है। `messages.responseUsage` उन सत्रों के लिए उस मोड का प्रारंभिक मान निर्धारित करता है जिन्होंने कोई मोड नहीं चुना है, ताकि हर बार `/usage` टाइप किए बिना फ़ुटर डिफ़ॉल्ट रूप से चालू रह सके। प्रत्येक चैनल के लिए एक मोड या `default` फ़ॉलबैक वाला प्रति-चैनल मैप सेट करें: ```jsonc { "messages": { "responseUsage": "tokens", // या: { "default": "off", "discord": "full" } }, } ``` स्वीकृत मान: `"off"`, `"tokens"`, `"full"` और पुराना उपनाम `"on"` (इसे `"tokens"` माना जाता है)। ### सत्र की तीन अलग-अलग स्थितियाँ किसी सत्र के `responseUsage` फ़ील्ड की तीन निरूपणीय स्थितियाँ होती हैं, जिनमें से प्रत्येक के अलग अर्थ हैं: | स्थिति | संग्रहीत मान | प्रभावी मोड | | ------------------- | ------------------------------- | --------------------------------------------------------------------- | | **सेट नहीं / इनहेरिट** | `undefined` (अनुपस्थित) | `messages.responseUsage` कॉन्फ़िगरेशन डिफ़ॉल्ट, फिर `off` पर जाता है। | | **स्पष्ट रूप से बंद** | `"off"` (संग्रहीत) | हमेशा बंद; बंद से अलग कॉन्फ़िगरेशन डिफ़ॉल्ट फ़ुटर को फिर से चालू नहीं कर सकता। | | **स्पष्ट रूप से चालू** | `"tokens"` या `"full"` (संग्रहीत) | कॉन्फ़िगरेशन डिफ़ॉल्ट की परवाह किए बिना वही मोड। | ### प्राथमिकता प्रभावी मोड = सत्र ओवरराइड → चैनल कॉन्फ़िगरेशन प्रविष्टि → `default` → `off`। स्पष्ट `/usage off` सत्र में शाब्दिक मान `"off"` के रूप में **स्थायी रूप से संग्रहीत** होता है, यह "सेट नहीं" के समान नहीं है। उपयोगकर्ता द्वारा स्पष्ट रूप से अक्षम किए जाने के बाद, बंद से अलग `messages.responseUsage` डिफ़ॉल्ट फ़ुटर को फिर से चालू नहीं कर सकता। ### रीसेट करना बनाम बंद करना - `/usage off` फ़ुटर को जबरन बंद करता है और उस विकल्प को स्थायी रूप से संग्रहीत करता है। कॉन्फ़िगर किया गया बंद से अलग डिफ़ॉल्ट इसे ओवरराइड नहीं कर सकता। - `/usage reset` (उपनाम: `default`, `inherit`, `inherited`, `clear`, `unpin`) सत्र ओवरराइड साफ़ करता है। इसके बाद सत्र प्रभावी कॉन्फ़िगरेशन डिफ़ॉल्ट (`messages.responseUsage`) को **इनहेरिट** करता है। यदि कोई डिफ़ॉल्ट कॉन्फ़िगर नहीं है, तो फ़ुटर बंद रहता है। - पूर्ण सत्र रीसेट (`/reset` या `/new`) या सत्र रोलओवर स्पष्ट उपयोग-मोड प्राथमिकता को **बनाए रखता है**, ताकि उपयोगकर्ता की प्रदर्शन पसंद सत्र रोलओवर के बाद भी बनी रहे। केवल `/usage reset` (और उसके उपनाम) ओवरराइड साफ़ करते हैं। ### टॉगल व्यवहार बिना आर्ग्युमेंट के `/usage` इस क्रम में चक्रित होता है: बंद → टोकन → पूर्ण → बंद। चक्र का प्रारंभिक बिंदु **प्रभावी** वर्तमान मोड होता है (सेट नहीं होने पर सत्र ओवरराइड से कॉन्फ़िगरेशन डिफ़ॉल्ट तक जाना), इसलिए चक्र हमेशा फ़ुटर में उपयोगकर्ता को वर्तमान में दिखाई देने वाली स्थिति से मेल खाता है। ### कॉन्फ़िगरेशन बिना कॉन्फ़िगरेशन के पिछला व्यवहार बना रहता है (`/usage` तक फ़ुटर बंद)। सत्र ओवरराइड साफ़ करने और कॉन्फ़िगर किए गए डिफ़ॉल्ट को फिर से इनहेरिट करने के लिए `/usage reset` का उपयोग करें। ## कस्टम `/usage full` फ़ुटर `/usage tokens` हमेशा एक साधारण `Usage: X in / Y out` पंक्ति रेंडर करता है (साथ ही उपलब्ध होने पर कैश और अनुमानित-लागत प्रत्यय)। केवल `/usage full` नीचे वर्णित अधिक समृद्ध फ़ुटर रेंडर करता है। `/usage full` मॉडल, रीजनिंग, तेज़/धीमा, कॉन्टेक्स्ट विंडो और लागत के साथ अंतर्निहित संक्षिप्त फ़ुटर दिखाता है, जब वे फ़ील्ड उपलब्ध हों। अंतर्निहित फ़ुटर के लिए किसी टेम्पलेट फ़ाइल की आवश्यकता नहीं है। `messages.usageTemplate` केवल उन्नत कस्टम लेआउट के लिए है। इसका मान एक JSON फ़ाइल पथ (`~` समर्थित) या इनलाइन ऑब्जेक्ट है और मान्य होने पर यह अंतर्निहित फ़ुटर को प्रतिस्थापित करता है। फ़ाइल पथ पर नज़र रखी जाती है और बदलाव होने पर उसे लाइव पुनः लोड किया जाता है। ```json { "messages": { "usageTemplate": "~/.openclaw/usage-footer.json" } } ``` अनुपलब्ध या खाली टेम्पलेट बिना सूचना के अंतर्निहित फ़ुटर का फ़ॉलबैक उपयोग करते हैं। अपठनीय या अमान्य कॉन्फ़िगर किए गए टेम्पलेट (खराब JSON या ऐसी संरचना जिसमें रेंडर करने योग्य आउटपुट खंड न हों) भी अंतर्निहित फ़ुटर का फ़ॉलबैक उपयोग करते हैं और ऑपरेटर चेतावनी जारी करते हैं। कस्टम टेम्पलेट को अंतर्निहित संरचना से शुरू करें, फिर उन भागों को संपादित करें जिन्हें आप बदलना चाहते हैं: ```jsonc { "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}" }, ], }, }, } ``` ### संरचना ```jsonc { "schema": "openclaw.usageBar.v1", "scales": { "": "निम्न-से-उच्च ग्लिफ़" }, // स्ट्रिंग (1 ग्लिफ़/वर्ण) या ऐरे "aliases": { "": { "": "