OpenClaw कॉन्फ़िगरेशन गाइड
OpenClaw कस्टम मॉडल प्रदाताओं को माध्यम से जोड़ता है models.providers. Ai2save OpenAI संगत इंटरफ़ेस का उपयोग करता है, और बेस यूआरएल को भरा जाना चाहिए https://ai2save.com/v1.
1. OpenClaw और API कुंजी तैयार करें
यदि OpenClaw पहले से ही स्थापित है, तो आप स्थापना को छोड़ सकते हैं:
npm install -g openclaw@latest
openclaw --version
- खुला https://ai2save.com/keys.
- OpenAI / GPT मॉडल समूह से संबंधित API कुंजी बनाएं.
- पूरा कॉपी करें
sk-...कुंजी.
2. OpenClaw कॉन्फ़िगरेशन फ़ाइल संपादित करें
OpenClaw के लिए डिफ़ॉल्ट कॉन्फ़िगरेशन फ़ाइल है:
~/.openclaw/openclaw.json
विंडोज आमतौर पर JSON5 का समर्थन करता है %USERPROFILE%\.openclaw\openclaw.json. नीचे दी गई संरचना के अनुसार फ़ाइल को मौजूदा विन्यास में विलय किया जा सकता है:
{
env: {
vars: {
AI2SAVE_API_KEY: "sk-your-api-key",
},
},
agents: {
defaults: {
model: {
primary: "ai2save/gpt-5.5",
},
},
},
models: {
mode: "merge",
providers: {
ai2save: {
baseUrl: "https://ai2save.com/v1",
apiKey: "${AI2SAVE_API_KEY}",
api: "openai-completions",
timeoutSeconds: 300,
models: [
{
id: "gpt-5.5",
name: "GPT 5.5",
reasoning: true,
input: ["text"],
contextWindow: 200000,
},
],
},
},
},
}
कुंजी फील्ड विवरण:
models.providers.ai2save.baseUrl: शामिल होना चाहिए/v1.api: "openai-completions": इंटरफ़ेस प्रकार OpenClaw द्वारा प्रॉक्सी OpenAI संगत के लिए उपयोग किया जाता है.models[].id: Ai2save कंसोल में खोले गए मॉडल आईडी के साथ बिल्कुल संगत होना चाहिए.agents.defaults.model.primary: प्रारूप हैprovider-id/model-id.apiKeyसीधे लिख सकते हैं"sk-..."; जब संदर्भित किया जाता है${AI2SAVE_API_KEY}, इसे परिभाषित किया जाना चाहिएenv.vars.
यदि आप एकाधिक मॉडल जोड़ना चाहते हैं, तो जारी रखें कि आप कई मॉडल जोड़ना चाहते हैं models सरणी और परिवर्तन primary to ai2save/model-id आप डिफ़ॉल्ट रूप से उपयोग करना चाहते हैं.
3. कॉन्फ़िगरेशन लागू करें और जाँचें
OpenClaw Gateway कॉन्फ़िगरेशन फ़ाइल परिवर्तनों को सुनेगा और उन्हें स्वचालित रूप से लागू करेगा। यदि विन्यास तुरंत प्रभावी नहीं होता है, तो निष्पादित करें:
openclaw gateway restart
फिर जांचें कि क्या मॉडल पहले से ही OpenClaw में दिखाई दिया है?:
openclaw models list --provider ai2save
डिफ़ॉल्ट मॉडल को ai2save पर स्विच करें:
openclaw models set ai2save/gpt-5.5
यदि मॉडल प्रकट नहीं होता है, तो निदान चलाएं और कॉन्फ़िगरेशन त्रुटियों की जांच करें:
openclaw doctor
4. अनुरोध सत्यापन
- OpenClaw के लिए चैट इंटरफ़ेस या WebChat खोलें.
- एक नई बातचीत शुरू करें और "हैलो" भेजें, कृपया वर्तमान मॉडल नाम की रिपोर्ट करें
- पुष्टि करें कि मॉडल मार्ग के रूप में दिखाता है
ai2save/gpt-5.5. - पहली बार, केवल पाठ कार्यों के साथ सत्यापित करें। एक बार सफल होने पर फ़ाइल हैंडलिंग, ब्राउज़र और लंबे संदर्भ जैसे जटिल उपकरणों को सक्षम करें.
OpenClaw स्वचालित रूप से अनौपचारिक OpenAI प्रॉक्सी के लिए संगतता को संभालती है, इसलिए मैन्युअल रूप से सक्षम करने की कोई आवश्यकता नहीं है developer role. यदि टूल कॉल के साथ अपवाद है, तो पहले पुष्टि करें कि मॉडल आईडी टूल कॉल का समर्थन करता है, फिर टाइमआउट को बढ़ाता है.
5. सामान्य त्रुटियाँ
- Invalid_api_key:
AI2SAVE_API_KEYपरिभाषित नहीं है, कुंजी पूरी तरह से कॉपी नहीं की जाती है, या प्रमुख समूह मिलान नहीं करता है. - 404 / मॉडल नहीं मिला:
models[].id,primary, या वास्तविक अनुरोधित मॉडल का नामैच नहीं करता है. - कनेक्शन विफल / खाली प्रतिक्रिया: जाँच करें कि क्या
baseUrlहैhttps://ai2save.com/v1, और रूट एड्रेस नहीं लिखते हैं. - मॉडल सूची खाली है: पुष्टि करें
models.mode: "merge", और यह सुनिश्चित करें किmodels.providers.ai2save.models[]कम से कम एक मॉडल शामिल है. - बचत के बाद कॉन्फ़िगरेशन को प्रभावी नहीं किया गया: Reexecute
openclaw doctor, और यदि आवश्यक हो, तो ओपनक्लॉ और गेटवे को पुनः आरंभ करें.