​

openclaw models

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

​

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

openclaw models status
openclaw models list
openclaw models set <model-or-alias>
openclaw models scan

• models set <model-or-alias> provider/model या alias स्वीकार करता है।
• models list केवल-पढ़ने योग्य है: यह कॉन्फ़िग, ऑथ प्रोफ़ाइल, मौजूदा catalog स्थिति, और प्रोवाइडर-स्वामित्व वाली catalog पंक्तियाँ पढ़ता है, लेकिन models.json को दोबारा नहीं लिखता।
• Auth कॉलम प्रोवाइडर-स्तर का और केवल-पढ़ने योग्य है। यह स्थानीय ऑथ प्रोफ़ाइल मेटाडेटा, env markers, कॉन्फ़िगर की गई प्रोवाइडर keys, local-provider markers, AWS Bedrock env/profile markers, और plugin synthetic-auth metadata से गणना किया जाता है; यह प्रोवाइडर runtime लोड नहीं करता, keychain secrets नहीं पढ़ता, प्रोवाइडर APIs कॉल नहीं करता, या प्रति-मॉडल सटीक execution readiness साबित नहीं करता।
• models list --all --provider <id> plugin manifests या bundled provider catalog metadata से प्रोवाइडर-स्वामित्व वाली static catalog पंक्तियाँ शामिल कर सकता है, भले ही आपने अभी तक उस प्रोवाइडर से authenticate न किया हो। वे पंक्तियाँ तब भी unavailable दिखती हैं जब तक matching auth कॉन्फ़िगर न हो।
• models list प्रोवाइडर catalog discovery धीमी होने पर control plane को responsive रखता है। default और configured views थोड़ी प्रतीक्षा के बाद configured या synthetic model rows पर fallback करते हैं और discovery को background में पूरा होने देते हैं। जब आपको exact full discovered catalog चाहिए और आप provider discovery का इंतज़ार करने को तैयार हैं, तो --all उपयोग करें।
• व्यापक models list --all provider runtime supplement hooks लोड किए बिना manifest catalog rows को registry rows पर merge करता है। Provider-filtered manifest fast paths केवल static चिह्नित providers का उपयोग करते हैं; refreshable चिह्नित providers registry/cache-backed रहते हैं और manifest rows को supplements के रूप में append करते हैं, जबकि runtime चिह्नित providers registry/runtime discovery पर रहते हैं।
• models list native model metadata और runtime caps को अलग रखता है। table output में, Ctx contextTokens/contextWindow दिखाता है जब effective runtime cap native context window से अलग होती है; JSON rows में contextTokens शामिल होता है जब कोई provider वह cap expose करता है।
• models list --provider <id> provider id से filter करता है, जैसे moonshot या openai। यह interactive provider pickers से display labels स्वीकार नहीं करता, जैसे Moonshot AI।
• Model refs को पहले / पर split करके parse किया जाता है। अगर model ID में / शामिल है (OpenRouter-style), provider prefix शामिल करें (उदाहरण: openrouter/moonshotai/kimi-k2)।
• अगर आप provider छोड़ देते हैं, तो OpenClaw पहले input को alias के रूप में resolve करता है, फिर उसी exact model id के लिए unique configured-provider match के रूप में, और उसके बाद ही deprecation warning के साथ configured default provider पर fallback करता है। अगर वह provider अब configured default model expose नहीं करता, तो OpenClaw stale removed-provider default दिखाने के बजाय पहले configured provider/model पर fallback करता है।
• models status auth output में non-secret placeholders (उदाहरण OPENAI_API_KEY, secretref-managed, minimax-oauth, oauth:chutes, ollama-local) के लिए उन्हें secrets की तरह mask करने के बजाय marker(<value>) दिखा सकता है।

​

मॉडल स्कैन

• --no-probe (केवल metadata; कोई config/secrets lookup नहीं)
• --min-params <b>
• --max-age-days <days>
• --provider <name>
• --max-candidates <n>
• --timeout <ms> (catalog request और per-probe timeout)
• --concurrency <n>
• --yes
• --no-input
• --set-default
• --set-image
• --json

​

मॉडल स्थिति

• --json
• --plain
• --check (exit 1=expired/missing, 2=expiring)
• --probe (configured auth profiles का live probe)
• --probe-provider <name> (एक provider probe करें)
• --probe-profile <id> (repeat या comma-separated profile ids)
• --probe-timeout <ms>
• --probe-concurrency <n>
• --probe-max-tokens <n>
• --agent <id> (configured agent id; OPENCLAW_AGENT_DIR को override करता है)

• ok
• auth
• rate_limit
• billing
• timeout
• format
• unknown
• no_model

• excluded_by_auth_order: stored profile मौजूद है, लेकिन explicit auth.order.<provider> ने उसे omit किया, इसलिए probe उसे try करने के बजाय exclusion report करता है।
• missing_credential, invalid_expires, expired, unresolved_ref: profile मौजूद है लेकिन eligible/resolvable नहीं है।
• no_model: provider auth मौजूद है, लेकिन OpenClaw उस provider के लिए probeable model candidate resolve नहीं कर सका।

​

Aliases + fallbacks

openclaw models aliases list
openclaw models fallbacks list

​

ऑथ प्रोफ़ाइलें

openclaw models auth add
openclaw models auth list [--provider <id>] [--json]
openclaw models auth login --provider <id>
openclaw models auth login --provider openai --profile-id openai:work
openclaw models auth paste-api-key --provider <id>
openclaw models auth setup-token --provider <id>
openclaw models auth paste-token

openclaw models auth login --provider openai --set-default
openclaw models auth login --provider openai --method api-key
openclaw models auth paste-api-key --provider openai
openclaw models auth list --provider openai

• login उन providers के लिए --profile-id <id> स्वीकार करता है जो login के दौरान named profiles support करते हैं। इसे same provider के multiple logins को अलग रखने के लिए उपयोग करें।
• paste-api-key कहीं और generate की गई API keys स्वीकार करता है, key value के लिए prompt करता है, और उसे default profile id <provider>:manual में लिखता है जब तक आप --profile-id पास नहीं करते। automation में, key को stdin पर pipe करें, उदाहरण के लिए printf "%s\n" "$OPENAI_API_KEY" | openclaw models auth paste-api-key --provider openai.
• setup-token और paste-token उन providers के लिए generic token commands बने रहते हैं जो token auth methods expose करते हैं।
• setup-token को interactive TTY चाहिए और provider की token-auth method चलाता है (जब वह कोई expose करता है तो उस provider की setup-token method पर default करता है)।
• paste-token कहीं और या automation से generate की गई token string स्वीकार करता है।
• paste-token को --provider चाहिए, default रूप से token value के लिए prompt करता है, और उसे default profile id <provider>:manual में लिखता है जब तक आप --profile-id पास नहीं करते।
• automation में, token को argument के रूप में पास करने के बजाय stdin पर pipe करें ताकि provider credentials shell history या process lists में न दिखें।
• paste-token --expires-in <duration> 365d या 12h जैसी relative duration से absolute token expiry store करता है।
• openai के लिए, OpenAI API keys और ChatGPT/OAuth token material अलग auth shapes हैं। sk-... OpenAI API keys के लिए paste-api-key और केवल token auth material के लिए paste-token उपयोग करें।
• Anthropic note: Anthropic staff ने हमें बताया कि OpenClaw-style Claude CLI usage फिर से allowed है, इसलिए OpenClaw Claude CLI reuse और claude -p usage को इस integration के लिए sanctioned मानता है जब तक Anthropic कोई नई policy publish नहीं करता।
• Anthropic setup-token / paste-token supported OpenClaw token path के रूप में उपलब्ध रहते हैं, लेकिन OpenClaw अब उपलब्ध होने पर Claude CLI reuse और claude -p को prefer करता है।

​

संबंधित

• CLI reference
• Model selection
• Model failover