Technical reference

API उपयोग और लागत

OpenClaw की उन सुविधाओं का मानचित्र जो सशुल्क प्रदाता API को कॉल कर सकती हैं, जहाँ से प्रत्येक अपने क्रेडेंशियल पढ़ती है, और परिणामी लागत कहाँ दिखाई देती है।

लागत कहाँ दिखाई देती है

/status (प्रति-सत्र स्नैपशॉट)

वर्तमान सत्र मॉडल, संदर्भ उपयोग और अंतिम प्रतिक्रिया के टोकन दिखाता है।
जब OpenClaw के पास सक्रिय मॉडल के लिए उपयोग मेटाडेटा और स्थानीय मूल्य-निर्धारण होता है, तब अंतिम उत्तर की अनुमानित लागत जोड़ता है। इसमें Bedrock aws-sdk मॉडल जैसे स्पष्ट रूप से मूल्य-निर्धारित गैर-API-कुंजी प्रदाता भी शामिल हैं।
यदि लाइव सत्र स्नैपशॉट में कम जानकारी है, तो /status नवीनतम ट्रांसक्रिप्ट उपयोग प्रविष्टि से टोकन/कैश काउंटर और सक्रिय मॉडल लेबल पुनर्प्राप्त करता है। मौजूदा गैर-शून्य लाइव मानों को ट्रांसक्रिप्ट डेटा पर प्राथमिकता मिलती है; संग्रहीत कुल अनुपलब्ध या छोटा होने पर प्रॉम्प्ट-आकार का ट्रांसक्रिप्ट कुल फिर भी प्राथमिकता पा सकता है।

/usage (प्रति-संदेश पादलेख)

/usage full प्रत्येक उत्तर में उपयोग पादलेख जोड़ता है, जिसमें स्थानीय मूल्य-निर्धारण कॉन्फ़िगर होने और उपयोग मेटाडेटा उपलब्ध होने पर अनुमानित लागत भी शामिल होती है।
/usage tokens केवल टोकन दिखाता है। सदस्यता-शैली के OAuth/टोकन और CLI रनटाइम केवल टोकन दिखाते हैं, जब तक कि वे संगत उपयोग मेटाडेटा के साथ स्पष्ट स्थानीय मूल्य भी न दें।
/usage cost स्थानीय लागत सारांश प्रिंट करता है; /usage off पादलेख अक्षम करता है।
Gemini CLI संबंधी टिप्पणी: stream-json और पुराने json आउटपुट, दोनों में उपयोग डेटा stats के अंतर्गत होता है। OpenClaw stats.cached को cacheRead में सामान्यीकृत करता है और आवश्यकता होने पर stats.input_tokens - stats.cached से इनपुट टोकन प्राप्त करता है।

Control UI → Usage (सत्र-पार विश्लेषण)

चुनी गई तारीख सीमा के लिए ट्रांसक्रिप्ट से प्राप्त टोकन और अनुमानित लागत के कुल दिखाता है, साथ ही प्रदाता, मॉडल, एजेंट, चैनल और टोकन प्रकार के अनुसार विवरण देता है।
चुनी गई सीमा की समाप्ति तारीख पर समाप्त होने वाली छोटी कैलेंडर अवधियों की तुलना करता है। अनुपलब्ध तारीखें शून्य-उपयोग वाले कैलेंडर दिनों के रूप में गिनी जाती हैं; अधिक सघन अवधि बनाने के लिए उन्हें छोड़ा नहीं जाता।
दैनिक चार्ट का पैमाना सीधे लेबल करता है। √ बैज का अर्थ है कि वर्गमूल संपीड़न कम-उपयोग वाले दिनों को दृश्यमान बनाए रख रहा है।
ये कुल उपलब्ध स्थानीय सत्र इतिहास का वर्णन करते हैं, प्रदाता के इनवॉइस या आजीवन बिलिंग बही-खाते का नहीं। कुछ प्रविष्टियों के लिए मूल्य-निर्धारण अनुपलब्ध होने पर UI चेतावनी देता है।

CLI उपयोग अवधियाँ (प्रदाता कोटा, प्रति-संदेश लागत नहीं)

openclaw status --usage और openclaw channels list प्रदाता की उपयोग अवधियाँ X% left के रूप में दिखाते हैं।
वर्तमान उपयोग-अवधि प्रदाता: Anthropic, ClawRouter, DeepSeek, GitHub Copilot, Gemini CLI, MiniMax, OpenAI (ChatGPT/Codex OAuth/टोकन प्रमाणीकरण को शामिल करता है), Xiaomi और z.ai। प्रदाताओं/फ़्लैग की पूरी सूची के लिए मॉडल CLI और चैनल CLI देखें।
MiniMax के मूल usage_percent / usagePercent फ़ील्ड शेष कोटा बताते हैं, इसलिए OpenClaw उन्हें उलट देता है; उपलब्ध होने पर गणना-आधारित फ़ील्ड को प्राथमिकता मिलती है। यदि प्रतिक्रिया में model_remains सरणी शामिल हो, तो OpenClaw चैट-मॉडल प्रविष्टि चुनता है, आवश्यकता होने पर टाइमस्टैम्प से अवधि लेबल प्राप्त करता है और योजना लेबल में मॉडल का नाम शामिल करता है।
उपलब्ध होने पर उपयोग प्रमाणीकरण प्रदाता-विशिष्ट हुक से आता है; अन्यथा OpenClaw प्रमाणीकरण प्रोफ़ाइल, परिवेश या कॉन्फ़िगरेशन से मेल खाने वाले OAuth/API-कुंजी क्रेडेंशियल का उपयोग करता है।

विस्तृत उदाहरणों के लिए टोकन उपयोग और लागत देखें।

कुंजियाँ कैसे खोजी जाती हैं

प्रमाणीकरण प्रोफ़ाइल: प्रति-एजेंट, auth-profiles.json में संग्रहीत।
परिवेश चर: उदाहरण के लिए OPENAI_API_KEY, BRAVE_API_KEY, FIRECRAWL_API_KEY।
कॉन्फ़िगरेशन: models.providers.*.apiKey, plugins.entries.*.config.webSearch.apiKey, plugins.entries.firecrawl.config.webFetch.apiKey, memory.search.*, talk.providers.*.apiKey।
Skills: skills.entries.<name>.apiKey, जो कुंजी को स्किल प्रक्रिया के परिवेश में निर्यात कर सकता है।

वे सुविधाएँ जो कुंजियों का सशुल्क उपयोग कर सकती हैं

मुख्य मॉडल प्रतिक्रियाएँ (चैट + टूल)

प्रत्येक उत्तर या टूल कॉल वर्तमान मॉडल प्रदाता पर चलता है। यह उपयोग और लागत का प्राथमिक स्रोत है, जिसमें OpenClaw के स्थानीय UI के बाहर बिल किए जाने वाले सदस्यता-शैली के होस्टेड प्लान भी शामिल हैं: OpenAI Codex, Alibaba Cloud Model Studio Coding Plan, MiniMax Coding Plan, Z.AI/GLM Coding Plan और Extra Usage सक्षम वाला Anthropic का Claude-लॉगिन पथ।

मूल्य-निर्धारण कॉन्फ़िगरेशन के लिए मॉडल और प्रदर्शन के लिए टोकन उपयोग और लागत देखें।

मीडिया की समझ (ऑडियो/छवि/वीडियो)

उत्तर पाइपलाइन चलने से पहले प्रदाता API के माध्यम से आने वाले मीडिया का सारांश या प्रतिलेखन किया जा सकता है। प्रदाता समर्थन प्रति Plugin पंजीकृत होता है और Plugin जोड़े जाने पर बदलता है; वर्तमान सूची और कॉन्फ़िगरेशन के लिए मीडिया की समझ देखें।

छवि और वीडियो जनरेशन

image_generate और video_generate उपलब्ध किसी भी प्रमाणीकृत प्रदाता को अनुरोध भेजते हैं। अपनी agents.defaults.mediaModels प्रविष्टि सेट न होने पर दोनों प्रमाणीकरण-समर्थित डिफ़ॉल्ट प्रदाता का अनुमान लगा सकते हैं।

वर्तमान प्रदाता सूची के लिए छवि जनरेशन और वीडियो जनरेशन देखें।

मेमोरी एम्बेडिंग और सिमेंटिक खोज

जब memory.search.provider किसी रिमोट अडैप्टर का नाम देता है (उदाहरण के लिए openai, gemini, voyage, mistral, deepinfra, github-copilot, amazon-bedrock), तब सिमेंटिक मेमोरी खोज एम्बेडिंग API का उपयोग करती है। memory.search.provider = "lmstudio" या "ollama" स्थानीय/स्वयं-होस्टेड सर्वर पर चलता है और सामान्यतः कोई होस्टेड बिलिंग नहीं होती। memory.search.provider = "local" बिना किसी API उपयोग के सब कुछ डिवाइस पर रखता है। वैकल्पिक memory.search.fallback प्रदाता स्थानीय एम्बेडिंग की विफलताओं को संभाल सकता है।

मेमोरी देखें।

वेब खोज टूल

चुने गए प्रदाता के आधार पर web_search के उपयोग पर शुल्क लग सकता है। प्रत्येक प्रदाता पहले किसी परिवेश चर से, फिर plugins.entries.<id>.config.webSearch.apiKey से अपनी कुंजी पढ़ता है:

प्रदाता	परिवेश चर
Brave Search	`BRAVE_API_KEY`
DuckDuckGo	कुंजी-मुक्त; अनौपचारिक, HTML-आधारित, कोई बिलिंग नहीं
Exa	`EXA_API_KEY`
Firecrawl	`FIRECRAWL_API_KEY`
Gemini (Google Search)	`GEMINI_API_KEY`
Grok (xAI)	xAI OAuth प्रोफ़ाइल या `XAI_API_KEY`
Kimi (Moonshot)	`KIMI_API_KEY` या `MOONSHOT_API_KEY`
MiniMax Search	`MINIMAX_CODE_PLAN_KEY`, `MINIMAX_CODING_API_KEY`, `MINIMAX_OAUTH_TOKEN`, या `MINIMAX_API_KEY`
Ollama Web Search	पहुँच योग्य साइन-इन किए हुए स्थानीय होस्ट के लिए कुंजी-मुक्त; प्रत्यक्ष `https://ollama.com` खोज `OLLAMA_API_KEY` का उपयोग करती है; प्रमाणीकरण-संरक्षित होस्ट सामान्य Ollama प्रदाता बियरर प्रमाणीकरण का पुनः उपयोग करते हैं
Parallel	`PARALLEL_API_KEY`
Perplexity Search API	`PERPLEXITY_API_KEY` या `OPENROUTER_API_KEY`
SearXNG	`SEARXNG_BASE_URL`; कुंजी-मुक्त/स्वयं-होस्टेड, कोई होस्टेड बिलिंग नहीं
Tavily	`TAVILY_API_KEY`

पुराने tools.web.search.* कॉन्फ़िगरेशन पथ अभी भी संगतता शिम के माध्यम से लोड होते हैं, लेकिन अब वे अनुशंसित इंटरफ़ेस नहीं हैं।

Brave Search का निःशुल्क क्रेडिट: प्रत्येक प्लान में हर महीने नवीनीकृत होने वाला $5 का निःशुल्क क्रेडिट शामिल है। Search प्लान की लागत प्रति 1,000 अनुरोध $5 है, इसलिए क्रेडिट प्रति माह 1,000 अनुरोधों को बिना शुल्क के कवर करता है। अप्रत्याशित शुल्क से बचने के लिए Brave डैशबोर्ड में उपयोग सीमा सेट करें।

वेब टूल देखें।

वेब फ़ेच टूल (Firecrawl)

web_fetch कुंजी-रहित शुरुआती पहुँच के साथ Firecrawl को कॉल कर सकता है; अधिक सीमाओं के लिए FIRECRAWL_API_KEY (या plugins.entries.firecrawl.config.webFetch.apiKey) जोड़ें। यदि Firecrawl कॉन्फ़िगर नहीं है, तो टूल प्रत्यक्ष फ़ेच और बंडल किए गए web-readability Plugin (कोई सशुल्क API नहीं) का उपयोग करता है। स्थानीय Readability निष्कर्षण छोड़ने के लिए plugins.entries.web-readability.enabled अक्षम करें।

वेब टूल देखें।

प्रदाता उपयोग स्नैपशॉट (स्थिति/स्वास्थ्य)

openclaw status --usage और openclaw models status --json कोटा अवधि या प्रमाणीकरण की स्थिति दिखाने के लिए प्रदाता के उपयोग एंडपॉइंट को कॉल करते हैं। कॉल की संख्या कम होती है, लेकिन वे फिर भी प्रदाता API तक पहुँचते हैं।

मॉडल CLI देखें।

Compaction सुरक्षा सारांशीकरण

Compaction सुरक्षा सत्र इतिहास को वर्तमान मॉडल का उपयोग करके सारांशित कर सकती है, जिससे उसके चलने पर प्रदाता API का आह्वान होता है।

सत्र प्रबंधन और Compaction देखें।

मॉडल स्कैन / जाँच

openclaw models scan OpenRouter मॉडल की जाँच कर सकता है और जाँच सक्षम होने पर OPENROUTER_API_KEY का उपयोग करता है।

मॉडल CLI देखें।

बातचीत (वाक्)

कॉन्फ़िगर होने पर बातचीत मोड ElevenLabs का आह्वान कर सकता है: ELEVENLABS_API_KEY या talk.providers.elevenlabs.apiKey।

बातचीत मोड देखें।

Skills (तृतीय-पक्ष API)

Skills, apiKey को skills.entries.<name>.apiKey में संग्रहीत कर सकती हैं। यदि कोई स्किल बाहरी API के लिए उस कुंजी का उपयोग करती है, तो लागत उस स्किल के प्रदाता के अनुसार होती है।

Skills देखें।