--- read_when: - आपको प्रदाता-दर-प्रदाता मॉडल सेटअप संदर्भ चाहिए - आप मॉडल प्रदाताओं के लिए उदाहरण कॉन्फ़िग या CLI ऑनबोर्डिंग कमांड चाहते हैं sidebarTitle: Model providers summary: मॉडल प्रदाता का अवलोकन, उदाहरण कॉन्फ़िग और CLI फ़्लो के साथ title: मॉडल प्रदाता x-i18n: generated_at: "2026-07-04T03:48:30Z" model: gpt-5.5 postprocess_version: locale-links-v1 provider: openai source_hash: 410c92229de01cbb2be185e6cd1e2a07e554c7c5aacb356f4a9ffd1bce268de2 source_path: concepts/model-providers.md workflow: 16 --- **LLM/मॉडल प्रदाताओं** के लिए संदर्भ (WhatsApp/Telegram जैसे चैट चैनल नहीं)। मॉडल चयन नियमों के लिए, [मॉडल](/hi/concepts/models) देखें। ## त्वरित नियम - मॉडल refs `provider/model` का उपयोग करते हैं (उदाहरण: `opencode/claude-opus-4-6`)। - सेट होने पर `agents.defaults.models` allowlist की तरह काम करता है। - CLI helpers: `openclaw onboard`, `openclaw models list`, `openclaw models set `। - `models.providers.*.contextWindow` / `contextTokens` / `maxTokens` प्रदाता-स्तर के डिफ़ॉल्ट सेट करते हैं; `models.providers.*.models[].contextWindow` / `contextTokens` / `maxTokens` उन्हें प्रति मॉडल override करते हैं। - Fallback नियम, cooldown probes, और session-override persistence: [मॉडल failover](/hi/concepts/model-failover)। जब आप कोई प्रदाता जोड़ते हैं या फिर से auth करते हैं, तो `openclaw configure` मौजूदा `agents.defaults.model.primary` को सुरक्षित रखता है। `openclaw models auth login` भी ऐसा ही करता है, जब तक आप `--set-default` पास न करें। प्रदाता plugins अपने auth config patch में अभी भी अनुशंसित डिफ़ॉल्ट मॉडल लौटा सकते हैं, लेकिन जब कोई प्राथमिक मॉडल पहले से मौजूद हो, तो OpenClaw इसे "इस मॉडल को उपलब्ध कराएं" के रूप में मानता है, "वर्तमान प्राथमिक मॉडल को बदलें" के रूप में नहीं। डिफ़ॉल्ट मॉडल को जानबूझकर बदलने के लिए, `openclaw models set ` या `openclaw models auth login --provider --set-default` का उपयोग करें। OpenAI-family routes prefix-specific हैं: - `openai/` डिफ़ॉल्ट रूप से agent turns के लिए native Codex app-server harness का उपयोग करता है। यह सामान्य ChatGPT/Codex subscription setup है। - legacy Codex model refs legacy config हैं जिन्हें doctor `openai/` में फिर से लिखता है। - `openai/` प्लस provider/model `agentRuntime.id: "openclaw"` स्पष्ट API-key या compatibility routes के लिए OpenClaw के built-in runtime का उपयोग करता है। [OpenAI](/hi/providers/openai) और [Codex harness](/hi/plugins/codex-harness) देखें। अगर provider/runtime विभाजन भ्रमित करता है, तो पहले [Agent runtimes](/hi/concepts/agent-runtimes) पढ़ें। Plugin auto-enable समान सीमा का पालन करता है: `openai/*` agent refs डिफ़ॉल्ट route के लिए Codex plugin सक्षम करते हैं, और स्पष्ट provider/model `agentRuntime.id: "codex"` या legacy `codex/` refs को भी इसकी आवश्यकता होती है। GPT-5.5 डिफ़ॉल्ट रूप से `openai/gpt-5.5` पर native Codex app-server harness के माध्यम से उपलब्ध है, और OpenClaw runtime के माध्यम से तब उपलब्ध है जब provider/model runtime policy स्पष्ट रूप से `openclaw` चुनती है। CLI runtimes समान विभाजन का उपयोग करते हैं: `anthropic/claude-*` या `google/gemini-*` जैसे canonical model refs चुनें, फिर जब आपको local CLI backend चाहिए तो provider/model runtime policy को `claude-cli` या `google-gemini-cli` पर सेट करें। Legacy `claude-cli/*` और `google-gemini-cli/*` refs runtime को अलग से दर्ज रखते हुए canonical provider refs में वापस migrate होते हैं। Legacy `codex-cli/*` refs `openai/*` में migrate होते हैं और Codex app-server route का उपयोग करते हैं; OpenClaw अब bundled Codex CLI backend नहीं रखता। ## Plugin-स्वामित्व वाला प्रदाता व्यवहार अधिकांश प्रदाता-विशिष्ट logic provider plugins (`registerProvider(...)`) में रहता है, जबकि OpenClaw generic inference loop रखता है। Plugins onboarding, model catalogs, auth env-var mapping, transport/config normalization, tool-schema cleanup, failover classification, OAuth refresh, usage reporting, thinking/reasoning profiles, और बहुत कुछ own करते हैं। provider-SDK hooks और bundled-plugin उदाहरणों की पूरी सूची [Provider plugins](/hi/plugins/sdk-provider-plugins) में है। ऐसा प्रदाता जिसे पूरी तरह custom request executor चाहिए, एक अलग, गहरा extension surface है। Provider-owned runner behavior replay policy, tool-schema normalization, stream wrapping, और transport/request helpers जैसे explicit provider hooks पर रहता है। legacy `ProviderPlugin.capabilities` static bag केवल compatibility के लिए है और अब shared runner logic द्वारा पढ़ा नहीं जाता। ## API key rotation कई keys इस तरह configure करें: - `OPENCLAW_LIVE__KEY` (single live override, सर्वोच्च priority) - `_API_KEYS` (comma या semicolon list) - `_API_KEY` (primary key) - `_API_KEY_*` (numbered list, जैसे `_API_KEY_1`) Google providers के लिए, `GOOGLE_API_KEY` fallback के रूप में भी शामिल है। Key selection order priority को सुरक्षित रखता है और values को deduplicate करता है। - Requests को अगली key के साथ केवल rate-limit responses पर retry किया जाता है (उदाहरण के लिए `429`, `rate_limit`, `quota`, `resource exhausted`, `Too many concurrent requests`, `ThrottlingException`, `concurrency limit reached`, `workers_ai ... quota limit exceeded`, या periodic usage-limit messages)। - Non-rate-limit failures तुरंत fail होते हैं; कोई key rotation attempt नहीं किया जाता। - जब सभी candidate keys fail हो जाती हैं, तो अंतिम error last attempt से लौटाया जाता है। ## आधिकारिक प्रदाता plugins आधिकारिक प्रदाता plugins अपनी model catalog rows publish करते हैं। इन providers को **कोई** `models.providers` model entries नहीं चाहिए; provider plugin सक्षम करें, auth सेट करें, और model चुनें। `models.providers` का उपयोग केवल explicit custom providers या timeouts जैसी narrow request settings के लिए करें। ### OpenAI - Provider: `openai` - Auth: `OPENAI_API_KEY` - Optional rotation: `OPENAI_API_KEYS`, `OPENAI_API_KEY_1`, `OPENAI_API_KEY_2`, plus `OPENCLAW_LIVE_OPENAI_KEY` (single override) - Example models: `openai/gpt-5.5`, `openai/gpt-5.4-mini` - अगर कोई specific install या API key अलग व्यवहार करती है, तो `openclaw models list --provider openai` से account/model availability verify करें। - CLI: `openclaw onboard --auth-choice openai-api-key` - Default transport `auto` है; OpenClaw transport choice को shared model runtime को pass करता है। - प्रति मॉडल `agents.defaults.models["openai/"].params.transport` (`"sse"`, `"websocket"`, या `"auto"`) के माध्यम से override करें - OpenAI priority processing को `agents.defaults.models["openai/"].params.serviceTier` के माध्यम से enabled किया जा सकता है - `/fast` और `params.fastMode` direct `openai/*` Responses requests को `api.openai.com` पर `service_tier=priority` से map करते हैं - जब shared `/fast` toggle की जगह explicit tier चाहिए, तो `params.serviceTier` का उपयोग करें - Hidden OpenClaw attribution headers (`originator`, `version`, `User-Agent`) केवल `api.openai.com` पर native OpenAI traffic पर apply होते हैं, generic OpenAI-compatible proxies पर नहीं - Native OpenAI routes Responses `store`, prompt-cache hints, और OpenAI reasoning-compat payload shaping भी रखते हैं; proxy routes नहीं रखते - `openai/gpt-5.3-codex-spark` ChatGPT/Codex OAuth subscription auth के माध्यम से तब उपलब्ध है जब आपका signed-in account इसे expose करता है; OpenClaw अभी भी इस model के लिए direct OpenAI API-key और Azure API-key routes suppress करता है क्योंकि वे transports इसे reject करते हैं ```json5 { agents: { defaults: { model: { primary: "openai/gpt-5.5" } } }, } ``` ### Anthropic - Provider: `anthropic` - Auth: `ANTHROPIC_API_KEY` - Optional rotation: `ANTHROPIC_API_KEYS`, `ANTHROPIC_API_KEY_1`, `ANTHROPIC_API_KEY_2`, plus `OPENCLAW_LIVE_ANTHROPIC_KEY` (single override) - Example model: `anthropic/claude-opus-4-6` - CLI: `openclaw onboard --auth-choice apiKey` - Direct public Anthropic requests shared `/fast` toggle और `params.fastMode` को support करते हैं, जिसमें `api.anthropic.com` को भेजा गया API-key और OAuth-authenticated traffic शामिल है; OpenClaw इसे Anthropic `service_tier` (`auto` vs `standard_only`) से map करता है - Preferred Claude CLI config model ref को canonical रखता है और CLI backend को अलग से चुनता है: `anthropic/claude-opus-4-8` with model-scoped `agentRuntime.id: "claude-cli"`। Legacy `claude-cli/claude-opus-4-7` refs compatibility के लिए अभी भी काम करते हैं। Anthropic staff ने हमें बताया कि OpenClaw-style Claude CLI usage फिर से allowed है, इसलिए OpenClaw इस integration के लिए Claude CLI reuse और `claude -p` usage को sanctioned मानता है, जब तक Anthropic कोई नई policy publish न करे। Anthropic setup-token supported OpenClaw token path के रूप में उपलब्ध रहता है, लेकिन OpenClaw अब उपलब्ध होने पर Claude CLI reuse और `claude -p` को prefer करता है। ```json5 { agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } }, } ``` ### OpenAI ChatGPT/Codex OAuth - Provider: `openai` - Auth: OAuth (ChatGPT) - Legacy OpenAI Codex model ref: `openai/gpt-5.5` - Native Codex app-server harness ref: `openai/gpt-5.5` - Native Codex app-server harness docs: [Codex harness](/hi/plugins/codex-harness) - Legacy model refs: `codex/gpt-*` - Plugin boundary: `openai/*` OpenAI plugin load करता है; native Codex app-server plugin Codex harness runtime द्वारा select किया जाता है। - CLI: `openclaw onboard --auth-choice openai` or `openclaw models auth login --provider openai` - Default transport `auto` है (WebSocket-first, SSE fallback) - प्रति OpenAI Codex model `agents.defaults.models["openai/"].params.transport` (`"sse"`, `"websocket"`, या `"auto"`) के माध्यम से override करें - `params.serviceTier` native Codex Responses requests (`chatgpt.com/backend-api`) पर भी forward किया जाता है - Hidden OpenClaw attribution headers (`originator`, `version`, `User-Agent`) केवल `chatgpt.com/backend-api` पर native Codex traffic में attached होते हैं, generic OpenAI-compatible proxies पर नहीं - direct `openai/*` जैसा ही `/fast` toggle और `params.fastMode` config share करता है; OpenClaw इसे `service_tier=priority` से map करता है - `openai/gpt-5.5` Codex catalog native `contextWindow = 400000` और default runtime `contextTokens = 272000` का उपयोग करता है; runtime cap को `models.providers.openai.models[].contextTokens` से override करें - Policy note: OpenAI Codex OAuth OpenClaw जैसे external tools/workflows के लिए explicitly supported है। - common subscription plus native Codex runtime route के लिए, `openai` auth से sign in करें और `openai/gpt-5.5` configure करें; OpenAI agent turns default रूप से Codex select करते हैं। - provider/model `agentRuntime.id: "openclaw"` का उपयोग केवल तब करें जब आपको built-in OpenClaw route चाहिए; otherwise `openai/gpt-5.5` को default Codex harness पर रखें। - legacy Codex GPT refs legacy state हैं, live provider route नहीं। नए agent config के लिए native Codex runtime पर `openai/gpt-5.5` का उपयोग करें, और old legacy Codex model refs को canonical `openai/*` refs में migrate करने के लिए `openclaw doctor --fix` चलाएं। ```json5 { plugins: { entries: { codex: { enabled: true } } }, agents: { defaults: { model: { primary: "openai/gpt-5.5" }, }, }, } ``` ```json5 { models: { providers: { openai: { models: [{ id: "gpt-5.5", contextTokens: 160000 }], }, }, }, } ``` ### अन्य subscription-style hosted options Z.AI Coding Plan या general API endpoints। MiniMax Coding Plan OAuth या API key access। Qwen Cloud provider surface plus Alibaba DashScope और Coding Plan endpoint mapping। ### OpenCode - Auth: `OPENCODE_API_KEY` (or `OPENCODE_ZEN_API_KEY`) - Zen runtime provider: `opencode` - Go runtime provider: `opencode-go` - Example models: `opencode/claude-opus-4-6`, `opencode-go/kimi-k2.6` - CLI: `openclaw onboard --auth-choice opencode-zen` or `openclaw onboard --auth-choice opencode-go` ```json5 { agents: { defaults: { model: { primary: "opencode/claude-opus-4-6" } } }, } ``` ### Google Gemini (API key) - प्रदाता: `google` - प्रमाणीकरण: `GEMINI_API_KEY` - वैकल्पिक रोटेशन: `GEMINI_API_KEYS`, `GEMINI_API_KEY_1`, `GEMINI_API_KEY_2`, `GOOGLE_API_KEY` फ़ॉलबैक, और `OPENCLAW_LIVE_GEMINI_KEY` (एकल ओवरराइड) - उदाहरण मॉडल: `google/gemini-3.1-pro-preview`, `google/gemini-3-flash-preview` - संगतता: `google/gemini-3.1-flash-preview` का उपयोग करने वाला लेगेसी OpenClaw कॉन्फ़िगरेशन `google/gemini-3-flash-preview` में सामान्यीकृत किया जाता है - उपनाम: `google/gemini-3.1-pro` स्वीकार किया जाता है और Google की लाइव Gemini API id, `google/gemini-3.1-pro-preview`, में सामान्यीकृत किया जाता है - CLI: `openclaw onboard --auth-choice gemini-api-key` - सोच: `/think adaptive` Google dynamic thinking का उपयोग करता है। Gemini 3/3.1 एक निश्चित `thinkingLevel` छोड़ देते हैं; Gemini 2.5 `thinkingBudget: -1` भेजता है। - सीधे Gemini रन भी `agents.defaults.models["google/"].params.cachedContent` (या लेगेसी `cached_content`) स्वीकार करते हैं, ताकि प्रदाता-नेटिव `cachedContents/...` हैंडल आगे भेजा जा सके; Gemini कैश हिट OpenClaw `cacheRead` के रूप में दिखते हैं ### Google Vertex और Gemini CLI - प्रदाता: `google-vertex`, `google-gemini-cli` - प्रमाणीकरण: Vertex gcloud ADC का उपयोग करता है; Gemini CLI अपने OAuth फ़्लो का उपयोग करता है OpenClaw में Gemini CLI OAuth एक अनौपचारिक इंटीग्रेशन है। कुछ उपयोगकर्ताओं ने तृतीय-पक्ष क्लाइंट का उपयोग करने के बाद Google खाते पर प्रतिबंधों की सूचना दी है। आगे बढ़ने का चुनाव करने पर Google की शर्तों की समीक्षा करें और गैर-महत्वपूर्ण खाते का उपयोग करें। Gemini CLI OAuth बंडल किए गए `google` Plugin के हिस्से के रूप में भेजा जाता है। ```bash brew install gemini-cli ``` ```bash npm install -g @google/gemini-cli ``` ```bash openclaw plugins enable google ``` ```bash openclaw models auth login --provider google-gemini-cli --set-default ``` डिफ़ॉल्ट मॉडल: `google-gemini-cli/gemini-3-flash-preview`। आप `openclaw.json` में कोई client id या secret पेस्ट **नहीं** करते। CLI लॉगिन फ़्लो Gateway होस्ट पर auth profiles में टोकन संग्रहीत करता है। यदि लॉगिन के बाद अनुरोध विफल हों, तो Gateway होस्ट पर `GOOGLE_CLOUD_PROJECT` या `GOOGLE_CLOUD_PROJECT_ID` सेट करें। Gemini CLI डिफ़ॉल्ट रूप से `stream-json` का उपयोग करता है। OpenClaw assistant stream संदेश पढ़ता है और `stats.cached` को `cacheRead` में सामान्यीकृत करता है; लेगेसी `--output-format json` ओवरराइड अभी भी `response` से उत्तर टेक्स्ट पढ़ते हैं। ### Z.AI (GLM) - प्रदाता: `zai` - प्रमाणीकरण: `ZAI_API_KEY` - उदाहरण मॉडल: `zai/glm-5.2` - CLI: `openclaw onboard --auth-choice zai-api-key` - मॉडल refs canonical `zai/*` प्रदाता ID का उपयोग करते हैं। - `zai-api-key` मेल खाते Z.AI endpoint को स्वतः पहचानता है; `zai-coding-global`, `zai-coding-cn`, `zai-global`, और `zai-cn` किसी विशिष्ट सतह को बाध्य करते हैं ### Vercel AI Gateway - प्रदाता: `vercel-ai-gateway` - प्रमाणीकरण: `AI_GATEWAY_API_KEY` - उदाहरण मॉडल: `vercel-ai-gateway/anthropic/claude-opus-4.6`, `vercel-ai-gateway/moonshotai/kimi-k2.6` - CLI: `openclaw onboard --auth-choice ai-gateway-api-key` ### अन्य बंडल किए गए प्रदाता Plugin | प्रदाता | Id | Auth env | उदाहरण मॉडल | | --------------------------------------- | -------------------------------- | ---------------------------------------------------- | ---------------------------------------------------------- | | BytePlus | `byteplus` / `byteplus-plan` | `BYTEPLUS_API_KEY` | `byteplus-plan/ark-code-latest` | | ClawRouter | `clawrouter` | `CLAWROUTER_API_KEY` | `clawrouter/anthropic/claude-sonnet-4-6` | | Cohere | `cohere` | `COHERE_API_KEY` | `cohere/command-a-03-2025` | | GitHub Copilot | `github-copilot` | `COPILOT_GITHUB_TOKEN` / `GH_TOKEN` / `GITHUB_TOKEN` | - | | Hugging Face Inference | `huggingface` | `HUGGINGFACE_HUB_TOKEN` या `HF_TOKEN` | `huggingface/deepseek-ai/DeepSeek-R1` | | MiniMax | `minimax` / `minimax-portal` | `MINIMAX_API_KEY` / `MINIMAX_OAUTH_TOKEN` | `minimax/MiniMax-M3` | | Mistral | `mistral` | `MISTRAL_API_KEY` | `mistral/mistral-large-latest` | | Moonshot | `moonshot` | `MOONSHOT_API_KEY` | `moonshot/kimi-k2.6` | | NVIDIA | `nvidia` | `NVIDIA_API_KEY` | `nvidia/nvidia/nemotron-3-ultra-550b-a55b` | | NovitaAI | `novita` | `NOVITA_API_KEY` | `novita/deepseek/deepseek-v3-0324` | | [Ollama Cloud](/hi/providers/ollama-cloud) | `ollama-cloud` | `OLLAMA_API_KEY` | `ollama-cloud/kimi-k2.6` | | OpenRouter | `openrouter` | OpenRouter OAuth या `OPENROUTER_API_KEY` | `openrouter/auto` | | [Qwen OAuth](/hi/providers/qwen-oauth) | `qwen-oauth` | `QWEN_API_KEY` | `qwen-oauth/qwen3.5-plus` | | Together | `together` | `TOGETHER_API_KEY` | `together/meta-llama/Llama-3.3-70B-Instruct-Turbo` | | Venice | `venice` | `VENICE_API_KEY` | - | | Vercel AI Gateway | `vercel-ai-gateway` | `AI_GATEWAY_API_KEY` | `vercel-ai-gateway/anthropic/claude-opus-4.6` | | Volcano Engine (Doubao) | `volcengine` / `volcengine-plan` | `VOLCANO_ENGINE_API_KEY` | `volcengine-plan/ark-code-latest` | | xAI | `xai` | SuperGrok/X Premium OAuth या `XAI_API_KEY` | `xai/grok-4.3` | | Xiaomi | `xiaomi` / `xiaomi-token-plan` | `XIAOMI_API_KEY` / `XIAOMI_TOKEN_PLAN_API_KEY` | `xiaomi/mimo-v2-flash` / `xiaomi-token-plan/mimo-v2.5-pro` | #### जानने योग्य विशेषताएँ अपने app-attribution headers और Anthropic `cache_control` मार्कर केवल सत्यापित `openrouter.ai` routes पर लागू करता है। DeepSeek, Moonshot, और ZAI refs OpenRouter-प्रबंधित prompt caching के लिए cache-TTL योग्य हैं, लेकिन Anthropic cache markers प्राप्त नहीं करते। proxy-शैली OpenAI-संगत पथ के रूप में, यह native-OpenAI-only shaping (`serviceTier`, Responses `store`, prompt-cache hints, OpenAI reasoning-compat) को छोड़ देता है। Gemini-backed refs केवल proxy-Gemini thought-signature sanitation रखते हैं। Gemini-backed refs वही proxy-Gemini sanitation पथ अपनाते हैं; `kilocode/kilo/auto` और अन्य proxy-reasoning-unsupported refs proxy reasoning injection छोड़ देते हैं। API-key onboarding स्पष्ट M3 और M2.7 chat model definitions लिखता है; image understanding Plugin-स्वामित्व वाले `MiniMax-VL-01` media provider पर रहती है। Model ids `nvidia//` namespace का उपयोग करते हैं (उदाहरण के लिए `nvidia/nvidia/nemotron-...` के साथ `nvidia/moonshotai/kimi-k2.5`); pickers शाब्दिक `/` composition को सुरक्षित रखते हैं, जबकि API को भेजी गई canonical key single-prefixed रहती है। xAI Responses पथ का उपयोग करता है। अनुशंसित पथ SuperGrok/X Premium OAuth है; API keys अभी भी `XAI_API_KEY` या Plugin config के माध्यम से काम करती हैं, और Grok `web_search` API-key fallback से पहले उसी auth profile का पुनः उपयोग करता है। `grok-4.3` बंडल किया गया डिफ़ॉल्ट chat model है, और `grok-build-0.1` build/coding-केंद्रित कार्य के लिए चयन योग्य है। `/fast` या `params.fastMode: true` `grok-3`, `grok-3-mini`, `grok-4`, और `grok-4-0709` को उनके `*-fast` variants में फिर से लिखता है। `tool_stream` डिफ़ॉल्ट रूप से चालू है; `agents.defaults.models["xai/"].params.tool_stream=false` के माध्यम से अक्षम करें। ## `models.providers` के माध्यम से प्रदाता (custom/base URL) **custom** प्रदाताओं या OpenAI/Anthropic-संगत proxies को जोड़ने के लिए `models.providers` (या `models.json`) का उपयोग करें। नीचे दिए गए कई बंडल किए गए प्रदाता Plugin पहले से ही डिफ़ॉल्ट कैटलॉग प्रकाशित करते हैं। स्पष्ट `models.providers.` प्रविष्टियों का उपयोग केवल तब करें जब आप डिफ़ॉल्ट बेस URL, हेडर, या मॉडल सूची को ओवरराइड करना चाहते हों। Gateway मॉडल क्षमता जांचें स्पष्ट `models.providers..models[]` मेटाडेटा भी पढ़ती हैं। यदि कोई कस्टम या प्रॉक्सी मॉडल इमेज स्वीकार करता है, तो उस मॉडल पर `input: ["text", "image"]` सेट करें ताकि WebChat और node-origin अटैचमेंट पाथ इमेज को टेक्स्ट-ओनली मीडिया रेफ के बजाय नेटिव मॉडल इनपुट के रूप में पास करें। `agents.defaults.models["provider/model"]` केवल एजेंट के लिए मॉडल दृश्यता, उपनाम, और प्रति-मॉडल मेटाडेटा नियंत्रित करता है। यह अपने आप नया रनटाइम मॉडल रजिस्टर नहीं करता। कस्टम प्रदाता मॉडलों के लिए, कम से कम मिलते-जुलते `id` के साथ `models.providers..models[]` भी जोड़ें। ### Moonshot AI (Kimi) ऑनबोर्डिंग से पहले `@openclaw/moonshot-provider` इंस्टॉल करें। स्पष्ट `models.providers.moonshot` प्रविष्टि केवल तब जोड़ें जब आपको बेस URL या मॉडल मेटाडेटा ओवरराइड करना हो: - प्रदाता: `moonshot` - प्रमाणीकरण: `MOONSHOT_API_KEY` - उदाहरण मॉडल: `moonshot/kimi-k2.6` - CLI: `openclaw onboard --auth-choice moonshot-api-key` या `openclaw onboard --auth-choice moonshot-api-key-cn` Kimi K2 मॉडल आईडी: [//]: # "moonshot-kimi-k2-model-refs:start" - `moonshot/kimi-k2.6` - `moonshot/kimi-k2.7-code` - `moonshot/kimi-k2.5` - `moonshot/kimi-k2-thinking` - `moonshot/kimi-k2-thinking-turbo` - `moonshot/kimi-k2-turbo` [//]: # "moonshot-kimi-k2-model-refs:end" ```json5 { agents: { defaults: { model: { primary: "moonshot/kimi-k2.6" } }, }, models: { mode: "merge", providers: { moonshot: { baseUrl: "https://api.moonshot.ai/v1", apiKey: "${MOONSHOT_API_KEY}", api: "openai-completions", models: [{ id: "kimi-k2.6", name: "Kimi K2.6" }], }, }, }, } ``` ### Kimi कोडिंग Kimi Coding Moonshot AI के Anthropic-संगत एंडपॉइंट का उपयोग करता है: - प्रदाता: `kimi` - प्रमाणीकरण: `KIMI_API_KEY` - उदाहरण मॉडल: `kimi/kimi-for-coding` ```json5 { env: { KIMI_API_KEY: "sk-..." }, agents: { defaults: { model: { primary: "kimi/kimi-for-coding" } }, }, } ``` लेगेसी `kimi/kimi-code` और `kimi/k2p5` संगतता मॉडल आईडी के रूप में स्वीकार किए जाते हैं और Kimi की स्थिर API मॉडल आईडी में सामान्यीकृत होते हैं। ### Volcano Engine (Doubao) Volcano Engine (火山引擎) चीन में Doubao और अन्य मॉडलों तक पहुंच प्रदान करता है। - प्रदाता: `volcengine` (कोडिंग: `volcengine-plan`) - प्रमाणीकरण: `VOLCANO_ENGINE_API_KEY` - उदाहरण मॉडल: `volcengine-plan/ark-code-latest` - CLI: `openclaw onboard --auth-choice volcengine-api-key` ```json5 { agents: { defaults: { model: { primary: "volcengine-plan/ark-code-latest" } }, }, } ``` ऑनबोर्डिंग डिफ़ॉल्ट रूप से कोडिंग सतह पर रहती है, लेकिन सामान्य `volcengine/*` कैटलॉग उसी समय पंजीकृत होता है। ऑनबोर्डिंग/कॉन्फ़िगर मॉडल पिकर में, Volcengine प्रमाणीकरण विकल्प `volcengine/*` और `volcengine-plan/*` दोनों पंक्तियों को प्राथमिकता देता है। अगर वे मॉडल अभी लोड नहीं हुए हैं, तो OpenClaw खाली प्रदाता-स्कोप्ड पिकर दिखाने के बजाय बिना फ़िल्टर वाले कैटलॉग पर वापस चला जाता है। - `volcengine/doubao-seed-1-8-251228` (Doubao Seed 1.8) - `volcengine/doubao-seed-code-preview-251028` - `volcengine/kimi-k2-5-260127` (Kimi K2.5) - `volcengine/glm-4-7-251222` (GLM 4.7) - `volcengine/deepseek-v3-2-251201` (DeepSeek V3.2 128K) - `volcengine-plan/ark-code-latest` - `volcengine-plan/doubao-seed-code` - `volcengine-plan/kimi-k2.5` - `volcengine-plan/kimi-k2-thinking` - `volcengine-plan/glm-4.7` ### BytePlus (अंतरराष्ट्रीय) BytePlus ARK अंतरराष्ट्रीय उपयोगकर्ताओं के लिए Volcano Engine जैसे ही मॉडल तक पहुंच प्रदान करता है। - प्रदाता: `byteplus` (कोडिंग: `byteplus-plan`) - प्रमाणीकरण: `BYTEPLUS_API_KEY` - उदाहरण मॉडल: `byteplus-plan/ark-code-latest` - CLI: `openclaw onboard --auth-choice byteplus-api-key` ```json5 { agents: { defaults: { model: { primary: "byteplus-plan/ark-code-latest" } }, }, } ``` ऑनबोर्डिंग डिफ़ॉल्ट रूप से कोडिंग सतह पर रहती है, लेकिन सामान्य `byteplus/*` कैटलॉग उसी समय पंजीकृत होता है। ऑनबोर्डिंग/कॉन्फ़िगर मॉडल पिकर में, BytePlus प्रमाणीकरण विकल्प `byteplus/*` और `byteplus-plan/*` दोनों पंक्तियों को प्राथमिकता देता है। अगर वे मॉडल अभी लोड नहीं हुए हैं, तो OpenClaw खाली प्रदाता-स्कोप्ड पिकर दिखाने के बजाय बिना फ़िल्टर वाले कैटलॉग पर वापस चला जाता है। - `byteplus/seed-1-8-251228` (Seed 1.8) - `byteplus/kimi-k2-5-260127` (Kimi K2.5) - `byteplus/glm-4-7-251222` (GLM 4.7) - `byteplus-plan/ark-code-latest` - `byteplus-plan/doubao-seed-code` - `byteplus-plan/kimi-k2.5` - `byteplus-plan/kimi-k2-thinking` - `byteplus-plan/glm-4.7` ### Synthetic Synthetic `synthetic` प्रदाता के पीछे Anthropic-संगत मॉडल प्रदान करता है: - प्रदाता: `synthetic` - प्रमाणीकरण: `SYNTHETIC_API_KEY` - उदाहरण मॉडल: `synthetic/hf:MiniMaxAI/MiniMax-M2.5` - CLI: `openclaw onboard --auth-choice synthetic-api-key` ```json5 { agents: { defaults: { model: { primary: "synthetic/hf:MiniMaxAI/MiniMax-M2.5" } }, }, models: { mode: "merge", providers: { synthetic: { baseUrl: "https://api.synthetic.new/anthropic", apiKey: "${SYNTHETIC_API_KEY}", api: "anthropic-messages", models: [{ id: "hf:MiniMaxAI/MiniMax-M2.5", name: "MiniMax M2.5" }], }, }, }, } ``` ### MiniMax MiniMax को `models.providers` के माध्यम से कॉन्फ़िगर किया जाता है क्योंकि यह कस्टम एंडपॉइंट का उपयोग करता है: - MiniMax OAuth (वैश्विक): `--auth-choice minimax-global-oauth` - MiniMax OAuth (CN): `--auth-choice minimax-cn-oauth` - MiniMax API कुंजी (वैश्विक): `--auth-choice minimax-global-api` - MiniMax API कुंजी (CN): `--auth-choice minimax-cn-api` - प्रमाणीकरण: `minimax` के लिए `MINIMAX_API_KEY`; `minimax-portal` के लिए `MINIMAX_OAUTH_TOKEN` या `MINIMAX_API_KEY` सेटअप विवरण, मॉडल विकल्पों, और कॉन्फ़िग स्निपेट के लिए [/providers/minimax](/hi/providers/minimax) देखें। MiniMax के Anthropic-संगत स्ट्रीमिंग पथ पर, OpenClaw M2.x परिवार के लिए डिफ़ॉल्ट रूप से थिंकिंग अक्षम कर देता है, जब तक कि आप इसे स्पष्ट रूप से सेट न करें; MiniMax-M3 (और M3.x) डिफ़ॉल्ट रूप से प्रदाता के छोड़े गए/अनुकूली थिंकिंग पथ पर रहता है। `/fast on` `MiniMax-M2.7` को `MiniMax-M2.7-highspeed` में फिर से लिखता है। Plugin-स्वामित्व वाला क्षमता विभाजन: - टेक्स्ट/चैट डिफ़ॉल्ट `minimax/MiniMax-M3` पर रहते हैं - छवि जनरेशन `minimax/image-01` या `minimax-portal/image-01` है - छवि समझना दोनों MiniMax प्रमाणीकरण पथों पर Plugin-स्वामित्व वाला `MiniMax-VL-01` है - वेब खोज प्रदाता id `minimax` पर रहती है ### LM Studio LM Studio एक बंडल प्रदाता Plugin के रूप में शिप होता है, जो नेटिव API का उपयोग करता है: - प्रदाता: `lmstudio` - प्रमाणीकरण: `LM_API_TOKEN` - डिफ़ॉल्ट इन्फ़रेंस बेस URL: `http://localhost:1234/v1` फिर एक मॉडल सेट करें (`http://localhost:1234/api/v1/models` द्वारा लौटाए गए IDs में से किसी एक से बदलें): ```json5 { agents: { defaults: { model: { primary: "lmstudio/openai/gpt-oss-20b" } }, }, } ``` OpenClaw खोज + ऑटो-लोड के लिए LM Studio के नेटिव `/api/v1/models` और `/api/v1/models/load` का उपयोग करता है, और डिफ़ॉल्ट रूप से इन्फ़रेंस के लिए `/v1/chat/completions` का उपयोग करता है। अगर आप चाहते हैं कि LM Studio JIT लोडिंग, TTL, और ऑटो-इविक्ट मॉडल जीवनचक्र का स्वामी हो, तो `models.providers.lmstudio.params.preload: false` सेट करें। सेटअप और समस्या निवारण के लिए [/providers/lmstudio](/hi/providers/lmstudio) देखें। ### Ollama Ollama एक बंडल प्रदाता Plugin के रूप में शिप होता है और Ollama के नेटिव API का उपयोग करता है: - प्रदाता: `ollama` - प्रमाणीकरण: आवश्यक नहीं (स्थानीय सर्वर) - उदाहरण मॉडल: `ollama/llama3.3` - इंस्टॉलेशन: [https://ollama.com/download](https://ollama.com/download) ```bash # Install Ollama, then pull a model: ollama pull llama3.3 ``` ```json5 { agents: { defaults: { model: { primary: "ollama/llama3.3" } }, }, } ``` जब आप `OLLAMA_API_KEY` के साथ ऑप्ट इन करते हैं, तो Ollama स्थानीय रूप से `http://127.0.0.1:11434` पर पहचाना जाता है, और बंडल प्रदाता Plugin Ollama को सीधे `openclaw onboard` और मॉडल पिकर में जोड़ता है। ऑनबोर्डिंग, क्लाउड/स्थानीय मोड, और कस्टम कॉन्फ़िगरेशन के लिए [/providers/ollama](/hi/providers/ollama) देखें। ### vLLM vLLM स्थानीय/स्व-होस्टेड OpenAI-संगत सर्वरों के लिए एक बंडल प्रदाता Plugin के रूप में शिप होता है: - प्रदाता: `vllm` - प्रमाणीकरण: वैकल्पिक (आपके सर्वर पर निर्भर) - डिफ़ॉल्ट बेस URL: `http://127.0.0.1:8000/v1` स्थानीय रूप से ऑटो-डिस्कवरी में ऑप्ट इन करने के लिए (अगर आपका सर्वर प्रमाणीकरण लागू नहीं करता है, तो कोई भी मान चलेगा): ```bash export VLLM_API_KEY="vllm-local" ``` फिर एक मॉडल सेट करें (`/v1/models` द्वारा लौटाए गए IDs में से किसी एक से बदलें): ```json5 { agents: { defaults: { model: { primary: "vllm/your-model-id" } }, }, } ``` विवरण के लिए [/providers/vllm](/hi/providers/vllm) देखें। ### SGLang SGLang तेज़ स्व-होस्टेड OpenAI-संगत सर्वरों के लिए एक बंडल प्रदाता Plugin के रूप में शिप होता है: - प्रदाता: `sglang` - प्रमाणीकरण: वैकल्पिक (आपके सर्वर पर निर्भर) - डिफ़ॉल्ट बेस URL: `http://127.0.0.1:30000/v1` स्थानीय रूप से ऑटो-डिस्कवरी में ऑप्ट इन करने के लिए (अगर आपका सर्वर प्रमाणीकरण लागू नहीं करता है, तो कोई भी मान चलेगा): ```bash export SGLANG_API_KEY="sglang-local" ``` फिर एक मॉडल सेट करें (`/v1/models` द्वारा लौटाए गए IDs में से किसी एक से बदलें): ```json5 { agents: { defaults: { model: { primary: "sglang/your-model-id" } }, }, } ``` विवरण के लिए [/providers/sglang](/hi/providers/sglang) देखें। ### स्थानीय प्रॉक्सी (LM Studio, vLLM, LiteLLM, आदि) उदाहरण (OpenAI-संगत): ```json5 { agents: { defaults: { model: { primary: "lmstudio/my-local-model" }, models: { "lmstudio/my-local-model": { alias: "Local" } }, }, }, models: { providers: { lmstudio: { baseUrl: "http://localhost:1234/v1", apiKey: "${LM_API_TOKEN}", api: "openai-completions", timeoutSeconds: 300, models: [ { id: "my-local-model", name: "Local Model", reasoning: false, input: ["text"], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, contextWindow: 200000, maxTokens: 8192, }, ], }, }, }, } ``` कस्टम प्रदाताओं के लिए, `reasoning`, `input`, `cost`, `contextWindow`, और `maxTokens` वैकल्पिक हैं। छोड़े जाने पर, OpenClaw डिफ़ॉल्ट रूप से ये मान इस्तेमाल करता है: - `reasoning: false` - `input: ["text"]` - `cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }` - `contextWindow: 200000` - `maxTokens: 8192` अनुशंसित: ऐसे स्पष्ट मान सेट करें जो आपकी प्रॉक्सी/मॉडल सीमाओं से मेल खाते हों। - गैर-नेटिव एंडपॉइंट पर `api: "openai-completions"` के लिए (कोई भी गैर-खाली `baseUrl` जिसका होस्ट `api.openai.com` नहीं है), OpenClaw असमर्थित `developer` भूमिकाओं के लिए प्रदाता 400 त्रुटियों से बचने हेतु `compat.supportsDeveloperRole: false` को बाध्य करता है। - प्रॉक्सी-शैली OpenAI-संगत रूट नेटिव OpenAI-केवल अनुरोध आकार देने को भी छोड़ देते हैं: कोई `service_tier` नहीं, कोई Responses `store` नहीं, कोई Completions `store` नहीं, कोई प्रॉम्प्ट-कैश संकेत नहीं, कोई OpenAI reasoning-compat पेलोड आकार देना नहीं, और कोई छिपे हुए OpenClaw attribution हेडर नहीं। - वे OpenAI-संगत Completions प्रॉक्सी जिन्हें विक्रेता-विशिष्ट फ़ील्ड चाहिए, आउटबाउंड अनुरोध बॉडी में अतिरिक्त JSON मर्ज करने के लिए `agents.defaults.models["provider/model"].params.extra_body` (या `extraBody`) सेट करें। - vLLM चैट-टेम्पलेट नियंत्रणों के लिए, `agents.defaults.models["provider/model"].params.chat_template_kwargs` सेट करें। जब सत्र थिंकिंग स्तर बंद हो, तो बंडल vLLM Plugin `vllm/nemotron-3-*` के लिए स्वतः `enable_thinking: false` और `force_nonempty_content: true` भेजता है। - धीमे स्थानीय मॉडल या रिमोट LAN/tailnet होस्ट के लिए, `models.providers..timeoutSeconds` सेट करें। यह पूरे एजेंट रनटाइम टाइमआउट को बढ़ाए बिना, कनेक्ट, हेडर, बॉडी स्ट्रीमिंग, और कुल guarded-fetch abort सहित प्रदाता मॉडल HTTP अनुरोध हैंडलिंग को बढ़ाता है। अगर `agents.defaults.timeoutSeconds` या रन-विशिष्ट टाइमआउट कम है, तो वह सीमा भी बढ़ाएं; प्रदाता टाइमआउट पूरे रन को नहीं बढ़ा सकते। - मॉडल प्रदाता HTTP कॉल Surge, Clash, और sing-box fake-IP DNS उत्तरों को `198.18.0.0/15` और `fc00::/7` में केवल कॉन्फ़िगर किए गए प्रदाता `baseUrl` होस्टनाम के लिए अनुमति देते हैं। कस्टम/स्थानीय प्रदाता एंडपॉइंट guarded मॉडल अनुरोधों के लिए उसी सटीक कॉन्फ़िगर किए गए `scheme://host:port` origin पर भी भरोसा करते हैं, जिसमें loopback, LAN, और tailnet होस्ट शामिल हैं। यह कोई नया कॉन्फ़िग विकल्प नहीं है; आपके द्वारा कॉन्फ़िगर किया गया `baseUrl` केवल उस origin के लिए अनुरोध नीति बढ़ाता है। Fake-IP होस्टनाम अनुमति और exact-origin भरोसा स्वतंत्र तंत्र हैं। अन्य निजी, loopback, link-local, metadata गंतव्यों, और अलग पोर्टों को अभी भी स्पष्ट `models.providers..request.allowPrivateNetwork: true` ऑप्ट-इन चाहिए। exact-origin भरोसे से ऑप्ट आउट करने के लिए `models.providers..request.allowPrivateNetwork: false` सेट करें। - अगर `baseUrl` खाली/छोड़ा गया है, तो OpenClaw डिफ़ॉल्ट OpenAI व्यवहार रखता है (जो `api.openai.com` पर resolve होता है)। - सुरक्षा के लिए, गैर-नेटिव `openai-completions` एंडपॉइंट पर स्पष्ट `compat.supportsDeveloperRole: true` भी ओवरराइड किया जाता है। - गैर-डायरेक्ट एंडपॉइंट पर `api: "anthropic-messages"` के लिए (canonical `anthropic` के अलावा कोई भी प्रदाता, या कस्टम `models.providers.anthropic.baseUrl` जिसका होस्ट सार्वजनिक `api.anthropic.com` एंडपॉइंट नहीं है), OpenClaw `claude-code-20250219`, `interleaved-thinking-2025-05-14`, और OAuth markers जैसे implicit Anthropic beta हेडर दबा देता है, ताकि कस्टम Anthropic-संगत प्रॉक्सी असमर्थित beta flags को अस्वीकार न करें। अगर आपकी प्रॉक्सी को विशिष्ट beta सुविधाएं चाहिए, तो `models.providers..headers["anthropic-beta"]` स्पष्ट रूप से सेट करें। ## CLI उदाहरण ```bash openclaw onboard --auth-choice opencode-zen openclaw models set opencode/claude-opus-4-6 openclaw models list ``` यह भी देखें: पूर्ण कॉन्फ़िगरेशन उदाहरणों के लिए [कॉन्फ़िगरेशन](/hi/gateway/configuration)। ## संबंधित - [कॉन्फ़िगरेशन संदर्भ](/hi/gateway/config-agents#agent-defaults) - मॉडल कॉन्फ़िग कुंजियां - [मॉडल failover](/hi/concepts/model-failover) - फ़ॉलबैक श्रृंखलाएं और retry व्यवहार - [मॉडल](/hi/concepts/models) - मॉडल कॉन्फ़िगरेशन और aliases - [प्रदाता](/hi/providers) - प्रति-प्रदाता सेटअप गाइड