Skip to main content
मॉडल और ऑथ-प्रोफ़ाइल से जुड़े प्रश्नोत्तर। सेटअप, सत्रों, Gateway, चैनलों और समस्या निवारण के लिए मुख्य अक्सर पूछे जाने वाले प्रश्न देखें।

मॉडल: डिफ़ॉल्ट, चयन, उपनाम, स्विच करना

इसे इससे सेट करें:
मॉडल provider/model संदर्भ होते हैं (उदाहरण: openai/gpt-5.5, anthropic/claude-sonnet-4-6)। हमेशा provider/model को स्पष्ट रूप से सेट करें। यदि आप प्रदाता को छोड़ देते हैं, तो OpenClaw पहले उपनाम मिलान आज़माता है, फिर उस मॉडल आईडी के लिए विशिष्ट कॉन्फ़िगर किए गए प्रदाता का मिलान करता है, और फिर कॉन्फ़िगर किए गए डिफ़ॉल्ट प्रदाता पर वापस जाता है (अप्रचलित संगतता पथ)। यदि उस प्रदाता के पास अब कॉन्फ़िगर किया गया डिफ़ॉल्ट मॉडल नहीं है, तो OpenClaw पुराने डिफ़ॉल्ट के बजाय पहले कॉन्फ़िगर किए गए प्रदाता/मॉडल पर वापस जाता है।
आपके प्रदाता स्टैक द्वारा उपलब्ध कराया गया नवीनतम पीढ़ी का सबसे शक्तिशाली मॉडल उपयोग करें, विशेष रूप से टूल-सक्षम या अविश्वसनीय इनपुट वाले एजेंटों के लिए — कमजोर या अत्यधिक क्वांटाइज़ किए गए मॉडल प्रॉम्प्ट इंजेक्शन और असुरक्षित व्यवहार के प्रति अधिक संवेदनशील होते हैं (सुरक्षा देखें)। एजेंट की भूमिका के अनुसार नियमित/कम-जोखिम वाली चैट के लिए कम लागत वाले मॉडल रूट करें।मॉडल को प्रत्येक एजेंट के अनुसार रूट करें और लंबे कार्यों को समानांतर करने के लिए उप-एजेंटों का उपयोग करें (प्रत्येक उप-एजेंट अपने स्वयं के टोकन उपयोग करता है)। मॉडल, उप-एजेंट, MiniMax, और स्थानीय मॉडल देखें।
केवल मॉडल फ़ील्ड बदलें — पूरी कॉन्फ़िग को प्रतिस्थापित करने से बचें।
  • चैट में /model (प्रति सत्र, स्लैश कमांड देखें)
  • openclaw models set ... (केवल मॉडल कॉन्फ़िग अपडेट करता है)
  • openclaw configure --section model (इंटरैक्टिव)
  • ~/.openclaw/openclaw.json में सीधे agents.defaults.model संपादित करें
RPC संपादनों के लिए, पहले config.schema.lookup से निरीक्षण करें (सामान्यीकृत पथ, संक्षिप्त स्कीमा दस्तावेज़, चाइल्ड सारांश), फिर आंशिक ऑब्जेक्ट के साथ config.apply के बजाय config.patch को प्राथमिकता दें। यदि आपने कॉन्फ़िग ओवरराइट कर दी है, तो बैकअप से पुनर्स्थापित करें या सुधार के लिए openclaw doctor चलाएँ।दस्तावेज़: मॉडल, कॉन्फ़िगर करें, कॉन्फ़िग, Doctor
हाँ — Ollama सबसे आसान तरीका है। त्वरित सेटअप:
  1. https://ollama.com/download से Ollama इंस्टॉल करें
  2. कोई स्थानीय मॉडल पुल करें, जैसे ollama pull gemma4
  3. क्लाउड मॉडल के लिए भी ollama signin चलाएँ
  4. openclaw onboard चलाएँ, Ollama चुनें, फिर Local या Cloud + Local
Cloud + Local आपको क्लाउड मॉडल के साथ आपके स्थानीय Ollama मॉडल भी देता है; kimi-k2.5:cloud जैसे क्लाउड मॉडल के लिए स्थानीय पुल आवश्यक नहीं है। मैन्युअल रूप से स्विच करने के लिए: openclaw models list, फिर openclaw models set ollama/<model>छोटे/अत्यधिक क्वांटाइज़ किए गए मॉडल प्रॉम्प्ट इंजेक्शन के प्रति अधिक संवेदनशील होते हैं। टूल एक्सेस वाले किसी भी बॉट के लिए बड़े मॉडल उपयोग करें; यदि फिर भी छोटे मॉडल उपयोग करते हैं, तो सैंडबॉक्सिंग और सख्त टूल अनुमतिसूचियाँ सक्षम करें।दस्तावेज़: Ollama, स्थानीय मॉडल, मॉडल प्रदाता, सुरक्षा, सैंडबॉक्सिंग
/model <name> को एक स्वतंत्र संदेश के रूप में भेजें। संपूर्ण कमांड सूची के लिए स्लैश कमांड देखें, जिसमें क्रमांकित चयनकर्ता (/model, /model list, /model 3), सत्र ओवरराइड हटाने के लिए /model default, और एंडपॉइंट/API-मोड विवरण के लिए /model status शामिल हैं।@profile से प्रति सत्र कोई विशिष्ट ऑथ प्रोफ़ाइल अनिवार्य करें:
@profile से सेट प्रोफ़ाइल को अनपिन करने के लिए, प्रत्यय के बिना /model फिर से चलाएँ (जैसे /model anthropic/claude-opus-4-6), या /model से डिफ़ॉल्ट चुनें। सक्रिय ऑथ प्रोफ़ाइल की पुष्टि के लिए /model status उपयोग करें।
/model provider/model ठीक उसी प्रदाता रूट को चुनता है। उदाहरण के लिए, मॉडल आईडी समान होने के बावजूद qianfan/deepseek-v4-flash और deepseek/deepseek-v4-flash अलग संदर्भ हैं — केवल आईडी मिलान होने पर OpenClaw चुपचाप प्रदाता नहीं बदलता।उपयोगकर्ता द्वारा चयनित /model संदर्भ फ़ॉलबैक के लिए सख्त होता है: यदि वह प्रदाता/मॉडल अनुपलब्ध हो जाता है, तो उत्तर agents.defaults.model.fallbacks पर वापस जाने के बजाय स्पष्ट रूप से विफल होता है। कॉन्फ़िगर की गई फ़ॉलबैक शृंखलाएँ अभी भी कॉन्फ़िगर किए गए डिफ़ॉल्ट, Cron जॉब के प्राथमिक मॉडल और स्वचालित रूप से चयनित फ़ॉलबैक स्थिति पर लागू होती हैं। जब बिना सत्र ओवरराइड वाले रन को फ़ॉलबैक उपयोग करने की अनुमति होती है, तो OpenClaw पहले अनुरोधित प्रदाता/मॉडल, फिर कॉन्फ़िगर किए गए फ़ॉलबैक और उसके बाद कॉन्फ़िगर किया गया प्राथमिक मॉडल आज़माता है — इसलिए एक जैसे केवल मॉडल आईडी कभी भी सीधे डिफ़ॉल्ट प्रदाता पर वापस नहीं जाते।मॉडल और मॉडल फ़ेलओवर देखें।
हाँ — मॉडल का चयन और रनटाइम का चयन अलग-अलग हैं:
  • मूल Codex कोडिंग एजेंट: agents.defaults.model.primary को openai/gpt-5.5 पर सेट करें। ChatGPT/Codex सदस्यता ऑथ के लिए openclaw models auth login --provider openai से साइन इन करें।
  • एजेंट लूप के बाहर सीधे OpenAI API कार्य: इमेज, एम्बेडिंग, स्पीच, रीयलटाइम और अन्य गैर-एजेंट OpenAI API सतहों के लिए OPENAI_API_KEY कॉन्फ़िगर करें।
  • OpenAI एजेंट API-कुंजी ऑथ: क्रमबद्ध openai API-कुंजी प्रोफ़ाइल के साथ /model openai/gpt-5.5
  • उप-एजेंट: कोडिंग कार्यों को अपने openai/gpt-5.5 मॉडल वाले Codex-केंद्रित एजेंट पर रूट करें।
मॉडल और स्लैश कमांड देखें।
  • प्रति सत्र: openai/gpt-5.5 का उपयोग करते समय /fast on भेजें।
  • प्रति मॉडल डिफ़ॉल्ट: agents.defaults.models["openai/gpt-5.5"].params.fastMode को true पर सेट करें।
  • स्वचालित कटऑफ़: /fast auto या params.fastMode: "auto" नए मॉडल कॉल को कटऑफ़ तक तेज़ी से चलाता है, फिर बाद के पुनः प्रयास, फ़ॉलबैक, टूल-परिणाम या निरंतरता कॉल को फ़ास्ट मोड के बिना चलाता है। कटऑफ़ का डिफ़ॉल्ट 60 सेकंड है; मॉडल पर params.fastAutoOnSeconds से इसे ओवरराइड करें।
फ़ास्ट मोड मूल OpenAI Responses अनुरोधों पर service_tier = "priority" से मैप होता है; मौजूदा service_tier मान संरक्षित रहते हैं और फ़ास्ट मोड reasoning या text.verbosity को फिर से नहीं लिखता। सत्र /fast ओवरराइड कॉन्फ़िग डिफ़ॉल्ट पर प्राथमिकता लेते हैं।सोच और फ़ास्ट मोड तथा OpenAI प्रदाता पृष्ठ पर उन्नत कॉन्फ़िगरेशन के अंतर्गत फ़ास्ट मोड अनुभाग देखें।
यदि agents.defaults.modelPolicy.allow खाली नहीं है, तो यह /model, सत्र ओवरराइड और --model के लिए अनुमतिसूची बन जाता है। उस सूची के बाहर का मॉडल चुनने पर सामान्य उत्तर के बजाय यह लौटता है:
समाधान: सटीक मॉडल या "provider/*" जैसा प्रदाता वाइल्डकार्ड नामित modelPolicy.allow सूची में जोड़ें, उस सूची को हटाएँ/खाली करें, या /model list से कोई मॉडल चुनें। यदि कमांड में --runtime codex भी शामिल था, तो पहले अनुमतिसूची अपडेट करें, फिर वही /model provider/model --runtime codex कमांड दोबारा आज़माएँ।
यदि आप OpenClaw की किसी पुरानी रिलीज़ पर हैं, तो पहले अपग्रेड करें (या स्रोत से main चलाएँ) और Gateway पुनः आरंभ करें — हो सकता है MiniMax-M3 अभी आपकी इंस्टॉल की गई रिलीज़ के कैटलॉग में न हो। अन्यथा MiniMax प्रदाता कॉन्फ़िगर नहीं है (कोई प्रदाता प्रविष्टि या ऑथ प्रोफ़ाइल नहीं मिली), इसलिए मॉडल रिज़ॉल्व नहीं हो सकता। समाधान की पूरी जाँचसूची, प्रदाता/मॉडल आईडी तालिका और कॉन्फ़िग-ब्लॉक उदाहरण के लिए MiniMax प्रदाता पृष्ठ का समस्या निवारण अनुभाग देखें।
हाँ। MiniMax को डिफ़ॉल्ट बनाएँ और प्रत्येक सत्र के अनुसार मॉडल बदलें — फ़ॉलबैक त्रुटियों के लिए हैं, “कठिन कार्यों” के लिए नहीं, इसलिए /model या अलग एजेंट उपयोग करें।विकल्प A: प्रति सत्र स्विच करें
फिर /model gptविकल्प B: अलग एजेंट — एजेंट A का डिफ़ॉल्ट MiniMax और एजेंट B का डिफ़ॉल्ट OpenAI हो; एजेंट के अनुसार रूट करें या स्विच करने के लिए /agent उपयोग करें।दस्तावेज़: मॉडल, बहु-एजेंट रूटिंग, MiniMax, OpenAI
हाँ — अंतर्निहित संक्षिप्त नाम, जो केवल तब लागू होते हैं जब लक्ष्य मॉडल agents.defaults.models में मौजूद हो:समान नाम वाला आपका अपना उपनाम अंतर्निहित उपनाम को ओवरराइड करता है।
उपनाम agents.defaults.models.<modelId>.alias पर स्थित होते हैं:
फिर /model sonnet (या समर्थित होने पर /<alias>) उस मॉडल आईडी पर रिज़ॉल्व होता है।
OpenRouter (प्रति-टोकन भुगतान; अनेक मॉडल):
Z.AI (GLM मॉडल):
संदर्भित प्रदाता/मॉडल के लिए प्रदाता कुंजी न होने पर रनटाइम ऑथ त्रुटि उत्पन्न होती है (जैसे No API key found for provider "zai")।नया एजेंट जोड़ने के बाद प्रदाता के लिए कोई API कुंजी नहीं मिलीनए एजेंट का ऑथ स्टोर खाली होता है — ऑथ प्रत्येक एजेंट के अनुसार होता है और यहाँ संग्रहीत है:
सुधार: openclaw agents add <id> चलाएँ और विज़ार्ड में प्रमाणीकरण कॉन्फ़िगर करें, या मुख्य एजेंट के स्टोर से केवल पोर्टेबल स्थिर api_key/token प्रोफ़ाइल कॉपी करें। OAuth के लिए, जब नए एजेंट को अपने खाते की आवश्यकता हो, तो उससे साइन इन करें। agentDir के पूर्ण पुनः उपयोग और क्रेडेंशियल-साझाकरण नियमों के लिए मल्टी-एजेंट रूटिंग देखें — एजेंटों के बीच agentDir का कभी पुनः उपयोग न करें।

मॉडल फ़ेलओवर और “सभी मॉडल विफल रहे”

दो चरण:
  1. एक ही प्रदाता के भीतर प्रमाणीकरण प्रोफ़ाइल रोटेशन
  2. agents.defaults.model.fallbacks में अगले मॉडल पर मॉडल फ़ॉलबैक
विफल प्रोफ़ाइल पर कूलडाउन लागू होते हैं (एक्सपोनेंशियल बैकऑफ़), इसलिए प्रदाता के रेट-लिमिट होने या अस्थायी रूप से विफल होने पर भी OpenClaw उत्तर देता रहता है।रेट-लिमिट बकेट में केवल साधारण 429 से अधिक शामिल है: Too many concurrent requests, ThrottlingException, concurrency limit reached, workers_ai ... quota limit exceeded, resource exhausted, और आवधिक उपयोग-विंडो सीमाएँ (weekly/monthly limit reached) सभी को फ़ेलओवर योग्य रेट लिमिट माना जाता है।बिलिंग प्रतिक्रियाएँ हमेशा 402 नहीं होतीं, और कुछ 402 अस्थायी/रेट-लिमिट बकेट में ही रहते हैं, बिलिंग लेन में नहीं। 401/403 पर स्पष्ट बिलिंग टेक्स्ट फिर भी बिलिंग की ओर रूट कर सकता है; प्रदाता-विशिष्ट टेक्स्ट मिलानकर्ता (जैसे OpenRouter Key limit exceeded) अपने प्रदाता तक ही सीमित रहते हैं। ऐसा 402 जो पुनः प्रयास योग्य उपयोग-विंडो या संगठन/वर्कस्पेस खर्च सीमा (daily limit reached, resets tomorrow, organization spending limit exceeded) जैसा दिखाई देता है, उसे लंबी बिलिंग निष्क्रियता के बजाय rate_limit माना जाता है।संदर्भ-ओवरफ़्लो त्रुटियाँ फ़ॉलबैक पथ से पूरी तरह बाहर रहती हैं — request_too_large, input exceeds the maximum number of tokens, input token count exceeds the maximum number of input tokens, input is too long for the model, या ollama error: context length exceeded जैसे सिग्नेचर मॉडल फ़ॉलबैक को आगे बढ़ाने के बजाय Compaction/पुनः प्रयास में जाते हैं।सामान्य सर्वर-त्रुटि टेक्स्ट का दायरा “जिसमें भी unknown/error हो” उससे संकरा है। प्रदाता-सीमित अस्थायी स्वरूप जिन्हें फ़ेलओवर संकेत माना जाता है: Anthropic का केवल An unknown error occurred, OpenRouter का केवल Provider returned error, Unhandled stop reason: error जैसी स्टॉप-रीज़न त्रुटियाँ, अस्थायी सर्वर टेक्स्ट (internal server error, unknown error, 520, upstream error, backend error) वाले JSON api_error पेलोड, और प्रदाता संदर्भ मेल खाने पर ModelNotReadyException जैसी प्रदाता-व्यस्त त्रुटियाँ। LLM request failed with an unknown error. जैसा सामान्य आंतरिक फ़ॉलबैक टेक्स्ट सतर्क रहता है और अपने आप फ़ॉलबैक ट्रिगर नहीं करता।
प्रमाणीकरण प्रोफ़ाइल आईडी anthropic:default के लिए अपेक्षित प्रमाणीकरण स्टोर में कोई क्रेडेंशियल नहीं है।सुधार जाँच-सूची:
  • पुष्टि करें कि प्रोफ़ाइल कहाँ रहती हैं — वर्तमान: ~/.openclaw/agents/<agentId>/agent/auth-profiles.json; पुराना: ~/.openclaw/agent/* (openclaw doctor द्वारा माइग्रेट किया गया)।
  • पुष्टि करें कि Gateway आपका एनवायरनमेंट वेरिएबल लोड करता है। केवल आपके शेल में सेट ANTHROPIC_API_KEY, systemd/launchd के माध्यम से चलने वाले Gateway तक नहीं पहुँचेगा — इसे ~/.openclaw/.env में रखें या env.shellEnv सक्षम करें।
  • पुष्टि करें कि आप सही एजेंट को संपादित कर रहे हैं — मल्टी-एजेंट सेटअप में कई auth-profiles.json फ़ाइलें होती हैं।
  • कॉन्फ़िगर किए गए मॉडल और प्रदाता की प्रमाणीकरण स्थिति देखने के लिए openclaw models status चलाएँ।
“प्रोफ़ाइल anthropic के लिए कोई क्रेडेंशियल नहीं मिला” (ईमेल प्रत्यय के बिना) के लिए:रन ऐसी Anthropic प्रोफ़ाइल पर पिन है जिसे Gateway नहीं ढूँढ़ पा रहा।
  • Claude CLI का उपयोग करें: Gateway होस्ट पर openclaw models auth login --provider anthropic --method cli --set-default चलाएँ।
  • इसके बजाय API कुंजी को प्राथमिकता दें: Gateway होस्ट पर ~/.openclaw/.env में ANTHROPIC_API_KEY रखें, फिर गुम प्रोफ़ाइल को बाध्य करने वाला कोई भी पिन किया हुआ क्रम हटाएँ:
  • रिमोट मोड: प्रमाणीकरण प्रोफ़ाइल आपके लैपटॉप पर नहीं, Gateway मशीन पर रहती हैं — पुष्टि करें कि आप वहीं कमांड चला रहे हैं।
यदि आपके मॉडल कॉन्फ़िगरेशन में Google Gemini फ़ॉलबैक के रूप में शामिल है (या आपने Gemini शॉर्टहैंड पर स्विच किया है), तो OpenClaw फ़ॉलबैक के दौरान उसे आज़माता है। Google क्रेडेंशियल कॉन्फ़िगर न होने पर No API key found for provider "google" मिलता है। सुधार: Google प्रमाणीकरण जोड़ें, या agents.defaults.model.fallbacks/उपनामों से Google मॉडल हटाएँ।LLM अनुरोध अस्वीकृत: थिंकिंग सिग्नेचर आवश्यक है (Google Antigravity)कारण: सत्र इतिहास में बिना सिग्नेचर वाले थिंकिंग ब्लॉक हैं (अक्सर निरस्त/आंशिक स्ट्रीम से); Google Antigravity को थिंकिंग ब्लॉक पर सिग्नेचर आवश्यक होते हैं। OpenClaw, Google Antigravity Claude के लिए बिना सिग्नेचर वाले थिंकिंग ब्लॉक हटा देता है; यदि यह फिर भी दिखाई दे, तो नया सत्र शुरू करें या उस एजेंट के लिए /thinking off सेट करें।

प्रमाणीकरण प्रोफ़ाइल: वे क्या हैं और उन्हें कैसे प्रबंधित करें

संबंधित: /concepts/oauth (OAuth प्रवाह, टोकन भंडारण, एकाधिक-खाता पैटर्न)
किसी प्रदाता से जुड़ा नामित क्रेडेंशियल रिकॉर्ड (OAuth या API कुंजी), जिसे यहाँ संग्रहीत किया जाता है:
सीक्रेट प्रकट किए बिना सहेजी गई प्रोफ़ाइल की जाँच करें: openclaw models auth list (वैकल्पिक रूप से --provider <id> या --json)। मॉडल CLI देखें।
प्रदाता-उपसर्ग वाली: anthropic:default (जब ईमेल पहचान मौजूद न हो तब सामान्य), OAuth पहचानों के लिए anthropic:<email>, या आपकी चुनी हुई कस्टम आईडी (जैसे anthropic:work)।
हाँ। auth.order.<provider> कॉन्फ़िगरेशन प्रत्येक प्रदाता के लिए रोटेशन क्रम सेट करता है (केवल मेटाडेटा — कोई सीक्रेट संग्रहीत नहीं होता)।OpenClaw किसी प्रोफ़ाइल को छोटे कूलडाउन (रेट लिमिट, टाइमआउट, प्रमाणीकरण विफलताएँ) या लंबी निष्क्रिय स्थिति (बिलिंग/अपर्याप्त क्रेडिट) में छोड़ सकता है। openclaw models status --json से जाँचें और auth.unusableProfiles देखें। रेट-लिमिट कूलडाउन मॉडल-सीमित हो सकते हैं — एक मॉडल के लिए कूलडाउन में गई प्रोफ़ाइल उसी प्रदाता के किसी अन्य मॉडल को सेवा देना जारी रख सकती है; बिलिंग/निष्क्रिय विंडो पूरी प्रोफ़ाइल को अवरुद्ध करती हैं।प्रति-एजेंट क्रम ओवरराइड सेट करें (उस एजेंट के auth-state.json में संग्रहीत):
वास्तव में क्या आज़माया जाएगा, इसकी पुष्टि करें: openclaw models status --probe। स्पष्ट क्रम से बाहर रखी गई संग्रहीत प्रोफ़ाइल को चुपचाप आज़माने के बजाय excluded_by_auth_order रिपोर्ट किया जाता है।
  • जहाँ प्रदाता इसका समर्थन करता है, वहाँ OAuth / CLI लॉगिन अक्सर सदस्यता पहुँच का उपयोग करता है। Anthropic के लिए, OpenClaw का Claude CLI बैकएंड Claude Code claude -p का उपयोग करता है, जिसे Anthropic वर्तमान में सदस्यता उपयोग सीमाओं से खपत करने वाला Agent SDK/प्रोग्रामेटिक उपयोग मानता है — वर्तमान बिलिंग-विराम स्थिति और स्रोत लिंक के लिए Anthropic देखें।
  • API कुंजियाँ प्रति-टोकन भुगतान वाली बिलिंग का उपयोग करती हैं।
विज़ार्ड Anthropic Claude CLI, OpenAI Codex OAuth और API कुंजियों का समर्थन करता है।

संबंधित