openclaw models

मॉडल खोज, स्कैनिंग और कॉन्फ़िगरेशन (डिफ़ॉल्ट मॉडल, फ़ॉलबैक, प्रमाणीकरण प्रोफ़ाइलें)।

संबंधित:

• प्रदाता + मॉडल: मॉडल
• मॉडल चयन की अवधारणाएँ + /models स्लैश कमांड: मॉडल अवधारणा
• प्रदाता प्रमाणीकरण सेटअप: आरंभ करना

सामान्य कमांड

openclaw models statusopenclaw models listopenclaw models set <model-or-alias>openclaw models set-image <model-or-alias>openclaw models scan

status और auth उपकमांड किसी कॉन्फ़िगर किए गए एजेंट को लक्षित करने के लिए --agent <id> स्वीकार करते हैं; list, scan, aliases, और fallbacks/image-fallbacks हमेशा कॉन्फ़िगर किए गए डिफ़ॉल्ट एजेंट का उपयोग करते हैं, और set/set-image --agent को पूरी तरह अस्वीकार करते हैं। इसे छोड़ने पर, --agent-सक्षम कमांड, सेट होने पर OPENCLAW_AGENT_DIR का उपयोग करते हैं, अन्यथा कॉन्फ़िगर किए गए डिफ़ॉल्ट एजेंट का।

स्थिति

openclaw models status निर्धारित डिफ़ॉल्ट/फ़ॉलबैक के साथ प्रमाणीकरण का अवलोकन दिखाता है। Codex जैसे Plugin-स्वामित्व वाले एजेंट रनटाइम के लिए, यह यह भी जाँचता है कि स्वामी Plugin सक्षम है और उसने स्टार्टअप पेलोड सत्यापन पास किया है। मान्य क्रेडेंशियल लेकिन अनुपलब्ध रनटाइम वाला रूट usable के बजाय status: unavailable रिपोर्ट करता है; JSON आउटपुट में अलग-अलग authStatus, runtimeStatus, और सीमित रनटाइम निदान शामिल होते हैं। प्रदाता उपयोग स्नैपशॉट उपलब्ध होने पर, OAuth/API-कुंजी स्थिति अनुभाग में प्रदाता उपयोग विंडो और कोटा स्नैपशॉट शामिल होते हैं। वर्तमान उपयोग-विंडो प्रदाता: Anthropic, GitHub Copilot, Gemini CLI, OpenAI, MiniMax, Xiaomi, और z.ai। उपलब्ध होने पर उपयोग प्रमाणीकरण प्रदाता-विशिष्ट हुक से आता है; अन्यथा OpenClaw प्रमाणीकरण प्रोफ़ाइलों, env या कॉन्फ़िगरेशन से मेल खाने वाले OAuth/API-कुंजी क्रेडेंशियल पर वापस जाता है।

--json आउटपुट में, auth.providers env/कॉन्फ़िगरेशन/स्टोर-सक्षम प्रदाता अवलोकन है, जबकि auth.oauth केवल प्रमाणीकरण-स्टोर प्रोफ़ाइल स्वास्थ्य है।

विकल्प:

जाँच पंक्तियाँ प्रमाणीकरण प्रोफ़ाइलों, env क्रेडेंशियल या models.json से आ सकती हैं। जाँच स्थिति श्रेणियाँ: ok, auth, rate_limit, billing, timeout, format, unknown, no_model।

जब कोई जाँच मॉडल कॉल तक कभी नहीं पहुँचती, तब अपेक्षित जाँच विवरण/कारण कोड:

• excluded_by_auth_order: एक संग्रहीत प्रोफ़ाइल मौजूद है, लेकिन स्पष्ट auth.order.<provider> ने उसे छोड़ दिया है, इसलिए जाँच उसे आज़माने के बजाय उसके बहिष्करण की रिपोर्ट करती है।
• missing_credential, invalid_expires, expired, unresolved_ref: प्रोफ़ाइल मौजूद है, लेकिन पात्र या समाधान योग्य नहीं है।
• ineligible_profile: प्रोफ़ाइल किसी अन्य कारण से प्रदाता कॉन्फ़िगरेशन के साथ असंगत है।
• no_model: प्रदाता प्रमाणीकरण मौजूद है, लेकिन OpenClaw उस प्रदाता के लिए जाँच योग्य मॉडल उम्मीदवार निर्धारित नहीं कर सका।

OpenAI ChatGPT/Codex OAuth समस्या निवारण के लिए, openclaw models status, openclaw models auth list --provider openai, और openclaw config get agents.defaults.model --json यह पुष्टि करने के सबसे तेज़ तरीके हैं कि किसी एजेंट के पास नेटिव Codex रनटाइम के माध्यम से openai/* के लिए उपयोग योग्य openai OAuth प्रोफ़ाइल है या नहीं। OpenAI प्रदाता सेटअप देखें।

सूची

openclaw models list केवल-पढ़ने योग्य है: यह कॉन्फ़िगरेशन, प्रमाणीकरण प्रोफ़ाइलें, मौजूदा कैटलॉग स्थिति और प्रदाता-स्वामित्व वाली कैटलॉग पंक्तियाँ पढ़ता है, लेकिन models.json को कभी दोबारा नहीं लिखता।

विकल्प: --all (पूरा कैटलॉग), --local (स्थानीय मॉडलों तक फ़िल्टर करें), --provider <id>, --json, --plain।

टिप्पणियाँ:

• Auth कॉलम केवल-पढ़ने योग्य है। OpenAI जैसे प्रदाता-स्वामित्व वाले मॉडल रूट के लिए, यह प्रत्येक पंक्ति के API/आधार-URL रूट का प्रभावी auth.order में पात्र प्रोफ़ाइलों, env/कॉन्फ़िगरेशन क्रेडेंशियल और निर्धारित कमांड-स्कोप वाले SecretRefs से मिलान करता है। किसी ठोस OpenAI पंक्ति की रूट नीति अनुपलब्ध होने पर, प्रदाता-स्तरीय प्रमाणीकरण उधार लेने के बजाय उसकी स्थिति अज्ञात रहती है; केवल-प्रदाता विरासती जाँचें और अन्य प्रदाता प्रदाता-स्तरीय व्यवहार बनाए रखते हैं। Plugin सिंथेटिक-प्रमाणीकरण मेटाडेटा केवल रनटाइम-क्षमता संकेत है, नेटिव खाता प्रमाणीकरण का प्रमाण नहीं, इसलिए सकारात्मक रजिस्ट्री प्रमाण के बिना खाता-निर्भर रूट अज्ञात रहते हैं। यह कमांड प्रदाता रनटाइम लोड नहीं करता, कीचेन सीक्रेट नहीं पढ़ता, प्रदाता API कॉल नहीं करता, या सटीक निष्पादन तत्परता प्रमाणित नहीं करता।
• models list --all --provider <id> में Plugin मैनिफ़ेस्ट या बंडल किए गए प्रदाता कैटलॉग मेटाडेटा की प्रदाता-स्वामित्व वाली स्थिर कैटलॉग पंक्तियाँ शामिल हो सकती हैं, भले ही आपने अभी तक उस प्रदाता के साथ प्रमाणीकरण न किया हो। मेल खाता प्रमाणीकरण कॉन्फ़िगर होने तक वे पंक्तियाँ फिर भी अनुपलब्ध दिखाई देती हैं।
• प्रदाता कैटलॉग खोज धीमी होने पर models list नियंत्रण तल को प्रतिक्रियाशील बनाए रखता है। डिफ़ॉल्ट और कॉन्फ़िगर किए गए दृश्य थोड़ी प्रतीक्षा के बाद कॉन्फ़िगर या सिंथेटिक मॉडल पंक्तियों पर वापस जाते हैं और खोज को पृष्ठभूमि में पूरा होने देते हैं। जब आपको सटीक पूर्ण खोजा गया कैटलॉग चाहिए और आप प्रदाता खोज की प्रतीक्षा करने को तैयार हों, तब --all का उपयोग करें।
• व्यापक models list --all, प्रदाता रनटाइम पूरक हुक लोड किए बिना मैनिफ़ेस्ट कैटलॉग पंक्तियों को रजिस्ट्री पंक्तियों पर मर्ज करता है। प्रदाता-फ़िल्टर किए गए मैनिफ़ेस्ट तेज़ पथ केवल static चिह्नित प्रदाताओं का उपयोग करते हैं; refreshable चिह्नित प्रदाता रजिस्ट्री/कैश-समर्थित रहते हैं और मैनिफ़ेस्ट पंक्तियाँ पूरक के रूप में जोड़ते हैं, जबकि runtime चिह्नित प्रदाता रजिस्ट्री/रनटाइम खोज पर बने रहते हैं।
• models list नेटिव मॉडल मेटाडेटा और रनटाइम सीमाओं को अलग रखता है। तालिका आउटपुट में, जब प्रभावी रनटाइम सीमा नेटिव कॉन्टेक्स्ट विंडो से अलग होती है, तब Ctx, contextTokens/contextWindow दिखाता है; प्रदाता द्वारा वह सीमा उपलब्ध कराए जाने पर JSON पंक्तियों में contextTokens शामिल होता है।
• प्रदाता-स्वामित्व वाले रूट के लिए, models list एक तार्किक प्रदाता/मॉडल पंक्ति को चयनित रूट पर प्रक्षेपित करता है। Input और Ctx केवल सटीक भौतिक-रूट कैटलॉग पंक्ति से आते हैं, जिसमें स्पष्ट कॉन्फ़िगर किए गए तार्किक ओवरराइड अंत में लागू होते हैं; अनिर्धारित रूट चयन सहोदर-रूट मेटाडेटा उधार लेने के बजाय अज्ञात क्षमता फ़ील्ड दिखाता है।
• models list --provider <id> प्रदाता आईडी द्वारा फ़िल्टर करता है, जैसे moonshot या openai। यह इंटरैक्टिव प्रदाता चयनकर्ताओं के प्रदर्शन लेबल, जैसे Moonshot AI, स्वीकार नहीं करता।
• मॉडल संदर्भों को पहले / पर विभाजित करके पार्स किया जाता है। यदि मॉडल आईडी में / (OpenRouter-शैली) शामिल है, तो प्रदाता उपसर्ग शामिल करें (उदाहरण: openrouter/moonshotai/kimi-k2)।
• यदि आप प्रदाता छोड़ देते हैं, तो OpenClaw इनपुट को पहले उपनाम के रूप में, फिर उस सटीक मॉडल आईडी के लिए अद्वितीय कॉन्फ़िगर-प्रदाता मिलान के रूप में निर्धारित करता है, और केवल उसके बाद बहिष्करण चेतावनी के साथ कॉन्फ़िगर किए गए डिफ़ॉल्ट प्रदाता पर वापस जाता है। यदि वह प्रदाता अब कॉन्फ़िगर किया गया डिफ़ॉल्ट मॉडल उपलब्ध नहीं कराता, तो OpenClaw किसी पुराने हटाए गए-प्रदाता डिफ़ॉल्ट को दिखाने के बजाय पहले कॉन्फ़िगर किए गए प्रदाता/मॉडल पर वापस जाता है।
• models status गैर-सीक्रेट प्लेसहोल्डर (उदाहरण के लिए OPENAI_API_KEY, secretref-managed, minimax-oauth, oauth:chutes, ollama-local) के लिए प्रमाणीकरण आउटपुट में उन्हें सीक्रेट की तरह छिपाने के बजाय marker(<value>) दिखा सकता है।

डिफ़ॉल्ट / इमेज मॉडल सेट करें

openclaw models set <model-or-alias>openclaw models set-image <model-or-alias>

set, agents.defaults.model.primary लिखता है; set-image, agents.defaults.imageModel.primary लिखता है। दोनों provider/model या कॉन्फ़िगर किया गया उपनाम स्वीकार करते हैं। नए चयनित मॉडल को आवश्यकता होने पर set Codex/Copilot रनटाइम Plugin इंस्टॉल की मरम्मत भी करता है; set-image ऐसा नहीं करता। कोई भी कमांड --agent स्वीकार नहीं करता; वे हमेशा एजेंट डिफ़ॉल्ट लिखते हैं।

स्कैन

models scan, OpenRouter का सार्वजनिक :free कैटलॉग पढ़ता है और फ़ॉलबैक उपयोग के लिए उम्मीदवारों को क्रम देता है। कैटलॉग स्वयं सार्वजनिक है, इसलिए केवल-मेटाडेटा स्कैन के लिए OpenRouter कुंजी की आवश्यकता नहीं होती।

डिफ़ॉल्ट रूप से OpenClaw लाइव मॉडल कॉल के साथ टूल और इमेज समर्थन की जाँच करने का प्रयास करता है। यदि कोई OpenRouter कुंजी कॉन्फ़िगर नहीं है, तो कमांड केवल-मेटाडेटा आउटपुट पर वापस जाता है और बताता है कि :free मॉडलों को जाँच और अनुमान के लिए अभी भी OPENROUTER_API_KEY की आवश्यकता होती है।

विकल्प:

• --no-probe (केवल मेटाडेटा; कोई कॉन्फ़िगरेशन/सीक्रेट लुकअप नहीं)
• --min-params <b>
• --max-age-days <days>
• --provider <name>
• --max-candidates <n>
• --timeout <ms> (कैटलॉग अनुरोध और प्रति-जाँच समय-सीमा)
• --concurrency <n>
• --yes
• --no-input
• --set-default
• --set-image
• --json

--set-default और --set-image के लिए लाइव जाँच आवश्यक है; केवल-मेटाडेटा स्कैन परिणाम सूचनात्मक होते हैं और कॉन्फ़िगरेशन पर लागू नहीं किए जाते।

उपनाम

openclaw models aliases list [--json] [--plain]openclaw models aliases add <alias> <model-or-alias>openclaw models aliases remove <alias>

उपनाम प्रत्येक मॉडल प्रविष्टि में agents.defaults.models.<key>.alias के रूप में संग्रहीत होते हैं। add, <model-or-alias> को पहले एक कैननिकल प्रदाता/मॉडल कुंजी में निर्धारित करता है, इसलिए किसी उपनाम को उपनाम देने पर शृंखला बनाने के बजाय वह पुनः इंगित हो जाता है। उपनाम जोड़ने से agents.defaults.modelPolicy.allow नहीं बदलता या मॉडल ओवरराइड सीमित नहीं होते।

फ़ॉलबैक

openclaw models fallbacks list [--json] [--plain]openclaw models fallbacks add <model-or-alias>openclaw models fallbacks remove <model-or-alias>openclaw models fallbacks clear

agents.defaults.model.fallbacks का प्रबंधन करता है। openclaw models image-fallbacks list|add|remove|clear समान उपकमांड संरचना वाली समानांतर agents.defaults.imageModel.fallbacks सूची का प्रबंधन करता है।

प्रमाणीकरण प्रोफ़ाइलें

openclaw models auth addopenclaw models auth list [--provider <id>] [--json]openclaw models auth login --provider <id>openclaw models auth login --provider openai --profile-id openai:workopenclaw models auth login-github-copilotopenclaw models auth paste-api-key --provider <id>openclaw models auth setup-token --provider <id>openclaw models auth paste-token --provider <id>openclaw models auth order get --provider <id>openclaw models auth order set --provider <id> <profileIds...>openclaw models auth order clear --provider <id>

models auth add इंटरैक्टिव प्रमाणीकरण सहायक है। यह आपके चुने गए प्रदाता के आधार पर प्रदाता प्रमाणीकरण प्रवाह (OAuth/API कुंजी) शुरू कर सकता है या मैन्युअल रूप से टोकन पेस्ट करने में आपका मार्गदर्शन कर सकता है।

models auth list टोकन, API कुंजी या OAuth गोपनीय सामग्री प्रिंट किए बिना चयनित एजेंट के लिए सहेजी गई प्रमाणीकरण प्रोफ़ाइल सूचीबद्ध करता है। किसी एक प्रदाता, जैसे openai, तक फ़िल्टर करने के लिए --provider <id> और स्क्रिप्टिंग के लिए --json का उपयोग करें।

models auth login प्रदाता Plugin का प्रमाणीकरण प्रवाह (OAuth/API कुंजी) चलाता है। कौन-से प्रदाता इंस्टॉल हैं, यह देखने के लिए openclaw plugins list का उपयोग करें। login उन प्रदाताओं के लिए --profile-id <id> स्वीकार करता है जो लॉगिन के दौरान नामित प्रोफ़ाइल का समर्थन करते हैं (एक ही प्रदाता के एकाधिक लॉगिन अलग रखने के लिए इसका उपयोग करें), किसी विशिष्ट प्रमाणीकरण विधि को चुनने के लिए --method <id>, --method device-code के शॉर्टकट के रूप में --device-code, प्रदाता का अनुशंसित डिफ़ॉल्ट मॉडल लागू करने के लिए --set-default, और उस प्रदाता की मौजूदा प्रोफ़ाइल पहले हटाने के लिए --force स्वीकार करता है (जब कैश की गई OAuth प्रोफ़ाइल अटक गई हो या आप खाते बदलना चाहते हों, तब इसका उपयोग करें)।

models auth login-github-copilot, models auth login --provider github-copilot --method device (GitHub डिवाइस प्रवाह) का शॉर्टकट है; यह बिना संकेत दिए किसी मौजूदा प्रोफ़ाइल को अधिलेखित करने के लिए --yes स्वीकार करता है।

प्रमाणीकरण परिणामों को किसी विशिष्ट कॉन्फ़िगर किए गए एजेंट स्टोर में लिखने के लिए openclaw models auth --agent <id> <subcommand> का उपयोग करें। पैरेंट --agent फ़्लैग का पालन add, list, login, paste-api-key, setup-token, paste-token, login-github-copilot, और order get/set/clear द्वारा किया जाता है।

OpenAI मॉडल के लिए, --provider openai डिफ़ॉल्ट रूप से ChatGPT/Codex खाता लॉगिन का उपयोग करता है। OpenAI API-कुंजी प्रोफ़ाइल जोड़ने के लिए केवल तभी --method api-key का उपयोग करें, जब आप आमतौर पर Codex सदस्यता सीमाओं के लिए बैकअप चाहते हों। पुराने विरासती OpenAI Codex उपसर्ग प्रमाणीकरण/प्रोफ़ाइल की स्थिति को openai में माइग्रेट करने के लिए openclaw doctor --fix चलाएँ।

उदाहरण:

openclaw models auth login --provider openai --set-defaultopenclaw models auth login --provider openai --method api-keyopenclaw models auth paste-api-key --provider openaiopenclaw models auth list --provider openai

टिप्पणियाँ:

• paste-api-key कहीं और जनरेट की गई API कुंजियाँ स्वीकार करता है, कुंजी मान के लिए संकेत देता है, और जब तक आप --profile-id पास नहीं करते, इसे डिफ़ॉल्ट प्रोफ़ाइल आईडी <provider>:manual में लिखता है। स्वचालन में, कुंजी को stdin पर पाइप करें, उदाहरण के लिए printf "%s\n" "$OPENAI_API_KEY" | openclaw models auth paste-api-key --provider openai।
• setup-token और paste-token टोकन प्रमाणीकरण विधियाँ उपलब्ध कराने वाले प्रदाताओं के लिए सामान्य टोकन कमांड बने रहते हैं।
• setup-token के लिए इंटरैक्टिव TTY आवश्यक है और यह प्रदाता की टोकन-प्रमाणीकरण विधि चलाता है (यदि वह प्रदाता setup-token विधि उपलब्ध कराता है, तो डिफ़ॉल्ट रूप से उसका उपयोग करता है)।
• paste-token के लिए --provider आवश्यक है, यह डिफ़ॉल्ट रूप से टोकन मान के लिए संकेत देता है, और जब तक आप --profile-id पास नहीं करते, इसे डिफ़ॉल्ट प्रोफ़ाइल आईडी <provider>:manual में लिखता है। स्वचालन में, टोकन को तर्क के रूप में पास करने के बजाय stdin पर पाइप करें, ताकि प्रदाता क्रेडेंशियल शेल इतिहास या प्रक्रिया सूचियों में दिखाई न दें।
• paste-token --expires-in <duration>, 365d या 12h जैसी सापेक्ष अवधि से टोकन की पूर्ण समाप्ति संग्रहीत करता है।
• openai के लिए, OpenAI API कुंजियाँ और ChatGPT/OAuth टोकन सामग्री अलग-अलग प्रमाणीकरण प्रारूप हैं। sk-... OpenAI API कुंजियों के लिए paste-api-key और केवल टोकन प्रमाणीकरण सामग्री के लिए paste-token का उपयोग करें।
• Anthropic: setup-token/paste-token, anthropic के लिए समर्थित OpenClaw प्रमाणीकरण पथ हैं, लेकिन उपलब्ध होने पर OpenClaw होस्ट पर Claude CLI (claude -p) के पुनः उपयोग को प्राथमिकता देता है।
• auth order get/set/clear एक प्रदाता के लिए प्रति-एजेंट प्रमाणीकरण प्रोफ़ाइल क्रम ओवरराइड प्रबंधित करता है, जो auth-state.json में संग्रहीत होता है (auth.order.<provider> कॉन्फ़िगरेशन कुंजी से अलग)। set प्राथमिकता क्रम में एक या अधिक प्रोफ़ाइल आईडी लेता है; clear कॉन्फ़िगरेशन/राउंड-रॉबिन क्रम पर वापस जाता है।

संबंधित

• CLI संदर्भ
• मॉडल चयन
• मॉडल फ़ेलओवर