त्वरित नियम
मॉडल संदर्भ और CLI सहायक
मॉडल संदर्भ और CLI सहायक
- मॉडल संदर्भ
provider/modelका उपयोग करते हैं (उदाहरण:opencode/claude-opus-4-6)। agents.defaults.modelsउपनाम और प्रति-मॉडल सेटिंग संग्रहीत करता है;agents.defaults.modelPolicy.allowवैकल्पिक स्पष्ट ओवरराइड अनुमतिसूची है।- CLI सहायक:
openclaw onboard,openclaw models list,openclaw models set <provider/model>। models.providers.*.contextWindow/contextTokens/maxTokensप्रदाता-स्तरीय डिफ़ॉल्ट सेट करते हैं;models.providers.*.models[].contextWindow/contextTokens/maxTokensउन्हें प्रति मॉडल ओवरराइड करते हैं।- फ़ॉलबैक नियम, कूलडाउन जाँच और सत्र-ओवरराइड स्थायित्व: मॉडल फ़ेलओवर।
प्रदाता प्रमाणीकरण जोड़ने से आपका प्राथमिक मॉडल नहीं बदलता
प्रदाता प्रमाणीकरण जोड़ने से आपका प्राथमिक मॉडल नहीं बदलता
जब आप किसी प्रदाता को जोड़ते हैं या उसका पुनः प्रमाणीकरण करते हैं, तो
openclaw configure मौजूदा agents.defaults.model.primary को बनाए रखता है। जब तक आप --set-default पास नहीं करते, openclaw models auth login भी यही करता है। प्रदाता Plugin अब भी अपने प्रमाणीकरण कॉन्फ़िगरेशन पैच में अनुशंसित डिफ़ॉल्ट मॉडल लौटा सकते हैं, लेकिन यदि कोई प्राथमिक मॉडल पहले से मौजूद है, तो OpenClaw इसे “इस मॉडल को उपलब्ध बनाएँ” मानता है, न कि “वर्तमान प्राथमिक मॉडल को बदलें।”डिफ़ॉल्ट मॉडल को जानबूझकर बदलने के लिए, openclaw models set <provider/model> या openclaw models auth login --provider <id> --set-default का उपयोग करें।OpenAI प्रदाता/रनटाइम विभाजन
OpenAI प्रदाता/रनटाइम विभाजन
OpenAI मॉडल संदर्भ और एजेंट रनटाइम अलग-अलग हैं:
openai/<model>प्रामाणिक OpenAI प्रदाता और मॉडल चुनता है। केवल उपसर्ग कभी भी Codex नहीं चुनता।- प्रदाता/मॉडल रनटाइम नीति सेट न होने या
autoहोने पर, OpenAI केवल ऐसे सटीक आधिकारिक HTTPS Platform Responses या ChatGPT Responses रूट के लिए Codex को परोक्ष रूप से चुन सकता है, जिसमें स्वयं निर्धारित अनुरोध ओवरराइड न हो। - स्वयं निर्धारित Completions अडैप्टर, कस्टम एंडपॉइंट और स्वयं निर्धारित अनुरोध व्यवहार वाले रूट OpenClaw पर बने रहते हैं। आधिकारिक प्लेनटेक्स्ट HTTP एंडपॉइंट अस्वीकार किए जाते हैं।
- पुराने Codex मॉडल संदर्भ लेगेसी कॉन्फ़िगरेशन हैं, जिन्हें doctor
openai/<model>में दोबारा लिखता है। - प्रदाता/मॉडल
agentRuntime.id: "openclaw"किसी अन्यथा योग्य रूट को स्पष्ट रूप से OpenClaw पर बनाए रखता है।agentRuntime.id: "codex"के लिए Codex आवश्यक है और प्रभावी रूट Codex-संगत न होने पर यह सुरक्षित रूप से विफल होता है।
agentRuntime.id: "codex" या लेगेसी codex/<model> संदर्भों के लिए यह आवश्यक है। केवल openai/* उपसर्ग ऐसा नहीं करता।नया OpenAI सेटअप रूट-विशिष्ट GPT-5.6 संदर्भ का उपयोग करता है: API-कुंजी सेटअप
openai/gpt-5.6 चुनता है (बिना किसी क्वालिफ़ायर वाली प्रत्यक्ष-API आईडी Sol में रिज़ॉल्व होती है), जबकि
ChatGPT/Codex OAuth नेटिव Codex
कैटलॉग के लिए सटीक openai/gpt-5.6-sol चुनता है। OpenAI प्रमाणीकरण जोड़ने या रीफ़्रेश करने पर openai/gpt-5.5 सहित मौजूदा स्पष्ट प्राथमिक मॉडल
बनाए रखे जाते हैं। GPT-5.6 एक्सेस रहित खातों के लिए GPT-5.5
किसी भी रनटाइम के माध्यम से स्पष्ट रिकवरी विकल्प के रूप में उपलब्ध रहता है।CLI रनटाइम
CLI रनटाइम
CLI रनटाइम उसी विभाजन का उपयोग करते हैं:
anthropic/claude-* या google/gemini-* जैसे प्रामाणिक मॉडल संदर्भ चुनें, फिर जब आप स्थानीय CLI बैकएंड चाहते हों, तो प्रदाता/मॉडल रनटाइम नीति को claude-cli या google-gemini-cli पर सेट करें।लेगेसी claude-cli/* और google-gemini-cli/* संदर्भ प्रामाणिक प्रदाता संदर्भों पर वापस माइग्रेट होते हैं और रनटाइम अलग से दर्ज किया जाता है। लेगेसी codex-cli/* संदर्भ openai/* पर माइग्रेट होते हैं और Codex ऐप-सर्वर रूट का उपयोग करते हैं; OpenClaw अब बंडल किया हुआ Codex CLI बैकएंड नहीं रखता।Control UI में प्रदाताओं को कॉन्फ़िगर करें
models.providers.<id>.apiKey में संग्रहीत प्रदाता API कुंजियाँ जोड़ने, बदलने या हटाने के लिए Control UI में Settings → Model Providers खोलें। पृष्ठ क्रेडेंशियल प्रदर्शित किए बिना बताता है कि प्रत्येक API कुंजी OpenClaw कॉन्फ़िगरेशन से आती है या किसी एनवायरनमेंट वेरिएबल से। एनवायरनमेंट द्वारा प्रदान की गई कुंजियाँ Gateway प्रक्रिया के एनवायरनमेंट द्वारा ही प्रबंधित रहती हैं।
लाइव प्रदाता जाँच चलाने और विलंबता या वर्गीकृत प्रमाणीकरण, दर-सीमा, बिलिंग, टाइमआउट या प्रतिक्रिया त्रुटि देखने के लिए Test connection का उपयोग करें। जाँच वास्तविक प्रदाता अनुरोध करती है और थोड़ी संख्या में टोकन का उपयोग कर सकती है। प्रदाता कार्ड से OAuth और टोकन प्रोफ़ाइल भी लॉग आउट की जा सकती हैं।
Default models कार्ड कॉन्फ़िगर किए गए मॉडल कैटलॉग से प्राथमिक मॉडल, क्रमबद्ध फ़ॉलबैक और उपयोगिता मॉडल प्रबंधित करता है। मॉडल चुनें, फिर उन्हें मौजूदा agents.defaults.model और agents.defaults.utilityModel सेटिंग में एक साथ सहेजें। उपयोगिता मॉडल के लिए, Automatic सेटिंग को अनसेट छोड़ता है और Disabled उपयोगिता रूटिंग बंद करने के लिए एक खाली स्ट्रिंग संग्रहीत करता है।
Plugin-स्वामित्व वाला प्रदाता व्यवहार
अधिकांश प्रदाता-विशिष्ट तर्क प्रदाता Plugin (registerProvider(...)) में रहता है, जबकि OpenClaw सामान्य इन्फ़रेंस लूप बनाए रखता है। Plugin ऑनबोर्डिंग, मॉडल कैटलॉग, प्रमाणीकरण एनवायरनमेंट-वेरिएबल मैपिंग, ट्रांसपोर्ट/कॉन्फ़िगरेशन सामान्यीकरण, टूल-स्कीमा सफ़ाई, फ़ेलओवर वर्गीकरण, OAuth रीफ़्रेश, उपयोग रिपोर्टिंग, चिंतन/तर्क प्रोफ़ाइल आदि के स्वामी होते हैं।
प्रदाता-SDK हुक और बंडल किए गए Plugin उदाहरणों की पूरी सूची प्रदाता Plugin में उपलब्ध है। जिस प्रदाता को पूरी तरह कस्टम अनुरोध निष्पादक चाहिए, वह एक अलग और अधिक गहन एक्सटेंशन सतह है।
प्रदाता-स्वामित्व वाला रनर व्यवहार स्पष्ट प्रदाता हुक पर रहता है, जैसे रीप्ले नीति, टूल-स्कीमा सामान्यीकरण, स्ट्रीम रैपिंग और ट्रांसपोर्ट/अनुरोध सहायक। लेगेसी
ProviderPlugin.capabilities स्टैटिक बैग केवल संगतता के लिए है और अब साझा रनर तर्क द्वारा पढ़ा नहीं जाता।API कुंजी रोटेशन
कुंजी स्रोत और प्राथमिकता
कुंजी स्रोत और प्राथमिकता
एकाधिक कुंजियाँ इनके माध्यम से कॉन्फ़िगर करें:
OPENCLAW_LIVE_<PROVIDER>_KEY(एकल लाइव ओवरराइड, सर्वोच्च प्राथमिकता)<PROVIDER>_API_KEYS(कॉमा या सेमीकोलन सूची)<PROVIDER>_API_KEY(प्राथमिक कुंजी)<PROVIDER>_API_KEY_*(क्रमांकित सूची, उदाहरणार्थ<PROVIDER>_API_KEY_1)
GOOGLE_API_KEY को भी फ़ॉलबैक के रूप में शामिल किया जाता है। कुंजी चयन क्रम प्राथमिकता बनाए रखता है और डुप्लिकेट मान हटाता है।रोटेशन कब सक्रिय होता है
रोटेशन कब सक्रिय होता है
- अनुरोधों को अगली कुंजी के साथ केवल दर-सीमा प्रतिक्रियाओं पर दोबारा आज़माया जाता है (उदाहरण के लिए
429,rate_limit,quota,resource exhausted,Too many concurrent requests,ThrottlingException,concurrency limit reached,workers_ai ... quota limit exceededया आवधिक उपयोग-सीमा संदेश)। - दर-सीमा से असंबंधित विफलताएँ तुरंत विफल होती हैं; कुंजी रोटेशन का प्रयास नहीं किया जाता।
- जब सभी संभावित कुंजियाँ विफल हो जाती हैं, तो अंतिम प्रयास की त्रुटि लौटाई जाती है।
आधिकारिक प्रदाता Plugin
आधिकारिक प्रदाता Plugin अपने मॉडल कैटलॉग की पंक्तियाँ प्रकाशित करते हैं। इन प्रदाताओं कोmodels.providers मॉडल प्रविष्टियों की आवश्यकता नहीं होती; प्रदाता Plugin सक्षम करें, प्रमाणीकरण सेट करें और मॉडल चुनें। models.providers का उपयोग केवल स्पष्ट कस्टम प्रदाताओं या टाइमआउट जैसी सीमित अनुरोध सेटिंग के लिए करें।
OpenAI
- प्रदाता:
openai - प्रमाणीकरण:
OPENAI_API_KEY - वैकल्पिक रोटेशन:
OPENAI_API_KEYS,OPENAI_API_KEY_1,OPENAI_API_KEY_2, साथ हीOPENCLAW_LIVE_OPENAI_KEY(एकल ओवरराइड) - नए सेटअप का डिफ़ॉल्ट:
openai/gpt-5.6; प्रत्यक्ष API पर, बिना किसी क्वालिफ़ायर वाली आईडी Sol में रिज़ॉल्व होती है। - उदाहरण मॉडल:
openai/gpt-5.6,openai/gpt-5.6-terra,openai/gpt-5.6-luna,openai/gpt-5.5 - यदि किसी विशिष्ट इंस्टॉल या API कुंजी का व्यवहार अलग हो, तो
openclaw models list --provider openaiके साथ खाते/मॉडल की उपलब्धता सत्यापित करें। - CLI:
openclaw onboard --auth-choice openai-api-key - डिफ़ॉल्ट ट्रांसपोर्ट
autoहै; OpenClaw ट्रांसपोर्ट चयन को साझा मॉडल रनटाइम को भेजता है। agents.defaults.models["openai/<model>"].params.transportके माध्यम से प्रति मॉडल ओवरराइड करें ("sse","websocket"या"auto")- OpenAI प्राथमिकता प्रसंस्करण को
agents.defaults.models["openai/<model>"].params.serviceTierके माध्यम से सक्षम किया जा सकता है /fastऔरparams.fastMode,openai/*के प्रत्यक्ष Responses अनुरोधों कोapi.openai.comपरservice_tier=priorityमें मैप करते हैं- जब आप साझा
/fastटॉगल के बजाय स्पष्ट टियर चाहते हों, तोparams.serviceTierका उपयोग करें - छिपे हुए OpenClaw एट्रिब्यूशन हेडर (
originator,version,User-Agent) केवलapi.openai.comके नेटिव OpenAI ट्रैफ़िक पर लागू होते हैं, सामान्य OpenAI-संगत प्रॉक्सी पर नहीं - नेटिव OpenAI रूट Responses
store, प्रॉम्प्ट-कैश संकेत और OpenAI तर्क-संगतता पेलोड आकार देना भी बनाए रखते हैं; प्रॉक्सी रूट ऐसा नहीं करते openai/gpt-5.3-codex-sparkकेवल ChatGPT/Codex OAuth के माध्यम से उपलब्ध है; प्रत्यक्ष OpenAI API-कुंजी और Azure API-कुंजी रूट इसे अस्वीकार करते हैं
openai/gpt-5.5 को स्पष्ट रूप से सेट करें। सामान्य ऑनबोर्डिंग और पुनः प्रमाणीकरण किसी
मौजूदा स्पष्ट प्राथमिक मॉडल को बनाए रखते हैं; models auth login --set-default और
models set जानबूझकर प्रतिस्थापन के मार्ग हैं।
Anthropic
- प्रदाता:
anthropic - प्रमाणीकरण:
ANTHROPIC_API_KEY - वैकल्पिक रोटेशन:
ANTHROPIC_API_KEYS,ANTHROPIC_API_KEY_1,ANTHROPIC_API_KEY_2, साथ हीOPENCLAW_LIVE_ANTHROPIC_KEY(एकल ओवरराइड) - उदाहरण मॉडल:
anthropic/claude-opus-5 - CLI:
openclaw onboard --auth-choice apiKey - प्रत्यक्ष सार्वजनिक Anthropic अनुरोध साझा
/fastटॉगल औरparams.fastModeका समर्थन करते हैं, जिसमेंapi.anthropic.comको भेजा गया API-कुंजी और OAuth-प्रमाणीकृत ट्रैफ़िक शामिल है; OpenClaw इसे Anthropicservice_tier(autoबनामstandard_only) में मैप करता है - पसंदीदा Claude CLI कॉन्फ़िगरेशन मॉडल संदर्भ को प्रामाणिक रखता है और CLI
बैकएंड को अलग से चुनता है: मॉडल-स्कोप वाले
agentRuntime.id: "claude-cli"के साथanthropic/claude-opus-5। लेगेसीclaude-cli/claude-opus-4-7संदर्भ संगतता के लिए अब भी काम करते हैं।
Claude CLI का पुनः उपयोग (
claude -p) OpenClaw का स्वीकृत एकीकरण मार्ग है। Anthropic सेटअप-टोकन प्रमाणीकरण समर्थित बना हुआ है, लेकिन उपलब्ध होने पर OpenClaw Claude CLI के पुनः उपयोग को प्राथमिकता देता है।OpenAI ChatGPT/Codex OAuth
- प्रदाता:
openai - प्रमाणीकरण: OAuth (ChatGPT)
- नया नेटिव Codex app-server हार्नेस संदर्भ:
openai/gpt-5.6-sol - नेटिव Codex app-server हार्नेस दस्तावेज़: Codex हार्नेस
- लेगेसी मॉडल संदर्भ:
codex/gpt-*,openai-codex/gpt-* - Plugin सीमा:
openai/*OpenAI Plugin को लोड करता है; स्पष्ट रनटाइम नीति या प्रदाता के स्वामित्व वाला प्रभावी रूट तय करता है कि नेटिव Codex app-server Plugin चुना जाए या नहीं। - CLI:
openclaw onboard --auth-choice openaiयाopenclaw models auth login --provider openai - OpenClaw का एम्बेडेड ChatGPT Responses ट्रांसपोर्ट डिफ़ॉल्ट रूप से
auto(पहले WebSocket, फ़ॉलबैक के रूप में SSE) का उपयोग करता है। agents.defaults.models["openai/<model>"].params.transport,params.serviceTier, औरparams.fastModeलेखित एम्बेडेड-अनुरोध सेटिंग्स हैं। ये अंतर्निहित रनटाइम चयन को OpenClaw पर बनाए रखती हैं; नेटिव Codex अपने app-server ट्रांसपोर्ट और सेवा स्तर का स्वामी होता है।- छिपे हुए OpenClaw एट्रिब्यूशन हेडर (
originator,version,User-Agent) केवलchatgpt.com/backend-apiपर जाने वाले नेटिव Codex ट्रैफ़िक में जोड़े जाते हैं, सामान्य OpenAI-संगत प्रॉक्सी में नहीं - साझा
/fastटॉगल रनटाइम नियंत्रण के रूप में उपलब्ध रहता है; यह लेखित मॉडल पैरामीटर से अलग है। - नेटिव Codex कैटलॉग खाते की पहुँच के अनुसार सटीक
openai/gpt-5.6-sol,openai/gpt-5.6-terra, औरopenai/gpt-5.6-lunaसंदर्भ दिखा सकता है। यह सीधे API के केवलgpt-5.6वाले उपनाम को क्लाइंट की ओर लागू नहीं करता। openai/gpt-5.5Codex कैटलॉग के नेटिवcontextWindow = 400000और डिफ़ॉल्ट रनटाइमcontextTokens = 272000का उपयोग करता है; रनटाइम सीमा कोmodels.providers.openai.models[].contextTokensसे ओवरराइड करेंopenaiप्रमाणीकरण से साइन इन करें और नई सदस्यता-समर्थित स्थापना के लिएopenai/gpt-5.6-solका उपयोग करें। यदि वह Codex कार्यस्थान GPT-5.6 उपलब्ध नहीं कराता, तोopenai/gpt-5.5को स्पष्ट रूप से चुनें।- अन्यथा योग्य रूट को अंतर्निर्मित रनटाइम पर बनाए रखने के लिए प्रदाता/मॉडल
agentRuntime.id: "openclaw"का उपयोग करें। रनटाइम सेट न होने याautoहोने पर, केवल बिना किसी लेखित अनुरोध ओवरराइड वाला सटीक आधिकारिक HTTPS Responses/ChatGPT-संगत रूट ही Codex को अंतर्निहित रूप से चुन सकता है। - लेगेसी Codex GPT संदर्भ लेगेसी स्थिति हैं, कोई सक्रिय प्रदाता रूट नहीं। नए एजेंट कॉन्फ़िगरेशन के लिए मानक
openai/*संदर्भों का उपयोग करें, और मॉडल-स्कोप वालेagentRuntime.id: "codex"के साथ उनके नेटिव Codex अर्थ को सुरक्षित रखते हुएcodex/*औरopenai-codex/*संदर्भों को माइग्रेट करने के लिएopenclaw doctor --fixचलाएँ। मौजूदा स्पष्ट मानकopenai/gpt-5.5चयनों को अपग्रेड नहीं किया जाता।
सदस्यता-शैली के अन्य होस्टेड विकल्प
MiniMax
MiniMax Coding Plan OAuth या API कुंजी पहुँच।
Qwen Cloud
Qwen Cloud प्रदाता सतह के साथ Alibaba DashScope और Coding Plan एंडपॉइंट मैपिंग।
Z.AI (GLM)
Z.AI Coding Plan या सामान्य API एंडपॉइंट।
OpenCode
- प्रमाणीकरण:
OPENCODE_API_KEY(याOPENCODE_ZEN_API_KEY) - Zen रनटाइम प्रदाता:
opencode - Go रनटाइम प्रदाता:
opencode-go - उदाहरण मॉडल:
opencode/claude-opus-4-6,opencode-go/kimi-k2.6 - CLI:
openclaw onboard --auth-choice opencode-zenयाopenclaw onboard --auth-choice opencode-go
Google Gemini (API कुंजी)
- प्रदाता:
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.5-flash - संगतता:
google/gemini-3.1-flash-previewका उपयोग करने वाला लेगेसी OpenClaw कॉन्फ़िगरेशनgoogle/gemini-3-flash-previewमें सामान्यीकृत किया जाता है - उपनाम:
google/gemini-3.1-proस्वीकार किया जाता है और Google की सक्रिय Gemini API आईडी,google/gemini-3.1-pro-preview, में सामान्यीकृत किया जाता है - CLI:
openclaw onboard --auth-choice gemini-api-key - चिंतन:
/think adaptiveGoogle के डायनेमिक चिंतन का उपयोग करता है। Gemini 3/3.1 निश्चितthinkingLevelको छोड़ देते हैं; Gemini 2.5thinkingBudget: -1भेजता है। - सीधे Gemini रन प्रदाता-नेटिव
cachedContents/...हैंडल को अग्रेषित करने के लिएagents.defaults.models["google/<model>"].params.cachedContent(या लेगेसीcached_content) भी स्वीकार करते हैं; Gemini कैश हिट OpenClawcacheReadके रूप में दिखाई देते हैं
Google Vertex और Gemini CLI
- प्रदाता:
google-vertex,google-gemini-cli - प्रमाणीकरण: Vertex gcloud ADC का उपयोग करता है; Gemini CLI अपने OAuth प्रवाह का उपयोग करता है
google Plugin के भाग के रूप में भेजा जाता है।
1
Gemini CLI इंस्टॉल करें
- brew
- npm
2
Plugin सक्षम करें
3
लॉग इन करें
google-gemini-cli/gemini-3-flash-preview। आप openclaw.json में क्लाइंट आईडी या सीक्रेट पेस्ट नहीं करते। CLI लॉगिन प्रवाह Gateway होस्ट पर प्रमाणीकरण प्रोफ़ाइल में टोकन संग्रहीत करता है।4
प्रोजेक्ट सेट करें (यदि आवश्यक हो)
यदि लॉगिन के बाद अनुरोध विफल हों, तो Gateway होस्ट पर
GOOGLE_CLOUD_PROJECT या GOOGLE_CLOUD_PROJECT_ID सेट करें।stream-json का उपयोग करता है। OpenClaw सहायक स्ट्रीम
संदेशों को पढ़ता है और 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- मॉडल संदर्भ मानक
zai/*प्रदाता आईडी का उपयोग करते हैं। zai-api-keyमेल खाने वाले Z.AI एंडपॉइंट का स्वतः पता लगाता है;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
जानने योग्य विशिष्टताएँ
OpenRouter
OpenRouter
अपने ऐप-एट्रिब्यूशन हेडर और Anthropic
cache_control मार्कर केवल सत्यापित openrouter.ai रूट पर लागू करता है। DeepSeek, Moonshot और ZAI रेफ़रेंस OpenRouter-प्रबंधित प्रॉम्प्ट कैशिंग के लिए कैश-TTL योग्य हैं, लेकिन उन्हें Anthropic कैश मार्कर नहीं मिलते। प्रॉक्सी-शैली के OpenAI-संगत पथ के रूप में, यह केवल नेटिव-OpenAI शेपिंग (serviceTier, Responses store, प्रॉम्प्ट-कैश संकेत, OpenAI रीजनिंग-संगतता) को छोड़ देता है। Gemini-समर्थित रेफ़रेंस केवल प्रॉक्सी-Gemini थॉट-सिग्नेचर सैनिटाइज़ेशन बनाए रखते हैं।Kilo Gateway
Kilo Gateway
Gemini-समर्थित रेफ़रेंस उसी प्रॉक्सी-Gemini सैनिटाइज़ेशन पथ का पालन करते हैं;
kilocode/kilo-auto/balanced और अन्य प्रॉक्सी-रीजनिंग-असमर्थित रेफ़रेंस प्रॉक्सी रीजनिंग इंजेक्शन को छोड़ देते हैं।MiniMax
MiniMax
API-कुंजी ऑनबोर्डिंग स्पष्ट M3 और M2.7 चैट मॉडल परिभाषाएँ लिखती है; छवि-बोध Plugin-स्वामित्व वाले
MiniMax-VL-01 मीडिया प्रदाता पर बना रहता है।NVIDIA
NVIDIA
मॉडल आईडी
nvidia/<vendor>/<model> नेमस्पेस का उपयोग करते हैं (उदाहरण के लिए nvidia/nvidia/nemotron-...); पिकर शाब्दिक <provider>/<model-id> संयोजन बनाए रखते हैं, जबकि API को भेजी गई कैनोनिकल कुंजी एकल-प्रीफ़िक्स वाली रहती है।xAI
xAI
xAI Responses पथ का उपयोग करता है। अनुशंसित पथ SuperGrok/X Premium OAuth है; API कुंजियाँ अब भी
XAI_API_KEY या Plugin कॉन्फ़िगरेशन के माध्यम से काम करती हैं, और Grok web_search API-कुंजी फ़ॉलबैक से पहले उसी प्रमाणीकरण प्रोफ़ाइल का पुनः उपयोग करता है। जहाँ उपलब्ध हो, Grok 4.5 को चैट, कोडिंग और एजेंटिक कार्य के लिए चुना जा सकता है; grok-4.3 क्षेत्रीय-सुरक्षित बंडल्ड डिफ़ॉल्ट बना रहता है। पुराने /fast और params.fastMode: true कॉन्फ़िगरेशन अब भी xAI के Grok 4.3 संगतता रीडायरेक्ट के माध्यम से रिज़ॉल्व होते हैं, लेकिन नए कॉन्फ़िगरेशन को सीधे कोई मौजूदा मॉडल चुनना चाहिए। tool_stream डिफ़ॉल्ट रूप से चालू है; agents.defaults.models["xai/<model>"].params.tool_stream=false के माध्यम से अक्षम करें।models.providers (कस्टम/बेस URL) के माध्यम से प्रदाता
कस्टम प्रदाता या OpenAI/Anthropic-संगत प्रॉक्सी जोड़ने के लिए models.providers (या models.json) का उपयोग करें।
नीचे दिए गए कई बंडल्ड प्रदाता Plugin पहले से एक डिफ़ॉल्ट कैटलॉग प्रकाशित करते हैं। स्पष्ट models.providers.<id> प्रविष्टियों का उपयोग केवल तब करें, जब आप डिफ़ॉल्ट बेस URL, हेडर या मॉडल सूची को ओवरराइड करना चाहते हों।
बंडल्ड और कैटलॉग-ज्ञात रूट अपनी compat क्षमताएँ स्वामी प्रदाता Plugin से लेते हैं। कॉन्फ़िगरेशन का compat ब्लॉक किसी कस्टम प्रदाता/मॉडल या ऐसे भिन्न api/baseUrl रूट के लिए है, जिसके एंडपॉइंट अनुबंध को आपने सत्यापित किया है; कस्टम-प्रदाता क्षमता मार्गदर्शिका देखें। Doctor उन लेगेसी मानों को हटा देता है जो केवल कैटलॉग को दोहराते हैं और अलग मानों को ऑपरेटर की समीक्षा के लिए दृश्यमान रखता है।
Gateway मॉडल क्षमता जाँच स्पष्ट models.providers.<id>.models[] मेटाडेटा भी पढ़ती है। यदि कोई कस्टम या प्रॉक्सी मॉडल छवियाँ स्वीकार करता है, तो उस मॉडल पर input: ["text", "image"] सेट करें, ताकि WebChat और Node-मूल अटैचमेंट पथ छवियों को केवल-पाठ मीडिया रेफ़रेंस के बजाय नेटिव मॉडल इनपुट के रूप में पास करें।
agents.defaults.models["provider/model"] एजेंटों के लिए उपनाम और प्रति-मॉडल मेटाडेटा नियंत्रित करता है। यह न तो ओवरराइड को प्रतिबंधित करता है, न ही स्वयं कोई नया रनटाइम मॉडल पंजीकृत करता है। कस्टम प्रदाता मॉडल के लिए, कम-से-कम मेल खाता id सहित models.providers.<provider>.models[] भी जोड़ें; जब आप ओवरराइड प्रतिबंध चाहते हों, तो agents.defaults.modelPolicy.allow का अलग से उपयोग करें।
Moonshot AI (Kimi)
ऑनबोर्डिंग से पहले@openclaw/moonshot-provider इंस्टॉल करें। स्पष्ट models.providers.moonshot प्रविष्टि केवल तब जोड़ें, जब आपको बेस URL या मॉडल मेटाडेटा ओवरराइड करना हो:
- प्रदाता:
moonshot - प्रमाणीकरण:
MOONSHOT_API_KEY - उदाहरण मॉडल:
moonshot/kimi-k3 - CLI:
openclaw onboard --auth-choice moonshot-api-keyयाopenclaw onboard --auth-choice moonshot-api-key-cn
moonshot/kimi-k2.6moonshot/kimi-k3moonshot/kimi-k2.7-codemoonshot/kimi-k2.7-code-highspeedmoonshot/kimi-k2.5
Kimi Coding
Kimi Coding, Moonshot AI के Anthropic-संगत एंडपॉइंट का उपयोग करता है:- प्रदाता:
kimi - प्रमाणीकरण:
KIMI_API_KEY - Kimi K3:
kimi/k3(256K) याkimi/k3[1m](1M प्लान) - Kimi Code:
kimi/kimi-for-coding - Kimi Code HighSpeed:
kimi/kimi-for-coding-highspeed
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
volcengine/* कैटलॉग उसी समय पंजीकृत होता है।
ऑनबोर्डिंग/कॉन्फ़िगर मॉडल पिकर में, Volcengine प्रमाणीकरण विकल्प volcengine/* और volcengine-plan/* दोनों पंक्तियों को प्राथमिकता देता है। यदि वे मॉडल अभी लोड नहीं हुए हैं, तो OpenClaw खाली प्रदाता-स्कोप्ड पिकर दिखाने के बजाय बिना फ़िल्टर वाले कैटलॉग पर फ़ॉलबैक करता है।
- मानक मॉडल
- कोडिंग मॉडल (volcengine-plan)
volcengine/doubao-seed-1-8-251228(Doubao Seed 1.8)volcengine/doubao-seed-code-preview-251028volcengine/kimi-k2-5-260127(Kimi K2.5)volcengine/glm-4-7-251222(GLM 4.7)volcengine/deepseek-v3-2-251201(DeepSeek V3.2)
BytePlus (अंतरराष्ट्रीय)
BytePlus ARK अंतरराष्ट्रीय उपयोगकर्ताओं को Volcano Engine वाले समान मॉडलों तक पहुँच प्रदान करता है।- प्रदाता:
byteplus(कोडिंग:byteplus-plan) - प्रमाणीकरण:
BYTEPLUS_API_KEY - उदाहरण मॉडल:
byteplus-plan/ark-code-latest - CLI:
openclaw onboard --auth-choice byteplus-api-key
byteplus/* कैटलॉग भी उसी समय पंजीकृत होता है।
ऑनबोर्डिंग/कॉन्फ़िगरेशन मॉडल चयनकर्ताओं में, BytePlus प्रमाणीकरण विकल्प byteplus/* और byteplus-plan/* दोनों पंक्तियों को प्राथमिकता देता है। यदि वे मॉडल अभी तक लोड नहीं हुए हैं, तो OpenClaw खाली प्रदाता-स्कोप वाला चयनकर्ता दिखाने के बजाय फ़िल्टर-रहित कैटलॉग पर वापस जाता है।
- मानक मॉडल
- कोडिंग मॉडल (byteplus-plan)
byteplus/seed-1-8-251228(Seed 1.8)byteplus/kimi-k2-5-260127(Kimi K2.5)byteplus/glm-4-7-251222(GLM 4.7)
Synthetic
Synthetic,synthetic प्रदाता के माध्यम से Anthropic-संगत मॉडल प्रदान करता है:
- प्रदाता:
synthetic - प्रमाणीकरण:
SYNTHETIC_API_KEY - उदाहरण मॉडल:
synthetic/hf:MiniMaxAI/MiniMax-M3 - CLI:
openclaw onboard --auth-choice synthetic-api-key
MiniMax
MiniMax कोmodels.providers के माध्यम से कॉन्फ़िगर किया जाता है, क्योंकि यह कस्टम एंडपॉइंट का उपयोग करता है:
- MiniMax OAuth (वैश्विक):
--auth-choice minimax-global-oauth - MiniMax OAuth (चीन):
--auth-choice minimax-cn-oauth - MiniMax API कुंजी (वैश्विक):
--auth-choice minimax-global-api - MiniMax API कुंजी (चीन):
--auth-choice minimax-cn-api - प्रमाणीकरण:
minimaxके लिएMINIMAX_API_KEY;minimax-portalके लिएMINIMAX_OAUTH_TOKENयाMINIMAX_API_KEY
MiniMax के Anthropic-संगत स्ट्रीमिंग पथ पर, OpenClaw M2.x परिवार के लिए डिफ़ॉल्ट रूप से थिंकिंग अक्षम करता है, जब तक कि आप इसे स्पष्ट रूप से सेट न करें; MiniMax-M3 (और M3.x) डिफ़ॉल्ट रूप से प्रदाता के छोड़े गए/अनुकूली थिंकिंग पथ पर बना रहता है।
/fast on, MiniMax-M2.7 को MiniMax-M2.7-highspeed में पुनर्लिखित करता है।- टेक्स्ट/चैट डिफ़ॉल्ट
minimax/MiniMax-M3पर बने रहते हैं - छवि निर्माण
minimax/image-01याminimax-portal/image-01है - दोनों MiniMax प्रमाणीकरण पथों पर छवि समझ Plugin-स्वामित्व वाला
MiniMax-VL-01है - वेब खोज प्रदाता आईडी
minimaxपर बनी रहती है
LM Studio
LM Studio एक बंडल प्रदाता Plugin के रूप में उपलब्ध होता है, जो मूल API का उपयोग करता है:- प्रदाता:
lmstudio - प्रमाणीकरण:
LM_API_TOKEN - डिफ़ॉल्ट अनुमान बेस URL:
http://localhost:1234/v1
http://localhost:1234/api/v1/models द्वारा लौटाई गई आईडी में से किसी एक से बदलें):
/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
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
/v1/models द्वारा लौटाई गई आईडी में से किसी एक से बदलें):
SGLang
SGLang तेज़ स्व-होस्टेड OpenAI-संगत सर्वरों के लिए एक बंडल प्रदाता Plugin के रूप में उपलब्ध होता है:- प्रदाता:
sglang - प्रमाणीकरण: वैकल्पिक (आपके सर्वर पर निर्भर)
- डिफ़ॉल्ट बेस URL:
http://127.0.0.1:30000/v1
/v1/models द्वारा लौटाई गई आईडी में से किसी एक से बदलें):
स्थानीय प्रॉक्सी (LM Studio, vLLM, LiteLLM आदि)
उदाहरण (OpenAI-संगत):डिफ़ॉल्ट वैकल्पिक फ़ील्ड
डिफ़ॉल्ट वैकल्पिक फ़ील्ड
कस्टम प्रदाताओं के लिए,
reasoning, input, cost, contextWindow और maxTokens वैकल्पिक हैं। इन्हें छोड़ने पर, OpenClaw के डिफ़ॉल्ट ये होते हैं:reasoning: falseinput: ["text"]cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }contextWindow: 200000maxTokens: 8192
प्रॉक्सी-रूट आकार-निर्धारण नियम
प्रॉक्सी-रूट आकार-निर्धारण नियम
- गैर-मूल एंडपॉइंट पर
api: "openai-completions"के लिए (कोई भी गैर-रिक्तbaseUrl, जिसका होस्टapi.openai.comनहीं है), OpenClaw असमर्थितdeveloperभूमिकाओं के कारण होने वाली प्रदाता 400 त्रुटियों से बचने के लिएcompat.supportsDeveloperRole: falseको बाध्य करता है। - प्रॉक्सी-शैली के OpenAI-संगत रूट केवल मूल OpenAI के अनुरोध आकार-निर्धारण को भी छोड़ देते हैं: कोई
service_tierनहीं, कोई Responsesstoreनहीं, कोई Completionsstoreनहीं, कोई प्रॉम्प्ट-कैश संकेत नहीं, कोई OpenAI रीजनिंग-संगतता पेलोड आकार-निर्धारण नहीं और कोई छिपा हुआ OpenClaw श्रेय हेडर नहीं। - विक्रेता-विशिष्ट फ़ील्ड की आवश्यकता वाले 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/टेलनेट होस्ट के लिए,
models.providers.<id>.timeoutSecondsसेट करें। यह पूरे एजेंट रनटाइम टाइमआउट को बढ़ाए बिना, कनेक्ट, हेडर, बॉडी स्ट्रीमिंग और कुल संरक्षित-फ़ेच निरस्तीकरण सहित प्रदाता मॉडल HTTP अनुरोध प्रबंधन को विस्तारित करता है। यदिagents.defaults.timeoutSecondsया किसी रन-विशिष्ट टाइमआउट की सीमा कम है, तो उस सीमा को भी बढ़ाएँ; प्रदाता टाइमआउट पूरे रन को विस्तारित नहीं कर सकते। - मॉडल प्रदाता HTTP कॉल, Surge, Clash और sing-box के नकली-IP DNS उत्तरों को
198.18.0.0/15औरfc00::/7में केवल कॉन्फ़िगर किए गए प्रदाताbaseUrlहोस्टनाम के लिए अनुमति देते हैं। कस्टम/स्थानीय प्रदाता एंडपॉइंट संरक्षित मॉडल अनुरोधों के लिए ठीक उसी कॉन्फ़िगर किए गएscheme://host:portमूल पर भी भरोसा करते हैं, जिसमें लूपबैक, LAN और टेलनेट होस्ट शामिल हैं। यह कोई नया कॉन्फ़िगरेशन विकल्प नहीं है; आपके द्वारा कॉन्फ़िगर किया गयाbaseUrlकेवल उस मूल के लिए अनुरोध नीति को विस्तारित करता है। नकली-IP होस्टनाम अनुमति और सटीक-मूल विश्वास स्वतंत्र तंत्र हैं। अन्य निजी, लूपबैक, लिंक-स्थानीय, मेटाडेटा गंतव्यों और अलग पोर्ट के लिए अब भी स्पष्टmodels.providers.<id>.request.allowPrivateNetwork: trueऑप्ट-इन आवश्यक है। सटीक-मूल विश्वास से ऑप्ट आउट करने के लिएmodels.providers.<id>.request.allowPrivateNetwork: falseसेट करें। - यदि
baseUrlरिक्त/छोड़ा हुआ है, तो OpenClaw डिफ़ॉल्ट OpenAI व्यवहार बनाए रखता है (जोapi.openai.comमें परिणत होता है)। - सुरक्षा के लिए, गैर-मूल
openai-completionsएंडपॉइंट पर स्पष्टcompat.supportsDeveloperRole: trueको अब भी ओवरराइड किया जाता है। - गैर-प्रत्यक्ष एंडपॉइंट पर
api: "anthropic-messages"के लिए (कैनोनिकलanthropicके अलावा कोई भी प्रदाता, या ऐसा कस्टमmodels.providers.anthropic.baseUrlजिसका होस्ट कोई सार्वजनिकapi.anthropic.comएंडपॉइंट नहीं है), OpenClawclaude-code-20250219,interleaved-thinking-2025-05-14और OAuth मार्कर जैसे अंतर्निहित Anthropic बीटा हेडर दबा देता है, ताकि कस्टम Anthropic-संगत प्रॉक्सी असमर्थित बीटा फ़्लैग अस्वीकार न करें। यदि आपके प्रॉक्सी को विशिष्ट बीटा सुविधाओं की आवश्यकता है, तोmodels.providers.<id>.headers["anthropic-beta"]स्पष्ट रूप से सेट करें।
CLI उदाहरण
संबंधित
- कॉन्फ़िगरेशन संदर्भ - मॉडल कॉन्फ़िगरेशन कुंजियाँ
- मॉडल फ़ेलओवर - फ़ॉलबैक शृंखलाएँ और पुनः प्रयास व्यवहार
- मॉडल - मॉडल कॉन्फ़िगरेशन और उपनाम
- प्रदाता - प्रत्येक प्रदाता के लिए सेटअप मार्गदर्शिकाएँ