---
read_when:
    - टोकन उपयोग, लागतों या कॉन्टेक्स्ट विंडो की व्याख्या करना
    - कॉन्टेक्स्ट वृद्धि या Compaction व्यवहार की डीबगिंग
summary: OpenClaw प्रॉम्प्ट संदर्भ कैसे बनाता है और टोकन उपयोग व लागतों की रिपोर्ट कैसे करता है
title: टोकन उपयोग और लागत
x-i18n:
    generated_at: "2026-07-27T18:36:29Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    prompt_version: 32
    provider: openai
    source_hash: 6624bceb0bcbca769c9d569389b73b82f1ea73133e09f0ae9859833196d85911
    source_path: reference/token-use.md
    workflow: 16
---

OpenClaw **टोकन** को ट्रैक करता है, वर्णों को नहीं। टोकन मॉडल-विशिष्ट होते हैं, लेकिन अधिकांश
OpenAI-शैली के मॉडलों में अंग्रेज़ी टेक्स्ट के लिए प्रति टोकन औसतन ~4 वर्ण होते हैं।

## सिस्टम प्रॉम्प्ट कैसे बनाया जाता है

OpenClaw प्रत्येक रन पर अपना सिस्टम प्रॉम्प्ट संयोजित करता है। इसमें शामिल हैं:

- टूल सूची + संक्षिप्त विवरण
- Skills सूची (केवल मेटाडेटा; निर्देश आवश्यकता पड़ने पर `read` से लोड होते हैं)। मूल
  Codex टर्न को टर्न-स्कोप वाले सहयोग
  डेवलपर निर्देशों के रूप में संक्षिप्त Skills ब्लॉक मिलता है; अन्य हार्नेस को यह सामान्य प्रॉम्प्ट सतह में मिलता है।
  `skills.limits.maxSkillsPromptChars` द्वारा सीमित, वैकल्पिक प्रति-एजेंट
  ओवरराइड `agents.entries.*.skillsLimits.maxSkillsPromptChars` पर।
- स्वयं-अपडेट निर्देश
- वर्कस्पेस + बूटस्ट्रैप फ़ाइलें (`AGENTS.md`, `SOUL.md`, `TOOLS.md`,
  `IDENTITY.md`, `USER.md`, `HEARTBEAT.md`, नई होने पर `BOOTSTRAP.md`, साथ ही
  मौजूद होने पर `MEMORY.md`)। इंजेक्ट की गई बड़ी फ़ाइलें
  `agents.defaults.bootstrapMaxChars` (डिफ़ॉल्ट: `20000`) द्वारा ट्रंकेट की जाती हैं; कुल बूटस्ट्रैप
  इंजेक्शन `agents.defaults.bootstrapTotalMaxChars` (डिफ़ॉल्ट:
  `60000`) द्वारा सीमित होता है।
  - जब उस वर्कस्पेस के लिए मेमोरी टूल उपलब्ध होते हैं, तो मूल Codex टर्न अपरिष्कृत `MEMORY.md` पेस्ट नहीं करते;
    इसके बजाय उन्हें टर्न-स्कोप वाले सहयोग डेवलपर निर्देशों में
    एक छोटा मेमोरी पॉइंटर मिलता है और वे आवश्यकता पड़ने पर मेमोरी
    टूल का उपयोग करते हैं। यदि टूल अक्षम हैं, मेमोरी खोज उपलब्ध नहीं है, या
    सक्रिय वर्कस्पेस एजेंट मेमोरी वर्कस्पेस से अलग है, तो `MEMORY.md`
    सामान्य सीमित टर्न-संदर्भ पथ पर वापस चला जाता है।
  - लोअरकेस रूट `memory.md` कभी इंजेक्ट नहीं किया जाता। यह
    `openclaw doctor --fix` के लिए लेगेसी सुधार इनपुट है, जो इसे `MEMORY.md` में माइग्रेट करता है।
  - `memory/*.md` दैनिक फ़ाइलें सामान्य बूटस्ट्रैप प्रॉम्प्ट का हिस्सा नहीं हैं;
    साधारण टर्न पर वे मेमोरी टूल के माध्यम से आवश्यकतानुसार उपलब्ध रहती हैं। रीसेट/स्टार्टअप
    मॉडल रन उस पहले टर्न के लिए हाल की
    दैनिक मेमोरी वाला एक बार उपयोग होने वाला स्टार्टअप-संदर्भ ब्लॉक प्रारंभ में जोड़ सकते हैं, जिसे
    `agents.defaults.startupContext` नियंत्रित करता है। केवल चैट वाले `/new` और `/reset` को
    मॉडल का आह्वान किए बिना स्वीकार किया जाता है।
  - Compaction के बाद के `AGENTS.md` अंशों के लिए स्पष्ट
    `agents.defaults.compaction.postCompactionSections` ऑप्ट-इन आवश्यक है; plugins
    `before_prompt_build` के माध्यम से अन्य संदर्भ जोड़ सकते हैं।
- समय (UTC + उपयोगकर्ता का समय क्षेत्र)
- उत्तर टैग + Heartbeat व्यवहार
- रनटाइम मेटाडेटा (होस्ट/OS/मॉडल/चिंतन)

पूरा विवरण [सिस्टम प्रॉम्प्ट](/hi/concepts/system-prompt) में देखें।

क्रेडेंशियल या प्रमाणीकरण स्निपेट का दस्तावेज़ीकरण करते समय, केवल दस्तावेज़ों वाले बदलावों में
सीक्रेट-स्कैनर के ग़लत पॉज़िटिव से बचने के लिए
[सीक्रेट प्लेसहोल्डर परंपराओं](/hi/reference/secret-placeholder-conventions) का उपयोग करें।

## संदर्भ विंडो में क्या गिना जाता है

मॉडल को मिलने वाली हर चीज़ संदर्भ सीमा में गिनी जाती है:

- सिस्टम प्रॉम्प्ट (ऊपर के सभी अनुभाग)
- वार्तालाप इतिहास (उपयोगकर्ता + सहायक संदेश)
- टूल कॉल और टूल परिणाम
- अटैचमेंट/ट्रांसक्रिप्ट (चित्र, ऑडियो, फ़ाइलें)
- Compaction सारांश और प्रूनिंग आर्टिफ़ैक्ट
- प्रदाता रैपर या सुरक्षा हेडर (दिखाई नहीं देते, लेकिन फिर भी गिने जाते हैं)

रनटाइम-भारी सतहों की अपनी स्पष्ट सीमाएँ
`agents.defaults.contextLimits` (प्रति-एजेंट ओवरराइड
`agents.entries.*.contextLimits` के अंतर्गत) होती हैं:

| कुंजी                      | उद्देश्य                                                                  |
| ------------------------ | ------------------------------------------------------------------------ |
| `memoryGetMaxChars`      | ट्रंकेशन से पहले `memory_get` द्वारा लौटाए जाने वाले अधिकतम वर्ण।                   |
| `postCompactionMaxChars` | Compaction के बाद रीफ़्रेश के दौरान `AGENTS.md` से रखे गए अधिकतम वर्ण। |

ये सीमित रनटाइम अंश और रनटाइम-स्वामित्व वाले इंजेक्टेड ब्लॉक हैं,
जो बूटस्ट्रैप सीमाओं, स्टार्टअप-संदर्भ सीमाओं और Skills प्रॉम्प्ट
सीमाओं से अलग हैं।

OpenClaw प्रभावी मॉडल संदर्भ
विंडो से लाइव टूल-परिणाम सीमा निर्धारित करता है: 100K टोकन से कम पर
`16000` वर्ण, 100K+ टोकन पर `32000` वर्ण, 200K+ टोकन पर `64000` वर्ण।
रनटाइम संदर्भ-हिस्सा गार्ड किसी एक टूल परिणाम को संदर्भ विंडो के 30% तक भी सीमित करता है।

जब बड़ी प्रदाता विंडो लागत या विलंबता में महत्वपूर्ण बदलाव करती हैं, तो वे
स्वचालित रूप से सक्षम नहीं होतीं। उदाहरण के लिए, प्रत्यक्ष OpenAI GPT-5.5 और GPT-5.6 मॉडल
कुल `1050000` टोकन विंडो प्रकाशित करते हैं, लेकिन OpenClaw उनके सक्रिय
रनटाइम बजट को डिफ़ॉल्ट रूप से `272000` टोकन रखता है। ऑप्ट-इन `922000` इनपुट बजट पूर्ण
`128000` आउटपुट भत्ता आरक्षित करता है, और इनपुट `272000` टोकन से अधिक होते ही OpenAI पूरे अनुरोध पर
उच्च दीर्घ-संदर्भ मूल्य निर्धारण लागू करता है। देखें
[OpenAI संदर्भ विंडो डिफ़ॉल्ट](/hi/providers/openai#context-window-defaults-and-long-context-opt-in)।

चित्रों के लिए, OpenClaw प्रदाता कॉल से पहले ट्रांसक्रिप्ट/टूल चित्र पेलोड का
आकार कम करता है। `agents.defaults.imageMaxDimensionPx` (डिफ़ॉल्ट:
`1200`) से समायोजित करें:

- कम मान विज़न-टोकन उपयोग और पेलोड आकार घटाते हैं।
- अधिक मान OCR/UI-प्रधान स्क्रीनशॉट के लिए अधिक दृश्य विवरण बनाए रखते हैं।

व्यावहारिक विवरण (प्रति इंजेक्टेड फ़ाइल, टूल, Skills और सिस्टम
प्रॉम्प्ट आकार) के लिए `/context list` या `/context detail` का उपयोग करें। देखें
[संदर्भ](/hi/concepts/context)।

## वर्तमान टोकन उपयोग कैसे देखें

चैट में:

- `/status` -> सत्र मॉडल, संदर्भ उपयोग,
  अंतिम प्रतिक्रिया के इनपुट/आउटपुट टोकन और सक्रिय मॉडल के लिए स्थानीय मूल्य निर्धारण
  कॉन्फ़िगर होने पर अनुमानित लागत वाला इमोजी-समृद्ध स्थिति कार्ड।
- `/usage off|tokens|full` -> प्रत्येक
  उत्तर में प्रति-प्रतिक्रिया उपयोग फ़ुटर जोड़ता है। प्रति सत्र बना रहता है (`responseUsage` के रूप में संग्रहीत)।
  - `/usage reset` (उपनाम: `inherit`, `clear`, `default`) सत्र
    ओवरराइड को साफ़ करता है ताकि यह कॉन्फ़िगर किया गया डिफ़ॉल्ट फिर से प्राप्त करे।
  - `/usage tokens` टर्न के टोकन/कैश विवरण दिखाता है।
  - `/usage full` संक्षिप्त मॉडल/संदर्भ/लागत विवरण दिखाता है; अनुमानित लागत
    केवल तभी दिखाई देती है जब OpenClaw के पास सक्रिय मॉडल के लिए उपयोग मेटाडेटा और
    स्थानीय मूल्य निर्धारण हो। कस्टम `messages.usageTemplate` लेआउट में
    टोकन/कैश फ़ील्ड शामिल हो सकते हैं।
- `/usage cost` -> OpenClaw सत्र लॉग से स्थानीय लागत सारांश।

अन्य सतहें:

- **TUI/Web TUI:** `/status` और `/usage` समर्थित हैं।
- **CLI:** `openclaw status --usage` और `openclaw channels list`
  सामान्यीकृत प्रदाता कोटा विंडो दिखाते हैं (`X% left`, प्रति-प्रतिक्रिया लागत नहीं)।
  वर्तमान उपयोग-विंडो प्रदाता: Claude (Anthropic), ClawRouter, Copilot
  (GitHub), DeepSeek, Gemini (Google Gemini CLI), MiniMax, OpenAI, Xiaomi,
  Xiaomi Token Plan और z.ai।

प्रदर्शन से पहले उपयोग सतहें प्रदाता-मूल के सामान्य फ़ील्ड उपनामों को
सामान्यीकृत करती हैं। OpenAI-परिवार के Responses ट्रैफ़िक के लिए, इसमें
`input_tokens`/`output_tokens` और `prompt_tokens`/`completion_tokens` दोनों शामिल हैं, ताकि
ट्रांसपोर्ट-विशिष्ट फ़ील्ड नाम `/status`, `/usage` या सत्र
सारांशों को न बदलें। Gemini CLI उपयोग भी सामान्यीकृत होता है: डिफ़ॉल्ट `stream-json`
पार्सर सहायक `message` इवेंट पढ़ता है, और `stats.cached` को
`cacheRead` पर मैप किया जाता है, जिसमें CLI द्वारा स्पष्ट
`stats.input` फ़ील्ड छोड़ने पर `stats.input_tokens - stats.cached` का उपयोग होता है। लेगेसी JSON ओवरराइड अब भी
`response` से उत्तर टेक्स्ट पढ़ते हैं।

मूल OpenAI-परिवार Responses ट्रैफ़िक के लिए, WebSocket/SSE उपयोग उपनाम
उसी तरह सामान्यीकृत होते हैं, और `total_tokens` के अनुपस्थित या `0` होने पर कुल मान
सामान्यीकृत इनपुट + आउटपुट पर वापस जाता है।

जब वर्तमान सत्र स्नैपशॉट में कम जानकारी होती है, तो `/status` और `session_status`
सबसे हाल के ट्रांसक्रिप्ट उपयोग लॉग से टोकन/कैश काउंटर और सक्रिय रनटाइम मॉडल लेबल
पुनर्प्राप्त कर सकते हैं। मौजूदा शून्येतर लाइव मान अब भी
ट्रांसक्रिप्ट फ़ॉलबैक मानों पर प्राथमिकता रखते हैं, और संग्रहीत कुल मान अनुपस्थित या छोटे होने पर
बड़े प्रॉम्प्ट-उन्मुख ट्रांसक्रिप्ट कुल मान प्राथमिकता पा सकते हैं।

प्रदाता कोटा विंडो के लिए उपयोग प्रमाणीकरण पहले प्रदाता-विशिष्ट हुक से
आता है; यदि किसी प्रदाता के पास हुक नहीं है (या हुक टोकन को हल नहीं करता),
तो OpenClaw प्रमाणीकरण प्रोफ़ाइल, env या कॉन्फ़िगरेशन से मेल खाने वाले OAuth/API-कुंजी क्रेडेंशियल पर
वापस जाता है।

सहायक ट्रांसक्रिप्ट प्रविष्टियाँ वही सामान्यीकृत उपयोग आकार बनाए रखती हैं,
जिसमें सक्रिय मॉडल के लिए मूल्य निर्धारण कॉन्फ़िगर होने और प्रदाता द्वारा उपयोग मेटाडेटा
लौटाए जाने पर `usage.cost` शामिल होता है। इससे लाइव
रनटाइम स्थिति समाप्त होने के बाद भी `/usage cost` और
ट्रांसक्रिप्ट-समर्थित सत्र स्थिति को एक स्थिर स्रोत मिलता है।

OpenClaw प्रदाता उपयोग लेखांकन को वर्तमान संदर्भ
स्नैपशॉट से अलग रखता है। प्रदाता `usage.total` में कैश किया गया इनपुट, आउटपुट और
एकाधिक टूल-लूप मॉडल कॉल शामिल हो सकते हैं, इसलिए यह लागत और टेलीमेट्री के लिए उपयोगी है, लेकिन
लाइव संदर्भ विंडो को बढ़ा-चढ़ाकर दिखा सकता है। संदर्भ प्रदर्शन और निदान
`context.used` के लिए नवीनतम प्रॉम्प्ट स्नैपशॉट (`promptTokens`, या कोई
प्रॉम्प्ट स्नैपशॉट उपलब्ध न होने पर अंतिम मॉडल कॉल) का उपयोग करते हैं।

## लागत का अनुमान (जब दिखाया जाए)

लागत का अनुमान आपके मॉडल मूल्य निर्धारण कॉन्फ़िगरेशन से लगाया जाता है:

```text
models.providers.<provider>.models[].cost
```

ये `input`, `output`, `cacheRead` और
`cacheWrite` के लिए **प्रति 1M टोकन USD** हैं। यदि मूल्य निर्धारण अनुपस्थित है, तो `/usage full` लागत छोड़ देता है; जब आपको
प्रत्येक उत्तर में टोकन/कैश विवरण चाहिए, तो `/usage tokens` या कस्टम `messages.usageTemplate` का उपयोग करें।
लागत प्रदर्शन केवल API-कुंजी
प्रमाणीकरण तक सीमित नहीं है: `aws-sdk` जैसे गैर-API-कुंजी प्रदाता अनुमानित लागत दिखा सकते हैं, जब
उनकी कॉन्फ़िगर की गई मॉडल प्रविष्टि में स्थानीय मूल्य निर्धारण शामिल हो और प्रदाता
उपयोग मेटाडेटा लौटाए।

साइडकार और चैनल के Gateway तैयार पथ तक पहुँचने के बाद, OpenClaw उन कॉन्फ़िगर किए गए मॉडल संदर्भों के लिए
एक वैकल्पिक पृष्ठभूमि मूल्य निर्धारण बूटस्ट्रैप प्रारंभ करता है जिनके पास पहले से
स्थानीय मूल्य निर्धारण नहीं है। वह बूटस्ट्रैप दूरस्थ OpenRouter और
LiteLLM मूल्य निर्धारण कैटलॉग प्राप्त करता है। ऑफ़लाइन या प्रतिबंधित नेटवर्क पर उन
कैटलॉग फ़ेच को छोड़ने के लिए `models.pricing.enabled: false` सेट करें; स्पष्ट
`models.providers.*.models[].cost` प्रविष्टियाँ फिर भी स्थानीय लागत अनुमान चलाती हैं।

## कैश TTL और प्रूनिंग का प्रभाव

प्रदाता प्रॉम्प्ट कैशिंग केवल कैश TTL विंडो के भीतर लागू होती है। OpenClaw
वैकल्पिक रूप से **कैश-TTL प्रूनिंग** चला सकता है: कैश TTL समाप्त होने पर यह
सत्र को प्रून करता है, फिर कैश विंडो रीसेट करता है ताकि बाद के अनुरोध
पूरे इतिहास को फिर से कैश करने के बजाय नए कैश किए गए संदर्भ का पुनः उपयोग करें।
जब कोई सत्र TTL से अधिक समय तक निष्क्रिय रहता है, तो इससे कैश लेखन लागत कम रहती है।

इसे [Gateway कॉन्फ़िगरेशन](/hi/gateway/configuration) में कॉन्फ़िगर करें और व्यवहार का
विवरण [सत्र प्रूनिंग](/hi/concepts/session-pruning) में देखें।

Heartbeat निष्क्रिय अंतरालों के दौरान कैश को **सक्रिय** रख सकता है। यदि आपके मॉडल कैश
का TTL `1h` है, तो Heartbeat अंतराल को उससे थोड़ा कम (जैसे, `55m`) सेट करने से
पूरे प्रॉम्प्ट को फिर से कैश करने से बचा जा सकता है और कैश लेखन लागत घट सकती है।

बहु-एजेंट सेटअप में, आप एक साझा मॉडल कॉन्फ़िगरेशन रख सकते हैं और
`agents.entries.*.params.cacheRetention` के साथ प्रति एजेंट कैश व्यवहार समायोजित कर सकते हैं।

हर विकल्प के संपूर्ण मार्गदर्शन के लिए [प्रॉम्प्ट कैशिंग](/hi/reference/prompt-caching) देखें।

Anthropic API मूल्य निर्धारण में, कैश रीड इनपुट
टोकन की तुलना में काफ़ी सस्ते हैं, जबकि कैश राइट के लिए अधिक गुणक पर बिल लिया जाता है। नवीनतम दरों और TTL गुणकों के लिए Anthropic का
प्रॉम्प्ट कैशिंग मूल्य निर्धारण देखें:
[https://docs.anthropic.com/docs/build-with-claude/prompt-caching](https://docs.anthropic.com/docs/build-with-claude/prompt-caching)

### उदाहरण: Heartbeat से 1h कैश सक्रिय रखें

```yaml
agents:
  defaults:
    model:
      primary: "anthropic/claude-opus-4-6"
    models:
      "anthropic/claude-opus-4-6":
        params:
          cacheRetention: "long"
    heartbeat:
      every: "55m"
```

### उदाहरण: प्रति-एजेंट कैश रणनीति वाला मिश्रित ट्रैफ़िक

```yaml
agents:
  defaults:
    model:
      primary: "anthropic/claude-opus-4-6"
    models:
      "anthropic/claude-opus-4-6":
        params:
          cacheRetention: "long" # अधिकांश एजेंटों के लिए डिफ़ॉल्ट आधार
  list:
    - id: "research"
      default: true
      heartbeat:
        every: "55m" # गहन सत्रों के लिए लंबी कैश को सक्रिय रखें
    - id: "alerts"
      params:
        cacheRetention: "none" # बार-बार आने वाली सूचनाओं के लिए कैश लेखन से बचें
```

`agents.entries.*.params` चयनित मॉडल के `params` के ऊपर मर्ज होता है, इसलिए आप
केवल `cacheRetention` को ओवरराइड कर सकते हैं और अन्य मॉडल डिफ़ॉल्ट को
बिना बदलाव के प्राप्त कर सकते हैं।

### Anthropic का 1M कॉन्टेक्स्ट

OpenClaw, Opus 4.8, Opus 4.7, Opus 4.6 और Sonnet 4.6 जैसे GA-सक्षम Claude 4.x
मॉडलों का आकार Anthropic की 1M कॉन्टेक्स्ट विंडो के अनुसार निर्धारित करता है। उन मॉडलों के लिए
आपको `params.context1m: true` की आवश्यकता नहीं है।

```yaml
agents:
  defaults:
    models:
      "anthropic/claude-opus-4-6":
        alias: opus
```

पुराने कॉन्फ़िगरेशन में `context1m: true` रखा जा सकता है, लेकिन OpenClaw अब इस सेटिंग के लिए
Anthropic का बंद किया गया `context-1m-2025-08-07` बीटा हेडर नहीं भेजता और
असमर्थित पुराने Claude मॉडलों को 1M तक विस्तृत नहीं करता।

आवश्यकता: क्रेडेंशियल दीर्घ-कॉन्टेक्स्ट उपयोग के लिए पात्र होना चाहिए। यदि ऐसा नहीं है,
तो Anthropic उस अनुरोध के लिए प्रदाता-पक्ष की दर-सीमा त्रुटि देता है।

यदि आप OAuth/सब्सक्रिप्शन टोकन
(`sk-ant-oat-*`) के साथ Anthropic को प्रमाणित करते हैं, तो OpenClaw OAuth के लिए आवश्यक Anthropic बीटा
हेडर सुरक्षित रखता है और पुराने कॉन्फ़िगरेशन में मौजूद बंद किए गए `context-1m-*`
बीटा को हटा देता है।

## टोकन दबाव कम करने के सुझाव

- लंबे सत्रों का सारांश बनाने के लिए `/compact` का उपयोग करें।
- अपने वर्कफ़्लो में बड़े टूल आउटपुट को संक्षिप्त करें।
- स्क्रीनशॉट-प्रधान सत्रों के लिए `agents.defaults.imageMaxDimensionPx` कम करें।
- स्किल विवरण छोटे रखें (स्किल सूची प्रॉम्प्ट में जोड़ी जाती है)।
- विस्तृत, अन्वेषणात्मक कार्य के लिए छोटे मॉडलों को प्राथमिकता दें।

स्किल सूची के ओवरहेड का सटीक सूत्र जानने के लिए [Skills](/hi/tools/skills) देखें।

## संबंधित

- [API उपयोग और लागत](/hi/reference/api-usage-costs)
- [प्रॉम्प्ट कैशिंग](/hi/reference/prompt-caching)
- [उपयोग ट्रैकिंग](/hi/concepts/usage-tracking)