Concepts and configuration

मॉडल प्रदाता

LLM/मॉडल प्रदाताओं के लिए संदर्भ (WhatsApp/Telegram जैसे चैट चैनल नहीं)। मॉडल चयन नियमों के लिए, मॉडल देखें।

त्वरित नियम

मॉडल refs और CLI helpers

मॉडल refs provider/model का उपयोग करते हैं (उदाहरण: opencode/claude-opus-4-6)।
सेट होने पर agents.defaults.models allowlist की तरह काम करता है।
CLI helpers: openclaw onboard, openclaw models list, openclaw models set <provider/model>।
models.providers.*.contextWindow / contextTokens / maxTokens प्रदाता-स्तर के डिफ़ॉल्ट सेट करते हैं; models.providers.*.models[].contextWindow / contextTokens / maxTokens उन्हें प्रति मॉडल override करते हैं।
Fallback नियम, cooldown probes, और session-override persistence: मॉडल failover।

प्रदाता auth जोड़ने से आपका प्राथमिक मॉडल नहीं बदलता

जब आप कोई प्रदाता जोड़ते हैं या फिर से auth करते हैं, तो openclaw configure मौजूदा agents.defaults.model.primary को सुरक्षित रखता है। openclaw models auth login भी ऐसा ही करता है, जब तक आप --set-default पास न करें। प्रदाता plugins अपने auth config patch में अभी भी अनुशंसित डिफ़ॉल्ट मॉडल लौटा सकते हैं, लेकिन जब कोई प्राथमिक मॉडल पहले से मौजूद हो, तो OpenClaw इसे "इस मॉडल को उपलब्ध कराएं" के रूप में मानता है, "वर्तमान प्राथमिक मॉडल को बदलें" के रूप में नहीं।

डिफ़ॉल्ट मॉडल को जानबूझकर बदलने के लिए, openclaw models set <provider/model> या openclaw models auth login --provider <id> --set-default का उपयोग करें।

OpenAI प्रदाता/runtime विभाजन

OpenAI-family routes prefix-specific हैं:

openai/<model> डिफ़ॉल्ट रूप से agent turns के लिए native Codex app-server harness का उपयोग करता है। यह सामान्य ChatGPT/Codex subscription setup है।
legacy Codex model refs legacy config हैं जिन्हें doctor openai/<model> में फिर से लिखता है।
openai/<model> प्लस provider/model agentRuntime.id: "openclaw" स्पष्ट API-key या compatibility routes के लिए OpenClaw के built-in runtime का उपयोग करता है।

OpenAI और Codex harness देखें। अगर provider/runtime विभाजन भ्रमित करता है, तो पहले Agent runtimes पढ़ें।

Plugin auto-enable समान सीमा का पालन करता है: openai/* agent refs डिफ़ॉल्ट route के लिए Codex plugin सक्षम करते हैं, और स्पष्ट provider/model agentRuntime.id: "codex" या legacy codex/<model> refs को भी इसकी आवश्यकता होती है।

GPT-5.5 डिफ़ॉल्ट रूप से openai/gpt-5.5 पर native Codex app-server harness के माध्यम से उपलब्ध है, और OpenClaw runtime के माध्यम से तब उपलब्ध है जब provider/model runtime policy स्पष्ट रूप से openclaw चुनती है।

CLI runtimes

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 में है। ऐसा प्रदाता जिसे पूरी तरह custom request executor चाहिए, एक अलग, गहरा extension surface है।

API key rotation

Key sources और priority

कई keys इस तरह configure करें:

OPENCLAW_LIVE_<PROVIDER>_KEY (single live override, सर्वोच्च priority)
<PROVIDER>_API_KEYS (comma या semicolon list)
<PROVIDER>_API_KEY (primary key)
<PROVIDER>_API_KEY_* (numbered list, जैसे <PROVIDER>_API_KEY_1)

Google providers के लिए, GOOGLE_API_KEY fallback के रूप में भी शामिल है। Key selection order priority को सुरक्षित रखता है और values को deduplicate करता है।

Rotation कब शुरू होता है

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/<model>"].params.transport ("sse", "websocket", या "auto") के माध्यम से override करें
OpenAI priority processing को agents.defaults.models["openai/<model>"].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 के लिए अभी भी काम करते हैं।

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
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/<model>"].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 (GLM)

Z.AI Coding Plan या general API endpoints।

MiniMax

MiniMax Coding Plan OAuth या API key access।

Qwen Cloud

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/<model>"].params.cachedContent (या लेगेसी cached_content) स्वीकार करते हैं, ताकि प्रदाता-नेटिव cachedContents/... हैंडल आगे भेजा जा सके; Gemini कैश हिट OpenClaw cacheRead के रूप में दिखते हैं

Google Vertex और Gemini CLI

प्रदाता: google-vertex, google-gemini-cli
प्रमाणीकरण: Vertex gcloud ADC का उपयोग करता है; Gemini CLI अपने OAuth फ़्लो का उपयोग करता है

Gemini CLI OAuth बंडल किए गए google Plugin के हिस्से के रूप में भेजा जाता है।

Gemini CLI इंस्टॉल करें

brew

bash

brew install gemini-cli

npm

bash

npm install -g @google/gemini-cli

Plugin सक्षम करें

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	`ollama-cloud`	`OLLAMA_API_KEY`	`ollama-cloud/kimi-k2.6`
OpenRouter	`openrouter`	OpenRouter OAuth या `OPENROUTER_API_KEY`	`openrouter/auto`
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`

जानने योग्य विशेषताएँ

OpenRouter

अपने 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 रखते हैं।

Kilo Gateway

Gemini-backed refs वही proxy-Gemini sanitation पथ अपनाते हैं; kilocode/kilo/auto और अन्य proxy-reasoning-unsupported refs proxy reasoning injection छोड़ देते हैं।

MiniMax

API-key onboarding स्पष्ट M3 और M2.7 chat model definitions लिखता है; image understanding Plugin-स्वामित्व वाले MiniMax-VL-01 media provider पर रहती है।

NVIDIA

Model ids nvidia/<vendor>/<model> namespace का उपयोग करते हैं (उदाहरण के लिए nvidia/nvidia/nemotron-... के साथ nvidia/moonshotai/kimi-k2.5); pickers शाब्दिक <provider>/<model-id> composition को सुरक्षित रखते हैं, जबकि API को भेजी गई canonical key single-prefixed रहती है।

xAI

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/<model>"].params.tool_stream=false के माध्यम से अक्षम करें।

`models.providers` के माध्यम से प्रदाता (custom/base URL)

custom प्रदाताओं या OpenAI/Anthropic-संगत proxies को जोड़ने के लिए models.providers (या models.json) का उपयोग करें।

नीचे दिए गए कई बंडल किए गए प्रदाता Plugin पहले से ही डिफ़ॉल्ट कैटलॉग प्रकाशित करते हैं। स्पष्ट models.providers.<id> प्रविष्टियों का उपयोग केवल तब करें जब आप डिफ़ॉल्ट बेस URL, हेडर, या मॉडल सूची को ओवरराइड करना चाहते हों।

Gateway मॉडल क्षमता जांचें स्पष्ट models.providers.<id>.models[] मेटाडेटा भी पढ़ती हैं। यदि कोई कस्टम या प्रॉक्सी मॉडल इमेज स्वीकार करता है, तो उस मॉडल पर input: ["text", "image"] सेट करें ताकि WebChat और node-origin अटैचमेंट पाथ इमेज को टेक्स्ट-ओनली मीडिया रेफ के बजाय नेटिव मॉडल इनपुट के रूप में पास करें।

agents.defaults.models["provider/model"] केवल एजेंट के लिए मॉडल दृश्यता, उपनाम, और प्रति-मॉडल मेटाडेटा नियंत्रित करता है। यह अपने आप नया रनटाइम मॉडल रजिस्टर नहीं करता। कस्टम प्रदाता मॉडलों के लिए, कम से कम मिलते-जुलते id के साथ models.providers.<provider>.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.6
moonshot/kimi-k2.7-code
moonshot/kimi-k2.5
moonshot/kimi-k2-thinking
moonshot/kimi-k2-thinking-turbo
moonshot/kimi-k2-turbo

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)

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)

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 देखें।

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 देखें।

Ollama

Ollama एक बंडल प्रदाता Plugin के रूप में शिप होता है और Ollama के नेटिव API का उपयोग करता है:

प्रदाता: ollama
प्रमाणीकरण: आवश्यक नहीं (स्थानीय सर्वर)
उदाहरण मॉडल: ollama/llama3.3
इंस्टॉलेशन: 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 देखें।

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 देखें।

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 देखें।

स्थानीय प्रॉक्सी (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.<id>.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.<id>.request.allowPrivateNetwork: true ऑप्ट-इन चाहिए। exact-origin भरोसे से ऑप्ट आउट करने के लिए models.providers.<id>.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.<id>.headers["anthropic-beta"] स्पष्ट रूप से सेट करें।

CLI उदाहरण

bash

openclaw onboard --auth-choice opencode-zenopenclaw models set opencode/claude-opus-4-6openclaw models list

यह भी देखें: पूर्ण कॉन्फ़िगरेशन उदाहरणों के लिए कॉन्फ़िगरेशन।

त्वरित नियम

Plugin-स्वामित्व वाला प्रदाता व्यवहार

API key rotation

आधिकारिक प्रदाता plugins

OpenAI

Anthropic

OpenAI ChatGPT/Codex OAuth

अन्य subscription-style hosted options

OpenCode

Google Gemini (API key)

Google Vertex और Gemini CLI

Gemini CLI इंस्टॉल करें

brew

npm

Plugin सक्षम करें

लॉगिन करें

प्रोजेक्ट सेट करें (यदि आवश्यक हो)

Z.AI (GLM)

Vercel AI Gateway

अन्य बंडल किए गए प्रदाता Plugin

जानने योग्य विशेषताएँ

models.providers के माध्यम से प्रदाता (custom/base URL)

Moonshot AI (Kimi)

Kimi कोडिंग

Volcano Engine (Doubao)

मानक मॉडल

कोडिंग मॉडल (volcengine-plan)

BytePlus (अंतरराष्ट्रीय)

मानक मॉडल

कोडिंग मॉडल (byteplus-plan)

Synthetic

MiniMax

LM Studio

Ollama

vLLM

SGLang

स्थानीय प्रॉक्सी (LM Studio, vLLM, LiteLLM, आदि)

CLI उदाहरण

संबंधित

On this page

`models.providers` के माध्यम से प्रदाता (custom/base URL)