Skip to main content

मॉडल फ़ेलओवर

प्रमाणीकरण प्रोफ़ाइल रोटेशन, कूलडाउन और फ़ॉलबैक के साथ उनकी अंतःक्रिया।

मॉडल प्रदाता

प्रदाताओं का संक्षिप्त अवलोकन और उदाहरण।

मॉडल CLI संदर्भ

संपूर्ण openclaw models कमांड और फ़्लैग संदर्भ।

कॉन्फ़िगरेशन संदर्भ

मॉडल कॉन्फ़िगरेशन कुंजियाँ, डिफ़ॉल्ट और उदाहरण।
एक मॉडल रेफ़रेंस (provider/model) किसी प्रदाता और मॉडल को चुनता है, निम्न-स्तरीय एजेंट रनटाइम को नहीं। रनटाइम नीति सेट न होने या auto होने पर, OpenAI की प्रदाता-स्वामित्व वाली रूट नीति Codex को केवल बिना किसी उपयोगकर्ता-निर्धारित अनुरोध ओवरराइड वाले सटीक आधिकारिक HTTPS Platform Responses या ChatGPT Responses रूट के लिए चुन सकती है; केवल openai/* प्रीफ़िक्स कभी भी Codex नहीं चुनता। Completions अडैप्टर, कस्टम एंडपॉइंट और उपयोगकर्ता-निर्धारित अनुरोध व्यवहार OpenClaw पर बने रहते हैं। प्लेनटेक्स्ट आधिकारिक HTTP एंडपॉइंट अस्वीकार किए जाते हैं। OpenAI अंतर्निहित एजेंट रनटाइम देखें। सदस्यता वाले Copilot रेफ़रेंस (github-copilot/*) को बाहरी GitHub Copilot एजेंट रनटाइम Plugin के लिए चुना जा सकता है, लेकिन वह पथ हमेशा स्पष्ट होता है (उसे auto द्वारा कभी नहीं चुना जाता)। रनटाइम ओवरराइड प्रदाता/मॉडल नीति पर होने चाहिए, पूरे एजेंट या सत्र पर नहीं। रनटाइम चयन बिलिंग निर्धारित नहीं करता: OpenAI API-कुंजी और ChatGPT/Codex सदस्यता क्रेडेंशियल अलग बने रहते हैं। एजेंट रनटाइम और GitHub Copilot एजेंट रनटाइम देखें।

चयन क्रम

1

प्राथमिक मॉडल

agents.defaults.model.primary (या साधारण स्ट्रिंग के रूप में agents.defaults.model)।
2

फ़ॉलबैक

agents.defaults.model.fallbacks, क्रम से आज़माए जाते हैं।
3

प्रमाणीकरण फ़ेलओवर

OpenClaw के अगले फ़ॉलबैक मॉडल पर जाने से पहले प्रदाता के भीतर प्रमाणीकरण-प्रोफ़ाइल रोटेशन होता है।
संबंधित मॉडल-कॉन्फ़िगरेशन सतहें:
  • agents.defaults.models उपनाम और प्रति-मॉडल सेटिंग संग्रहीत करता है। कोई प्रविष्टि जोड़ने से मॉडल ओवरराइड प्रतिबंधित नहीं होते।
  • agents.defaults.modelPolicy.allow वैकल्पिक ओवरराइड अनुमति-सूची है। सटीक रेफ़रेंस या provider/* और provider/namespace/* जैसे अंतिम प्रीफ़िक्स वाइल्डकार्ड का उपयोग करें; किसी भी मॉडल की अनुमति देने के लिए इसे छोड़ दें या [] पर सेट करें। प्रति-एजेंट agents.entries.*.modelPolicy.allow उस एजेंट की डिफ़ॉल्ट नीति को प्रतिस्थापित करता है।
  • agents.defaults.utilityModel जनरेट किए गए डैशबोर्ड सत्र शीर्षकों, समर्थित चैनल थ्रेड/विषय शीर्षकों और प्रगति वर्णन जैसे छोटे आंतरिक कार्यों के लिए वैकल्पिक कम-लागत मॉडल है। प्रति-एजेंट agents.entries.*.utilityModel इसे ओवरराइड करता है। सेट न होने पर, यदि प्राथमिक प्रदाता ने कोई छोटा-मॉडल डिफ़ॉल्ट घोषित किया है, तो OpenClaw उसका उपयोग करता है (OpenAI → gpt-5.6-luna, Anthropic → claude-haiku-4-5), अन्यथा एजेंट के प्राथमिक मॉडल का; उपयोगिता रूटिंग अक्षम करने के लिए इसे रिक्त स्ट्रिंग पर सेट करें। अलग उपयोगिता मॉडल विफल होने पर जनरेट किए गए शीर्षक प्राथमिक मॉडल के साथ एक बार फिर प्रयास करते हैं। डैशबोर्ड शीर्षकों के लिए, स्वचालित उपयोगिता व्युत्पत्ति और नियमित फ़ॉलबैक प्रभावी सत्र प्रदाता और प्रमाणीकरण प्रोफ़ाइल का अनुसरण करते हैं; स्पष्ट उपयोगिता मॉडल अपने कॉन्फ़िगर किए गए प्रदाता/प्रमाणीकरण को बनाए रखता है। रिक्त उपयोगिता मॉडल केवल वैकल्पिक छोटे-मॉडल रूट को छोड़ता है, डैशबोर्ड शीर्षक जनरेशन को नहीं। उपयोगिता कार्य अलग मॉडल कॉल होते हैं और चयनित मॉडल प्रदाता को सीमित कार्य सामग्री भेज सकते हैं।
  • agents.defaults.imageModel का उपयोग केवल तब होता है जब प्राथमिक मॉडल चित्र स्वीकार नहीं कर सकता।
  • agents.defaults.pdfModel का उपयोग pdf टूल द्वारा किया जाता है। सेट न होने पर, टूल पहले imageModel, फिर निर्धारित सत्र/डिफ़ॉल्ट मॉडल पर फ़ॉलबैक करता है।
  • agents.defaults.mediaModels.{image,music,video} साझा मीडिया-जनरेशन टूल को आधार प्रदान करता है। सेट न होने पर, प्रत्येक टूल प्रमाणीकरण-समर्थित प्रदाता डिफ़ॉल्ट निर्धारित करता है: पहले वर्तमान डिफ़ॉल्ट प्रदाता, फिर उस क्षमता के लिए शेष पंजीकृत प्रदाता, प्रदाता-ID क्रम में। अंतर-प्रदाता फ़ॉलबैक निश्चित डिफ़ॉल्ट व्यवहार है।
  • प्रति-एजेंट agents.entries.*.model (साथ ही बाइंडिंग) agents.defaults.model को ओवरराइड करता है — बहु-एजेंट रूटिंग देखें।
कुंजियों का संपूर्ण संदर्भ, डिफ़ॉल्ट और JSON5 उदाहरण: कॉन्फ़िगरेशन संदर्भ

चयन स्रोत और फ़ॉलबैक की कठोरता

वही provider/model कहाँ से आया है, इसके आधार पर अलग ढंग से व्यवहार करता है: अन्य चयन नियम:
  • agents.defaults.model.primary बदलने से मौजूदा सत्र पिन दोबारा नहीं लिखे जाते। यदि स्थिति में This session is pinned to X; config primary Y will apply to new/unpinned sessions. दिखता है, तो पिन हटाने के लिए /model default चलाएँ।
  • CLI डिफ़ॉल्ट-मॉडल और अनुमति-सूची पिकर संपूर्ण अंतर्निहित कैटलॉग के बजाय केवल models.providers.*.models सूचीबद्ध करके models.mode: "replace" का पालन करते हैं।
  • Control UI मॉडल पिकर Gateway से उसका कॉन्फ़िगर किया गया मॉडल दृश्य माँगता है। स्पष्ट modelPolicy.allow इसे फ़िल्टर करता है, जिसमें अंतिम प्रीफ़िक्स वाइल्डकार्ड प्रविष्टियाँ भी शामिल हैं; अन्यथा यह कॉन्फ़िगर किए गए मॉडल और उपयोग योग्य प्रमाणीकरण वाले प्रदाता दिखाता है। संपूर्ण अंतर्निहित कैटलॉग स्पष्ट ब्राउज़ दृश्यों (models.list के साथ view: "all", या openclaw models list --all) के लिए आरक्षित है।
  • प्रदाता इन्वेंट्री UI, पिकर अनुमति-सूचियाँ लागू किए बिना स्रोत-निर्धारित models.providers.*.models पंक्तियाँ दिखाने के लिए view: "provider-config" के साथ models.list का उपयोग करते हैं।
संपूर्ण कार्यप्रणाली: मॉडल फ़ेलओवर

त्वरित मॉडल नीति

  • अपने प्राथमिक मॉडल को आपके लिए उपलब्ध नवीनतम पीढ़ी के सबसे सक्षम मॉडल पर सेट करें।
  • लागत/विलंबता-संवेदी कार्यों और कम-महत्त्वपूर्ण चैट के लिए फ़ॉलबैक का उपयोग करें।
  • टूल-सक्षम एजेंट या अविश्वसनीय इनपुट के लिए पुराने/कमज़ोर मॉडल स्तरों से बचें।

आरंभिक सेटअप

OpenAI Codex सदस्यता OAuth और Anthropic (API कुंजी या Claude CLI का पुनः उपयोग) सहित सामान्य प्रदाताओं के लिए कॉन्फ़िगरेशन को हाथ से संपादित किए बिना मॉडल और प्रमाणीकरण सेट करता है। कोई प्राथमिक मॉडल कॉन्फ़िगर न होने पर, नया OpenAI API-कुंजी सेटअप openai/gpt-5.6 चुनता है; साधारण प्रत्यक्ष-API ID Sol स्तर में निर्धारित होती है। नया ChatGPT/Codex OAuth सेटअप सटीक openai/gpt-5.6-sol कैटलॉग रेफ़रेंस चुनता है। पुनः प्रमाणीकरण मौजूदा स्पष्ट प्राथमिक मॉडल को बनाए रखता है, जिसमें openai/gpt-5.5 भी शामिल है। यदि GPT-5.6 खाते के लिए उपलब्ध नहीं है, तो openai/gpt-5.5 को स्पष्ट रूप से चुनें; OpenClaw इसे चुपचाप निम्न स्तर पर नहीं ले जाता।

“मॉडल की अनुमति नहीं है” (और उत्तर क्यों रुक जाते हैं)

यदि agents.defaults.modelPolicy.allow रिक्त नहीं है, तो यह /model, सत्र ओवरराइड और --model के लिए अनुमति-सूची बन जाता है। उस अनुमति-सूची से बाहर का मॉडल चुनने पर कोई सामान्य उत्तर जनरेट होने से पहले ही प्रक्रिया लौट जाती है। प्रति-एजेंट agents.entries.*.modelPolicy.allow उस एजेंट की डिफ़ॉल्ट नीति को प्रतिस्थापित करता है।
नामित modelPolicy.allow कुंजी में मॉडल या प्रदाता वाइल्डकार्ड जोड़कर, उस सूची को हटाकर/रिक्त करके या /model list से कोई मॉडल चुनकर इसे ठीक करें। यदि अस्वीकृत कमांड में /model openai/gpt-5.5 --runtime codex जैसा रनटाइम ओवरराइड शामिल था, तो पहले अनुमति-सूची ठीक करें, फिर वही कमांड दोबारा आज़माएँ। स्थानीय/GGUF मॉडल के लिए, अनुमति-सूची में पूर्ण प्रदाता-प्रीफ़िक्स वाला रेफ़रेंस चाहिए, उदाहरण के लिए ollama/gemma4:26b या lmstudio/Gemma4-26b-a4-it-gguf — सटीक स्ट्रिंग के लिए openclaw models list --provider <provider> जाँचें। अनुमति-सूची सक्रिय होने के बाद केवल फ़ाइलनाम या प्रदर्शित नाम पर्याप्त नहीं हैं। प्रत्येक मॉडल सूचीबद्ध किए बिना प्रदाताओं को सीमित करने के लिए अंतिम प्रीफ़िक्स वाइल्डकार्ड प्रविष्टियों का उपयोग करें। प्रदाता-व्यापी provider/* उस प्रदाता के अंतर्गत प्रत्येक मॉडल से मेल खाता है; clawrouter/anthropic/* जैसा अधिक सीमित प्रीफ़िक्स केवल उस नेमस्पेस से मेल खाता है:
इसके बाद /model, /models और मॉडल पिकर केवल उन प्रदाताओं का खोजा गया कैटलॉग दिखाते हैं, और अनुमति-सूची संपादित किए बिना नए मॉडल दिखाई दे सकते हैं। किसी अन्य प्रदाता से एक विशिष्ट मॉडल शामिल करने के लिए सटीक provider/model प्रविष्टियों को provider/* प्रविष्टियों के साथ मिलाएँ। उपनामों और प्रति-मॉडल सेटिंग वाली उदाहरण अनुमति-सूची:
संपूर्ण सूची सीधे सेट करें:
openclaw models set, प्रदाता सेटअप और openclaw models aliases add, agents.defaults.models के अंतर्गत प्रविष्टियाँ जोड़ सकते हैं, लेकिन वे modelPolicy.allow को कभी नहीं बदलते। इससे मॉडल मेटाडेटा और उपनाम ओवरराइड नीति से स्वतंत्र रहते हैं।

चैट में /model

  • /model और /model list एक संक्षिप्त क्रमांकित चयनकर्ता (मॉडल परिवार + उपलब्ध प्रदाता) दिखाते हैं; /model <#> उसमें से चयन करता है। Discord पर यह Submit चरण के साथ प्रदाता/मॉडल ड्रॉपडाउन खोलता है; Telegram पर, चयनकर्ता के विकल्प सत्र-सीमित होते हैं और openclaw.json में एजेंट के स्थायी डिफ़ॉल्ट को कभी दोबारा नहीं लिखते। /models add अप्रचलित है और चैट से मॉडल पंजीकृत करने के बजाय एक संदेश लौटाता है।
  • /model नए सत्र चयन को तुरंत सहेजता है। यदि एजेंट निष्क्रिय है, तो अगला रन तुरंत इसका उपयोग करता है; यदि कोई रन पहले से सक्रिय है, तो स्विच को अगले स्वच्छ पुनः-प्रयास बिंदु के लिए कतारबद्ध किया जाता है (या किसी बाद के बिंदु के लिए, यदि टूल गतिविधि या उत्तर आउटपुट पहले ही शुरू हो चुका हो)।
  • /model default सत्र चयन को साफ़ करता है ताकि यह फिर से कॉन्फ़िगर किए गए प्राथमिक विकल्प को प्राप्त करे।
  • उपयोगकर्ता द्वारा चयनित /model रेफ़ उस सत्र के लिए सख्त होता है: यदि वह पहुँच से बाहर हो जाता है, तो उत्तर agents.defaults.model.fallbacks के माध्यम से चुपचाप फ़ॉलबैक करने के बजाय स्पष्ट रूप से विफल होता है। कॉन्फ़िगर किए गए डिफ़ॉल्ट और Cron जॉब के प्राथमिक विकल्प अब भी फ़ॉलबैक शृंखलाओं का उपयोग करते हैं।
  • /model status विस्तृत दृश्य है: प्रत्येक प्रदाता के प्रमाणीकरण उम्मीदवार और (कॉन्फ़िगर होने पर) प्रदाता एंडपॉइंट baseUrl तथा api मोड।
  • मॉडल रेफ़ को पहले / पर विभाजित करके पार्स किया जाता है; provider/model टाइप करें। यदि मॉडल ID में स्वयं / शामिल है (OpenRouter-शैली), तो प्रदाता उपसर्ग शामिल करें, उदाहरण के लिए /model openrouter/moonshotai/kimi-k2। यदि आप प्रदाता को छोड़ देते हैं, तो OpenClaw यह प्रयास करता है: (1) उपनाम मिलान, (2) ठीक उसी उपसर्ग-रहित मॉडल ID के लिए अद्वितीय कॉन्फ़िगर-प्रदाता मिलान, (3) कॉन्फ़िगर किया गया डिफ़ॉल्ट प्रदाता (अप्रचलित फ़ॉलबैक) — और यदि वह प्रदाता अब कॉन्फ़िगर किए गए डिफ़ॉल्ट मॉडल को उपलब्ध नहीं कराता, तो उसके बजाय पहला कॉन्फ़िगर किया गया प्रदाता/मॉडल, ताकि हटाए जा चुके प्रदाता का पुराना डिफ़ॉल्ट सामने न आए।
  • मॉडल रेफ़ को लोअरकेस में सामान्यीकृत किया जाता है; अन्यथा प्रदाता ID हूबहू होते हैं, इसलिए Plugin द्वारा प्रदर्शित ID का उपयोग करें।
कमांड का पूरा व्यवहार और कॉन्फ़िगरेशन: स्लैश कमांड

CLI

बिना उपकमांड वाला openclaw models, models status का शॉर्टकट है, जो प्रमाणीकरण-स्टोर प्रोफ़ाइल के लिए OAuth समाप्ति भी दिखाता है (डिफ़ॉल्ट रूप से 24h के भीतर चेतावनी देता है)। सभी फ़्लैग, JSON आकार और प्रमाणीकरण-प्रोफ़ाइल उपकमांड: मॉडल CLI संदर्भ
openclaw models scan OpenRouter के सार्वजनिक निःशुल्क-मॉडल कैटलॉग का निरीक्षण करता है और टूल तथा इमेज समर्थन के लिए उम्मीदवारों की लाइव जाँच कर सकता है। कैटलॉग स्वयं सार्वजनिक है, इसलिए केवल-मेटाडेटा स्कैन (--no-probe) के लिए किसी कुंजी की आवश्यकता नहीं होती; लाइव जाँच और --set-default/--set-image के लिए OpenRouter API कुंजी (प्रमाणीकरण प्रोफ़ाइल या OPENROUTER_API_KEY) आवश्यक है और इसके बिना आउटपुट केवल-मेटाडेटा तक सीमित रखते हुए सुरक्षित रूप से विफल होता है।परिणामों की रैंकिंग इस क्रम में होती है: इमेज समर्थन, फिर टूल विलंबता, फिर संदर्भ आकार, फिर पैरामीटर संख्या। TTY में, जाँचे गए परिणाम इंटरैक्टिव फ़ॉलबैक चयन का संकेत देते हैं; गैर-इंटरैक्टिव मोड में डिफ़ॉल्ट स्वीकार करने के लिए --yes आवश्यक है।

मॉडल रजिस्ट्री (models.json)

models.providers के अंतर्गत कॉन्फ़िगर किए गए कस्टम प्रदाताओं को एजेंट डायरेक्टरी (डिफ़ॉल्ट ~/.openclaw/agents/<agentId>/agent/models.json) के अंतर्गत models.json में लिखा जाता है। प्रदाता-Plugin कैटलॉग अलग से जनरेट किए गए Plugin-स्वामित्व वाले कैटलॉग शार्ड के रूप में संग्रहित होते हैं और स्वचालित रूप से लोड होते हैं। डिफ़ॉल्ट रूप से यह फ़ाइल कॉन्फ़िगरेशन के साथ मर्ज होती है; केवल अपने कॉन्फ़िगर किए गए प्रदाताओं का उपयोग करने के लिए models.mode: "replace" सेट करें।
मेल खाने वाली प्रदाता ID के लिए:
  • एजेंट models.json में पहले से उपस्थित गैर-रिक्त baseUrl को प्राथमिकता मिलती है।
  • models.json में गैर-रिक्त apiKey को केवल तभी प्राथमिकता मिलती है, जब वह प्रदाता वर्तमान कॉन्फ़िगरेशन/प्रमाणीकरण-प्रोफ़ाइल संदर्भ में SecretRef द्वारा प्रबंधित न हो।
  • SecretRef द्वारा प्रबंधित apiKey मान समाधान किए गए सीक्रेट सहेजने के बजाय स्रोत मार्कर से रीफ़्रेश होते हैं: env रेफ़ के लिए env वेरिएबल का नाम, और फ़ाइल/exec रेफ़ के लिए secretref-managed
  • SecretRef द्वारा प्रबंधित हेडर मान भी इसी तरह रीफ़्रेश होते हैं और env रेफ़ के लिए secretref-env:ENV_VAR_NAME का उपयोग करते हैं।
  • models.json में रिक्त या अनुपस्थित apiKey/baseUrl, कॉन्फ़िगरेशन models.providers पर फ़ॉलबैक करते हैं।
  • अन्य प्रदाता फ़ील्ड कॉन्फ़िगरेशन और सामान्यीकृत कैटलॉग डेटा से रीफ़्रेश होते हैं।
मार्कर स्थायित्व में स्रोत प्रामाणिक होता है: जब भी OpenClaw models.json को दोबारा जनरेट करता है—जिसमें openclaw agent जैसे कमांड-संचालित पथ भी शामिल हैं—वह समाधान किए गए रनटाइम सीक्रेट मानों के बजाय सक्रिय स्रोत कॉन्फ़िगरेशन स्नैपशॉट (समाधान-पूर्व) से मार्कर लिखता है।

संबंधित