मॉडल कनेक्शन की संपूर्ण झलक: provider सिस्टम और मॉडल स्विचिंग
OpenClaw इंस्टॉल करके, onboarding पूरा करने के बाद, आपके पास एक उपयोगी मॉडल पहले से है। लेकिन OpenClaw खुद मॉडल के साथ नहीं आता——सभी मॉडल «provider प्लगइन» से आते हैं, और यही OpenClaw मॉडल कॉन्फ़िगरेशन का मूल है: कौन-सा प्लगइन जोड़ें, कौन-से क्रेडेंशियल कॉन्फ़िगर करें, और मॉडल रेफ़रेंस में provider/model सही लिखें।
यह पाठ (1.6) इस पूरे सिस्टम को एक साथ समझाता है: मौजूदा स्थिति कैसे देखें, कैटलॉग कैसे सूचीबद्ध करें, डिफ़ॉल्ट कैसे सेट करें, चैट में कभी भी कैसे स्विच करें, और एक बिल्कुल नया provider कैसे जोड़ें। इसके बाद 1.7–1.15 का हर मॉडल-जोड़ने वाला पृष्ठ इन्हीं नियमों का ठोस अनुप्रयोग है। यह ट्यूटोरियल v2026.10.9 पर आधारित है।
सीखने के बाद आप क्या कर सकते हैं
- बता सकते हैं कि मौजूदा OpenClaw कौन-सा मॉडल उपयोग कर रहा है:
openclaw models statusसे तुरंत पता चलता है - किसी भी provider का मॉडल कैटलॉग
openclaw models listसे ब्राउज़ कर सकते हैं, «OpenClaw कौन-कौन से मॉडल समर्थित हैं» के लिए खोज पर निर्भर नहीं रहना पड़ेगा - डिफ़ॉल्ट मॉडल
openclaw models set <provider/model>से बदल सकते हैं, कॉन्फ़िगरेशन फ़ाइल हाथ से बदलने की ज़रूरत नहीं - चैट में
/modelकमांड परिवार से कभी भी मॉडल स्विच कर सकते हैं: अस्थायी और स्थायी दोनों तरह से - नया provider जोड़ते समय तीन चरण ज़ुबानी बोल सकते हैं: प्लगइन इंस्टॉल करें → क्रेडेंशियल कॉन्फ़िगर करें → मॉडल चुनें
आपकी मौजूदा दिक्कत
- इंस्टॉल के बाद उपयोग तो हो रहा है, पर «अभी वास्तव में कौन-सा मॉडल चल रहा है» स्पष्ट नहीं; सस्ता या ज़्यादा शक्तिशाली मॉडल बदलना चाहते हैं, पर कहाँ से शुरू करें पता नहीं
- «OpenClaw कौन-कौन से मॉडल समर्थित हैं» खोजते हैं, तो जवाब तरह-तरह के मिलते हैं, और उनमें Clawdbot / Moltbot काल के पुराने कमांड भी मिले हुए हैं
- दूसरों को कॉन्फ़िगरेशन फ़ाइल में
agents.defaultsबदलते देखकर खुद भी करना चाहते हैं, पर डर है कि गलती से Gateway शुरू न हो
यह तरीका कब उपयोग करें
जब आपको यह करना हो:
- OpenClaw के मॉडल सिस्टम को समझना हो——अभी क्या उपयोग हो रहा है, और क्या उपयोग किया जा सकता है, कैसे बदलें
- डिफ़ॉल्ट मॉडल को घरेलू मॉडल (DeepSeek, Qwen, GLM……) से बदलना हो, या अलग-अलग सेशन में अलग-अलग मॉडल उपयोग करना हो
- चैट के बीच में अस्थायी रूप से कोई शक्तिशाली मॉडल चुनना हो, और बात पूरी होने पर वापस आना हो
और आप यह नहीं चाहते:
- हर बार मॉडल बदलने पर कॉन्फ़िगरेशन फ़ाइल हाथ से बदलना
- 70+ प्रविष्टियों वाले आधिकारिक provider कैटलॉग में खोए जाना
- «नया मॉडल जोड़ने» और «पहले से मौजूद मॉडल बदलने» को एक ही बात मानकर बिना सोचे-समझे प्रयोग करना
🎒 शुरू करने से पहले की तैयारी
- 5 मिनट में OpenClaw इंस्टॉल पूरा करना पूरा कर लिया हो: onboarding में कम से कम एक provider कॉन्फ़िगर हो चुका हो (Claude / Codex लॉगइन या किसी की API Key)
- Gateway चल रहा हो:
openclaw gateway statusपर 18789 सुनने (listen) का संकेत दिखना चाहिए (चल न रहा हो तो भी मॉडल देखे जा सकते हैं, बसmodels listलोकल कैश कैटलॉग पढ़ेगा) - साथ में नया provider जोड़ना चाहते हैं तो उसकी API Key तैयार रखें——अगले पाठ से DeepSeek का उदाहरण दिया जाएगा
मूल विचार
OpenClaw खुद मॉडल के साथ नहीं आता। मॉडल और agent harness (Claude, Codex, लोकल मॉडल) सब बदले जा सकने वाले प्लगइन हैं। हर मॉडल जोड़ना = एक provider प्लगइन + एक क्रेडेंशियल।OpenClaw मॉडल कॉन्फ़िगरेशन में केवल तीन अवधारणाएँ हैं:
- provider——किसी एक मॉडल को जोड़ने वाला प्लगइन, जिसका एक अद्वितीय id होता है (जैसे
deepseek,qwen,anthropic) - मॉडल रेफ़रेंस
provider/model——किसी मॉडल को नाम देने का एकीकृत तरीका, जैसेdeepseek/deepseek-v4-pro - डिफ़ॉल्ट मॉडल और स्विचिंग——कॉन्फ़िगरेशन में एक डिफ़ॉल्ट लिखें; चैट में
/modelसे कभी भी बदलें
रेफ़रेंस नियम पूरे पाठ की नींव हैं:
| नियम | उदाहरण | व्याख्या |
|---|---|---|
पहले / से पहले provider id होता है | qwen/qwen3.5-plus | provider id हमेशा लोअरकेस (normalized) होता है |
मॉडल ID में / पहले से हो तो पूरा प्रीफ़िक्स अनिवार्य | openrouter/moonshotai/kimi-k2 | «पहले /» के आधार पर विभाजन होता है, प्रीफ़िक्स छूटने पर ढूँढा नहीं जा सकता |
| मॉडल ID की वर्तनी वेंडर के अनुसार | minimax/MiniMax-M3 | MiniMax के मॉडल ID केस-सेंसिटिव हैं, प्लगइन कैटलॉग से ज्यों का त्यों कॉपी करें |
दो तरीके जोड़ने के, एक टेबल में समझें:
| आधिकारिक provider प्लगइन | कस्टम / रिले एंडपॉइंट | |
|---|---|---|
| लागू | जिन मॉडलों का आधिकारिक प्लगइन है (DeepSeek, Qwen, GLM, Kimi, MiniMax……) | जिन मॉडलों का आधिकारिक प्लगइन नहीं है, OpenAI-संगत रिले स्टेशन, लोकल इन्फरेंस सेवाएँ |
क्या models.providers कॉन्फ़िगरेशन लिखना होगा | नहीं: प्लगइन इंस्टॉल करें + auth सेट करें + मॉडल चुनें | हाँ: baseUrl, apiKey, models सूची |
| विवरण के लिए | 1.7–1.13 प्रत्येक प्रदाता का समर्पित पृष्ठ | अधिक चीनी मॉडल और कस्टम रिले एंडपॉइंट |
provider परिवार (आधिकारिक Provider डायरेक्टरी में 70+ प्रविष्टियाँ शामिल हैं):
| परिवार | प्रतिनिधि | कनेक्शन का तरीका | इस ट्यूटोरियल का समर्पित पृष्ठ |
|---|---|---|---|
| अंतरराष्ट्रीय बड़ी कंपनियाँ | OpenAI(openai), Anthropic(anthropic), Google(google) | बिल्ट-इन प्लगइन; onboarding पुनः उपयोग किया जा सकता है Claude Code / Codex CLI लॉगिन | क्विक स्टार्ट में कवर किया गया |
| चीनी मॉडल | DeepSeek, Tongyi Qianwen, Zhipu GLM, Kimi, MiniMax, Doubao/Volcano, Hunyuan, Qianfan, StepFun, Xiaomi MiMo, LongCat | आधिकारिक प्लगइन + API Key | 1.7–1.13 प्रत्येक का एक पृष्ठ |
| एग्रीगेट राउटिंग | OpenRouter, LiteLLM, ClawRouter | एक ही Key से कई प्रदाताओं के मॉडल खोलें | 1.14 रिले और अधिक चीनी मॉडल |
| लोकल मॉडल | Ollama, vLLM, SGLang, LM Studio, ds4 | अपनी ही मशीन पर चलते हैं, शून्य API लागत | 1.15 लोकल मॉडल |
चीनी उपयोगकर्ताओं के लिए अच्छी खबर: मुख्यधारा के चीनी मॉडल सभी «प्रथम श्रेणी के नागरिक» हैं — सभी के पास आधिकारिक provider प्लगइन है, 1.7 से शुरू होकर प्रत्येक का एक पृष्ठ है जिसमें चरण-दर-चरण कॉन्फ़िगरेशन दिया गया है।
मेरे साथ करें
चरण 1: वर्तमान मॉडल कॉन्फ़िगरेशन देखें——openclaw models status
क्यों: onboarding आपके लिए मॉडल कॉन्फ़िगर कर देता है, लेकिन कई लोग स्पष्ट नहीं बता पाते कि «मैं वास्तव में कौन-सा उपयोग कर रहा हूँ»। पहले वर्तमान स्थिति देख लें, तभी आगे के हर चरण की तुलना के लिए आधार बनेगा।
openclaw models statusआपको यह दिखना चाहिए: दो हिस्सों की जानकारी — पार्स किए गए डिफ़ॉल्ट मॉडल और fallback श्रृंखला (पूरा provider/model संदर्भ), साथ ही हर provider का प्रमाण-पत्रों का अवलोकन (Auth overview: पर्यावरण चर, provider कॉन्फ़िगरेशन, auth स्टोरेज में मिले प्रमाण-पत्रों के स्रोत)। जब OAuth प्रमाण-पत्र जल्द एक्सपायर होने वाले हों (डिफ़ॉल्ट रूप से 24 घंटों के भीतर) तो भी यहाँ चेतावनी दिखती है।
तीन अतिरिक्त बिंदु:
बिना विकल्प का
openclaw modelsopenclaw models statusके बराबर है;--jsonजोड़ने पर मशीन-पठनीय प्रारूप मिलता है--probeके बिना यह कोई वास्तविक मॉडल अनुरोध नहीं भेजता — प्रमाण-पत्र का «मौजूद दिखना» इसकी उपयोगिता का प्रमाण नहीं है; वास्तविक परीक्षण के लिए--probeजोड़ें (यह सचमुच मॉडल को कॉल करेगा, संभवतः token खर्च होंगे और रेट-लिमिट ट्रिगर हो सकता है)एकल सेशन में किया गया अस्थायी स्विच, CLI के status में नहीं दिखता, उस सेशन के
/model statusसे देखना होगाopenclaw models statusमें वर्तमान डिफ़ॉल्ट मॉडल का पूराprovider/modelसंदर्भ मिल जाता है
चरण 2: मॉडल कैटलॉग ब्राउज़ करें——openclaw models list (OpenClaw कौन-कौन से मॉडल समर्थित हैं यहाँ देखें)
क्यों: मॉडल बदलने से पहले सामान देख लें। हर provider का अपना मॉडल कैटलॉग है: कॉन्टेक्स्ट विंडो, इनपुट प्रकार, रीज़निंग मॉडल है या नहीं — सब तालिका में है।
openclaw models list # 当前已装 provider 的可见模型
openclaw models list --all # 完整发布目录
openclaw models list --provider deepseek # 只看一家आपको यह दिखना चाहिए: हर पंक्ति में एक मॉडल संदर्भ (provider/model रूप)। --provider के बाद provider id आता है (जैसे deepseek, moonshot), इंटरफ़ेस पर दिखने वाला नाम नहीं (जैसे Moonshot AI)।
चार व्यावहारिक विवरण:
provider id भूल गए? पहले
openclaw models list --allचलाएँ, पूरे कैटलॉग से खोजेंअज्ञात provider id पर त्रुटि के साथ बाहर निकलता है (exit गैर-शून्य), और अस्वीकृत id का नाम बताता है
नए जारी मॉडल लोकल कैटलॉग में नहीं हो सकते,
--refreshजोड़ने पर पुनः खोज ट्रिगर होती हैकिसी प्रदाता के प्रमाण-पत्र सहेजने पर उसके मॉडल चुनने-योग्य कैटलॉग में आ जाते हैं — इसलिए चरण 5 में नया provider जोड़ने के बाद, वापस आकर रिफ्रेश करके देखना न भूलें
openclaw models list --provider <你已配好的 provider>ने उसका मॉडल कैटलॉग सूचीबद्ध किया
चरण 3: डिफ़ॉल्ट मॉडल सेट करें——OpenClaw मॉडल कॉन्फ़िगरेशन का मुख्य चरण
क्यों: डिफ़ॉल्ट मॉडल तय करता है कि नए सेशन और शेड्यूल किए गए कार्य क्या उपयोग करेंगे। कमांड एक पंक्ति का है, कॉन्फ़िगरेशन फ़ाइल हाथ से बदलने की ज़रूरत नहीं।
openclaw models set deepseek/deepseek-v4-pro(उदाहरण DeepSeek का है; शर्त यह है कि उसका provider प्लगइन इंस्टॉल हो — नहीं है तो पहले चरण 5 देखें, या सीधे DeepSeek से कनेक्ट करें पर जाएँ।)
आपको यह दिखना चाहिए: कमांड बिना त्रुटि के सफल; फिर openclaw models status चलाएँ, डिफ़ॉल्ट मॉडल नई वैल्यू हो चुका होगा।
यह जो करता है: कॉन्फ़िगरेशन आइटम agents.defaults.model.primary लिखता है। समतुल्य कॉन्फ़िगरेशन फ़ाइल लेखन ऐसा दिखता है:
{
agents: { defaults: { model: { primary: "deepseek/deepseek-v4-pro" } } },
}दो फ़ॉलसेफ़ नियम (आधिकारिक CLI दस्तावेज़ से):
- अज्ञात provider को सीधे अस्वीकार: exit गैर-शून्य, कॉन्फ़िगरेशन अपरिवर्तित — संदर्भ में provider अवश्य ही इंस्टॉल किया गया प्लगइन या कॉन्फ़िगर किया गया provider होना चाहिए
- कैटलॉग में वह मॉडल न होने पर चेतावनी: लिखने से नहीं रोकता (नए जारी या सेल्फ-होस्टेड मॉडल अभी कैटलॉग में नहीं आए होंगे), लेकिन वापस आकर वर्तनी जाँचना उचित है
💡 डिफ़ॉल्ट बदलने के दो और रास्ते
openclaw models auth login --provider <id> --set-default लॉगिन के समय उस provider का अनुशंसित डिफ़ॉल्ट मॉडल अपना लें; डिफ़ॉल्ट इमेज मॉडल के लिए openclaw models set-image <provider/model> का उपयोग करें (agents.defaults.imageModel.primary लिखता है)।
openclaw models set <provider/model>सफलतापूर्वक निष्पादित (या आप समझ गए कि उसने आपको क्यों अस्वीकार किया)
चरण 4: चैट में मॉडल बदलें——/model कमांड परिवार
क्यों: टर्मिनल में सेट किया गया वैल्यू «डिफ़ॉल्ट» है; चैट में कभी भी बदल सकते हैं — अस्थायी रूप से मज़बूत मॉडल पर स्विच करें, बातचीत के बाद वापस आएँ, ग्लोबल कॉन्फ़िगरेशन में कोई बदलाव नहीं।
/model # देखें कि वर्तमान सेशन क्या उपयोग कर रहा है
/model list # provider ब्राउज़ करें (/models भी चलेगा)
/model deepseek/deepseek-v4-pro # केवल वर्तमान सेशन स्विच करें (डिफ़ॉल्ट व्यवहार)
/model deepseek/deepseek-v4-pro -a # साथ ही उस agent का डिफ़ॉल्ट अपडेट करें (owner/admin चाहिए)
/model deepseek/deepseek-v4-pro -g # ग्लोबल डिफ़ॉल्ट अपडेट करें (owner/admin चाहिए)
/model default -s # इस सेशन का चुनाव हटाएं, कॉन्फ़िगरेशन डिफ़ॉल्ट पर लौटें
/model status # हर provider के क्रेडेंशियल कैंडिडेट और baseUrl / api मोडआपको यह दिखना चाहिए: स्विच कमांड तुरंत लागू होता है——agent खाली हो तो अगली रन नए मॉडल से होती है; चल रहा हो तो अगले सुरक्षित स्विच पॉइंट तक कतार में लगता है।/models <provider> किसी एक provider के सारे मॉडल सूचीबद्ध करें।
तीन स्वभाव जान लेना ज़रूरी है:
- सेशन के भीतर का चुनाव «सख़्त» होता है: चुना गया मॉडल पहुंच से बाहर हो तो सीधे एरर मिलता है, चुपचाप fallback चेन पर नहीं जाता (कॉन्फ़िगर किया डिफ़ॉल्ट ही fallback पर जाता है)
- अंकों से चुनाव समर्थित नहीं (
/model 3अमान्य है); Discord / Telegram में नेटिव पिकर इंटरफ़ेस है - मॉडल ID में पहले से
/हो तो पूरा प्रीफ़िक्स लिखें:/model openrouter/moonshotai/kimi-k2
/model के अलावा /think, /new का पूरा परिवार भी है, देखें चैट कमांड्स की झटपट जानकारी।
- चैट में
/model <provider/model>से स्विच करने पर, अगला जवाब नए मॉडल से आता है
चरण 5: नया provider जोड़ें——प्लगइन लगाएं, क्रेडेंशियल कॉन्फ़िगर करें, मॉडल चुनें
क्यों: डायरेक्टरी में जिस मॉडल को पसंद आया है, पहले उसे OpenClaw पर 'पहचान' लें। आधिकारिक provider प्लगइन में तीन निश्चित चरण हैं:
① प्लगइन लगाएं (कुछ provider को चाहिए) → ② क्रेडेंशियल कॉन्फ़िगर करें (openclaw onboard) → ③ मॉडल चुनेंDeepSeek का उदाहरण (यह बाहरी आधिकारिक प्लगइन है, इंस्टॉल करना पड़ता है):
openclaw plugins install @openclaw/deepseek-provider
openclaw onboard --auth-choice deepseek-api-keyआपको यह दिखना चाहिए: onboarding मौजूदा AI एक्सेस पहचानता है → आपके provider चुनने का इंतज़ार → कनेक्शन सत्यापन पास होने पर केवल उपलब्ध रूट सहेजे जाते हैं → बाकी कॉन्फ़िगरेशन जारी। --auth-choice चुनने पर, डिफ़ॉल्ट मॉडल पिकर उस provider के मॉडलों पर प्री-फ़िल्टर हो जाता है (उसी प्लगइन के सहोदर provider भी साथ मैच होते हैं, जैसे volcengine / volcengine-plan)।
तीन बातें ध्यान में रखें:
- प्लगइन लगाना है या नहीं, हर provider में अलग: MiniMax बिल्ट-इन (bundled) प्लगइन है,
openclaw plugins enable minimaxकाफ़ी है; DeepSeek, Qwen, GLM, Kimi जैसे बाहरी प्लगइन के लिएopenclaw plugins install @openclaw/<名字>-providerचाहिए। हर provider का सटीक कमांड, 1.7–1.13 पेज की शुरुआत में दिया गया है - आधिकारिक प्लगइन के लिए
models.providersकॉन्फ़िगरेशन एंट्री नहीं लिखनी पड़ती——प्लगइन लगाएं, auth सेट करें, मॉडल चुनें, तीन चरण पूरे; केवल कस्टम एंडपॉइंट या baseUrl ओवरराइड पर लिखें (देखें 1.14) - दोबारा onboard करने से मौजूदा मॉडल कॉन्फ़िगरेशन नहीं मिटता; मॉडल provider या auth रूट में बदलाव पर, आधिकारिक सलाह
openclaw onboardचलाने की है (openclaw configureगैर-इन्फरेंस प्रकार की सेटिंग्स के लिए है)
零一 Yi, 百川, 讯飞星火 जैसे मॉडल जिनके आधिकारिक प्लगइन अभी नहीं हैं, कस्टम OpenAI-संगत एंडपॉइंट या एग्रीगेटर से चलें, देखें और घरेलू मॉडल व कस्टम रिले एंडपॉइंट; API पैसा खर्च नहीं करना चाहते तो लोकल मॉडल Ollama, vLLM से मॉडल अपनी मशीन पर चलाना सिखाता है।
- नया provider जोड़ने के तीन चरणों का क्रम ज़ुबानी बोल सकते हैं: प्लगइन लगाएं → क्रेडेंशियल कॉन्फ़िगर करें → मॉडल चुनें
चेकपॉइंट ✅
openclaw models statusमौजूदा डिफ़ॉल्ट मॉडल का पूराprovider/modelरेफ़रेंस बता सकते हैंopenclaw models list --provider <id>किसी provider की मॉडल डायरेक्टरी सूचीबद्ध कर सकते हैंopenclaw models set <provider/model>से डिफ़ॉल्ट बदलने में सफल (या समझते हैं कि उसने क्यों मना किया)- चैट में
/model <provider/model>स्विच लागू होता है,/model default -sसे डिफ़ॉल्ट पर लौट सकते हैं - नया provider जोड़ने के तीन चरणों का क्रम बता सकते हैं: प्लगइन लगाएं → क्रेडेंशियल कॉन्फ़िगर करें → मॉडल चुनें
आम गलतियों की चेतावनी
❌ मॉडल रेफ़रेंस में provider प्रीफ़िक्स छूट गया
कारण: OpenClaw रेफ़रेंस को «पहले /» पर विभाजित करता है। provider छोड़ने पर पहले उपनाम आज़माता है, फिर अद्वितीय मैच होने वाला कॉन्फ़िगर provider, अंत में डिफ़ॉल्ट provider (अब deprecated व्यवहार)——एक ही नाम का एक और मॉडल आते ही चुना नहीं जा पाता।
/model kimi-k2 # ❌ ज़्यादातर मामलों में चुना नहीं जाता
/model kimi/kimi-for-coding # ✅ provider प्रीफ़िक्स के साथ
/model openrouter/moonshotai/kimi-k2 # ✅ मॉडल ID में / हो तो पूरा प्रीफ़िक्स ज़रूरीसही तरीका: रेफ़रेंस में हमेशा पूरा provider/model लिखें; संदेह हो तो पहले openclaw models list --provider <id>, डायरेक्टरी के मूल पाठ की नक़ल करें (MiniMax जैसे वेंडर के मॉडल ID केस-सेंसिटिव हैं)।
❌ नए provider की Key कॉन्फ़िगर की, समझे डिफ़ॉल्ट मॉडल अपने आप बदल जाएगा
कारण: नए provider के क्रेडेंशियल सहेजने से मौजूदा डिफ़ॉल्ट मॉडल नहीं बदलता——आधिकारिक Quick rules के मूल शब्द: «Adding provider auth does not change your primary model», केवल स्पष्ट --set-default से बदलता है।
सही तरीका: डिफ़ॉल्ट बदलने के लिए openclaw models set <provider/model>, या लॉगिन के समय openclaw models auth login --provider <id> --set-default। लक्षण मेल न खाएं तो पहले openclaw models status से देखें डिफ़ॉल्ट आख़िर कौन है।
❌ Gateway डेमन के रूप में लगने के बाद, export की API Key «लागू नहीं होती»
कारण: Gateway जब launchd / systemd सर्विस की तरह चलता है, तो आपके इंटरैक्टिव shell में export के environment वेरिएबल नहीं देख पाता——हर provider डॉक में यह बात ख़ास ज़ोर दी गई है।
सही तरीका: Key को ~/.openclaw/.env में लिखें, या कॉन्फ़िगरेशन के env.shellEnv से दें; Key बदलने पर Gateway सर्विस रीस्टार्ट करना न भूलें।
❌ रिटायर हो चुके पुराने मॉडल ID का इस्तेमाल
कारण: मॉडल रिटायर होते हैं। DeepSeek के deepseek-chat / deepseek-reasoner 2026-07-24 को रिटायर हो चुके हैं, पुराने ID अब उपलब्ध नहीं।
सही तरीका: openclaw models list --provider deepseek से वर्तमान डायरेक्टरी देखें, deepseek/deepseek-v4-pro, deepseek/deepseek-v4-flash जैसे नए ID इस्तेमाल करें; माइग्रेशन विवरण अगले पाठ DeepSeek जोड़ना में।
एडवांस्ड टिप्स (वैकल्पिक)
डिफ़ॉल्ट मॉडल के लिए fallback चेन कॉन्फ़िगर करें। agents.defaults.model.fallbacks के मॉडल क्रम से आज़माए जाते हैं; क्रेडेंशियल रोटेशन provider के भीतर होता है, फिर अगले fallback मॉडल पर जाता है। CLI प्रबंधन:
openclaw models fallbacks list
openclaw models fallbacks add deepseek/deepseek-v4-flash
openclaw models fallbacks remove <model-or-alias>
openclaw models fallbacks clearOpenClaw को मुफ़्त fallback चुनने दें। openclaw models scan OpenRouter की सार्वजनिक :free डायरेक्टरी पढ़ता है, इमेज सपोर्ट, टूल लेटेंसी, संदर्भ आदि के आधार पर कैंडिडेट चुनता है। दो ध्यान देने वाली बातें: मेटाडेटा स्कैन के लिए Key नहीं चाहिए, लाइव जांच व --set-default के लिए OPENROUTER_API_KEY चाहिए; प्रोब वाला scan कॉन्फ़िगरेशन लिखता है (fallbacks सीधे बदल देता है), बस देखना हो तो --no-probe जोड़ें।
मॉडल को उपनाम दें। openclaw models aliases add Opus anthropic/claude-opus-5-5 के बाद, चैट में /model Opus से चुना जा सकता है। उपनाम agents.defaults.models.<key>.alias में रहता है; एक मॉडल का एक ही समय पर केवल एक उपनाम होता है, नया जोड़ने पर पुराना हट जाता है।
एक बार के रन के लिए मॉडल निर्दिष्ट करें। कोई कॉन्फ़िगरेशन नहीं बदलना चाहते, तो एक बार के लिए चलाएँ:
openclaw agent --model deepseek/deepseek-v4-pro --message "..."Control UI में भी मॉडल प्रबंधित किए जा सकते हैं। Gateway का Models पेज CLI जैसी ही लॉगिन प्रक्रिया देता है; Settings → Models → Set API key से सीधे Key बदलें, बदलते ही उस क्रेडेंशियल का कूलडाउन और फेल्योर काउंट साफ़ हो जाता है, अगला अनुरोध तुरंत आज़माया जा सकता है।
होस्ट किए गए मॉडल कैटलॉग को अपडेट करें। openclaw models refresh आधिकारिक होस्टेड मेटाडेटा कैटलॉग खींचता है (नए मॉडल कैटलॉग में इसी रास्ते से आते हैं); इसके लिए लोकल Gateway पहले बंद होना चाहिए (openclaw gateway stop), रिफ्रेश के बाद दोबारा चालू करें।
इस पाठ का सारांश
✅ OpenClaw मॉडल कॉन्फ़िगरेशन के तीन कॉन्सेप्ट साफ़ हो गए: provider (प्लगइन + क्रेडेंशियल), provider/model रेफ़रेंस, डिफ़ॉल्ट मॉडल और स्विचिंग।
✅ देखें → लिस्ट करें → सेट करें → स्विच करें की कमांड श्रृंखला चल गई: models status से मौजूदा हालत देखें, models list से कैटलॉग देखें, models set से डिफ़ॉल्ट सेट करें, /model से चैट में स्विच करें।
✅ नया provider जोड़ने के तीन चरण तय हो गए: प्लगइन इंस्टॉल करें (अगर ज़रूरी हो) → openclaw onboard --auth-choice <id> से क्रेडेंशियल कॉन्फ़िगर करें → मॉडल चुनें; आधिकारिक प्लगइन में models.providers नहीं लिखते।
✅ दो स्वभाव याद रखें: सेशन के अंदर /model चुनाव सख़्ती से मैच होता है, fallback नहीं चलता; डेमन मोड में Key ~/.openclaw/.env में जाना चाहिए।
| कॉन्फ़िगरेशन फ़ील्ड / कमांड | रूप / अनुशंसित मान | विवरण |
|---|---|---|
agents.defaults.model.primary | "provider/model" | डिफ़ॉल्ट मॉडल; openclaw models set यहीं लिखता है |
agents.defaults.model.fallbacks | मॉडल रेफ़रेंस की सूची | फ़ॉलबैक श्रृंखला, क्रम से आज़माता है |
agents.defaults.models.<key>.alias | उपनाम स्ट्रिंग | /model <别名> का शॉर्टकट प्रवेश |
models.providers.<id> | केवल कस्टम एंडपॉइंट पर लिखें | आधिकारिक प्लगइन को ज़रूरत नहीं |
~/.openclaw/.env | PROVIDER_API_KEY=... | डेमन मोड में Key का घर |
openclaw onboard --auth-choice <id> | मान हर provider के समर्पित पृष्ठ में देखें | क्रेडेंशियल कॉन्फ़िगर / बदलें |
कमांड क्विक-रेफ़रेंस की पूरी सूची CLI कमांड और कॉन्फ़िगरेशन क्विक-रेफ़रेंस में देखें।
अगले पाठ की झलक
सिस्टम साफ़ हो गया, अगले पाठ से हर provider के साथ व्यावहारिक अभ्यास शुरू — पहला सबसे ज़्यादा उपयोगकर्ताओं वाला DeepSeek है। अगला पाठ DeepSeek जोड़ना: V4 सीरीज़ मॉडल कॉन्फ़िगरेशन व्यावहारिक अभ्यास।
आप सीखेंगे:
- DeepSeek V4 सीरीज़ मॉडल कैटलॉग:
deepseek-v4-pro/deepseek-v4-flashमें से कैसे चुनें DEEPSEEK_API_KEYकॉन्फ़िगरेशन की पूरी प्रक्रिया: प्लगइन इंस्टॉलेशन, onboarding, कॉन्फ़िगरेशन फ़ाइल के तीन तरीके- पुराने ID
deepseek-chat/deepseek-reasonerके रिटायर होने के बाद माइग्रेशन - DeepSeek की ख़ास क्षमताएँ: thinking लेवल, DSML टूल रिकवरी, web_search