OpenClaw इंस्टॉल करना और OmniProxy कॉन्फ़िगर करना

OpenClaw आपके अपने कंप्यूटर पर इंस्टॉल होने वाला एक AI असिस्टेंट है। आप बिना किसी अन्य चैट विंडो को खुला रखे, सीधे Telegram, Discord, WhatsApp या Feishu के माध्यम से इससे बात कर सकते हैं। बातचीत और रिकॉर्ड इसी कंप्यूटर पर रहते हैं, और यह स्थानीय रूप से बाद के चरणों को पूरा करना जारी रख सकता है।

शुरू करने से पहले

OpenClaw के लिए Node 24.16 या बाद का वर्ज़न आवश्यक है। आप Node 26.1 या बाद का वर्ज़न भी उपयोग कर सकते हैं, जिसमें Node 26 की अनुशंसा की जाती है। Node, OpenClaw के लिए आवश्यक रनटाइम एनवायरनमेंट प्रदान करता है।

इसे macOS, Linux और Windows पर इंस्टॉल किया जा सकता है। यदि कंप्यूटर में Node का उपयुक्त वर्ज़न नहीं है, तो इंस्टॉलेशन स्क्रिप्ट स्वचालित रूप से एक तैयार कर देगी: macOS पर Node 26 और Linux पर Node 24 LTS। pnpm की आवश्यकता केवल तभी होती है जब आप सोर्स से OpenClaw को बिल्ड कर रहे हों।

यदि Node का पुराना वर्ज़न पहले से इंस्टॉल है, तो आपको इसे पहले अनइंस्टॉल करने की आवश्यकता नहीं है। 2026-10-09 को परीक्षण के दौरान, इस कंप्यूटर पर सिस्टम Node वर्ज़न 24.2.0 था, जो आवश्यक 24.16 से कम था, और नॉन-इंटरैक्टिव इंस्टॉलेशन स्क्रिप्ट ने स्वचालित रूप से Node 24.21.0 तैयार कर लिया।

विंडो चाहिए

डेस्कटॉप कंपेनियन

• Windows पर Hub इंस्टॉलर का उपयोग करें
• macOS पर GitHub DMG का उपयोग करें
• स्थानीय Gateway को प्रारंभिक सेटअप के दौरान इंस्टॉल किया जा सकता है

आधिकारिक तौर पर अनुशंसित

इंस्टॉलेशन स्क्रिप्ट

• macOS Linux WSL2
• Windows पर PowerShell का उपयोग करें
• आप --no-onboard जोड़ सकते हैं

Node पहले से इंस्टॉल है

पैकेज मैनेजर

• npm pnpm या bun
• फिर onboard चलाएं
• Node वर्ज़न के लिए इंस्टॉलेशन पेज देखें

पहली बार इंस्टॉल और लॉन्च करें

आप ग्राफिकल विंडो के साथ डेस्कटॉप कंपेनियन इंस्टॉल कर सकते हैं, या सीधे टर्मिनल के माध्यम से इंस्टॉल कर सकते हैं। Gateway वह स्थानीय सेवा है जो संदेश प्राप्त करने, मॉडल को कॉल करने और परिणाम वापस करने के लिए जिम्मेदार है। डेस्कटॉप कंपेनियन को पहली बार खोलते समय आप इसे सेटअप कर सकते हैं।

यदि आप एक विंडो चाहते हैं

• Windows: डाउनलोड करें और चलाएं OpenClawCompanion-Setup-x64.exe या OpenClawCompanion-Setup-arm64.exe। इंस्टॉलर हस्ताक्षरित है और इसमें सेटिंग्स, ट्रे स्टेटस, चैट और नोड मोड शामिल हैं।
• macOS: OpenClaw के GitHub रिलीज़ से OpenClaw .dmg डाउनलोड करें। dmg को प्राथमिकता दें, हालांकि आप .zipका भी उपयोग कर सकते हैं। इंस्टॉलेशन के बाद OpenClaw.app खोलें। यदि इस वर्ज़न में macOS फ़ाइल शामिल नहीं है, तो macOS ऐप पेज का पालन करें।

पहली बार खोलते समय, आप OpenClaw को इस कंप्यूटर पर Gateway तैयार करने दे सकते हैं या किसी मौजूदा रिमोट Gateway से कनेक्ट कर सकते हैं।

टर्मिनल के माध्यम से इंस्टॉल करें

macOS, Linux और WSL2 के लिए, उपयोग करें:

curl -fsSL https://openclaw.ai/install.sh | bash

Windows PowerShell के लिए, उपयोग करें:

iwr -useb https://openclaw.ai/install.ps1 | iex

स्क्रिप्ट वर्तमान सिस्टम का पता लगाती है, आवश्यकता पड़ने पर Node इंस्टॉल करती है, OpenClaw इंस्टॉल करती है, और फिर प्रारंभिक ऑनबोर्डिंग प्रक्रिया शुरू करती है। ऑनबोर्डिंग फ़्लो आपको पहली बार सेटअप करने में मार्गदर्शन करता है।

यदि आप अभी ऑनबोर्डिंग शुरू नहीं करना चाहते हैं, तो इसके बजाय macOS, Linux और WSL2 पर निम्नलिखित का उपयोग करें:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

Windows पर, आधिकारिक -NoOnboard विकल्प का उपयोग करें:

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

यदि आप पहले से ही Node को स्वयं प्रबंधित करते हैं, तो आप npm, pnpm या bun का भी उपयोग कर सकते हैं। npm 12 या npm 11.16 और बाद के वर्ज़न के साथ, चलाएं:

npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon

npm 11.15 और उससे पहले के लिए, --allow-scripts=openclawहटाएं। pnpm का उपयोग करते समय, --allow-build=openclawजोड़ें। सटीक अंतर के लिए इंस्टॉलेशन पेज देखें।

इंस्टॉलेशन के बाद, इन तीन कमांड को क्रम में चलाएं:

openclaw --version
openclaw doctor
openclaw gateway status

openclaw --version वर्ज़न प्रदर्शित करता है, openclaw doctor सामान्य एनवायरनमेंट समस्याओं की जांच करता है, और openclaw gateway status दिखाता है कि क्या Gateway चल रहा है। बुनियादी इंस्टॉलेशन तभी पूरा होता है जब तीनों कमांड सामान्य आउटपुट देते हैं।

यदि टर्मिनल रिपोर्ट करता है कि वह openclawनहीं ढूंढ सकता है, तो npm ग्लोबल बिन डायरेक्टरी आमतौर पर PATH से गायब होती है। PATH उन स्थानों की सूची है जहाँ टर्मिनल प्रोग्राम खोजता है। node -v, npm prefix -gके आउटपुट की तुलना करें, और echo "$PATH"संबंधित बिन डायरेक्टरी को PATH में जोड़ें, और फिर टर्मिनल को फिर से खोलें।

यदि ~/.openclaw में पहले से ही वर्तमान में उपयोग में आने वाला कॉन्फ़िगरेशन है, तो डिफ़ॉल्ट इंस्टॉलेशन स्क्रिप्ट उस डायरेक्टरी का उपयोग करेगी। मौजूदा कॉन्फ़िगरेशन को बदले बिना एक अलग कॉपी इंस्टॉल करने के लिए, नॉन-इंटरैक्टिव स्क्रिप्ट चलाएं और एक नई डायरेक्टरी निर्दिष्ट करें:

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --prefix "$HOME/openclaw-omniproxy" --no-onboard

--no-onboard इस स्क्रिप्ट का डिफ़ॉल्ट व्यवहार है। 2026-10-09 को, इस कमांड ने OpenClaw 2026.9.9 इंस्टॉल किया। इंस्टॉलेशन के बाद, डायरेक्टरी के bin फोल्डर से openclaw एक्जीक्यूटेबल चलाएं।

OmniProxy से कनेक्शन मान प्राप्त करें

पहले पुष्टि करें कि OmniProxy चल रहा है, फिर इसकी मॉडल सूची खोलें और निम्नलिखित तीन मान तैयार करें:

baseUrl: https://your-omniproxy-origin.example/v1
apiKey:  <YOUR_OMNIPROXY_API_KEY>
Model ID: copy the full value from the current OmniProxy model list

baseUrl वह पता है जिस पर OpenClaw मॉडल अनुरोध भेजता है, और यह /v1पर समाप्त होना चाहिए। OmniProxy से कनेक्ट करते समय, openai-completions के लिए apiका उपयोग करें। इसे केवल तभी openai-responses में बदलें यदि मॉडल वास्तव में /v1/responsesके माध्यम से काम करता है।

मॉडल ID सूची में मॉडल का पूर्ण पहचानकर्ता है। इसे बिल्कुल वैसे ही कॉपी करें जैसा दिखाया गया है, जिसमें कोई भी स्लैश शामिल है। निम्नलिखित दो नाम 2026-10-09 तक प्रदाता दस्तावेज़ीकरण के संदर्भ मात्र हैं; यदि वे सूची में दिखाई नहीं देते हैं तो उनका उपयोग न करें: claude-sonnet-5-5, gpt-6-luna।

भले ही गेटवे कुंजी को मान्य न करे, apiKey में अभी भी एक मान होना चाहिए। आप एक प्लेसहोल्डर स्ट्रिंग का उपयोग कर सकते हैं जिसका उपयोग केवल इस कंप्यूटर पर किया जाता है। किसी रिपॉजिटरी में वास्तविक कुंजी कमिट न करें।

टूल कॉन्फ़िगरेशन दर्ज करें

एक प्रदाता (Provider) को कनेक्शन सेटिंग्स के एक सेट के रूप में समझा जा सकता है जिसका उपयोग OpenClaw मॉडल सेवा का पता लगाने के लिए करता है। यहाँ, प्रदाता का नाम omniproxyहै।

टर्मिनल में निम्नलिखित कमांड चलाएं, पता, कुंजी और दो मॉडल ID को अपने स्वयं के मानों से बदलें:

openclaw config set models.providers.omniproxy '{"baseUrl":"https://your-omniproxy-origin.example/v1","apiKey":"<YOUR_OMNIPROXY_API_KEY>","api":"openai-completions","models":[{"id":"claude-sonnet-5-5","name":"Claude Sonnet 5.5"},{"id":"gpt-6-luna","name":"GPT-6 Luna"}]}' --strict-json --merge

यह कमांड प्रदाता और मॉडल सूची को कॉन्फ़िगरेशन में लिखती है। कमांड सफल होने के बाद आपको Gateway को पुनरारंभ करने की आवश्यकता नहीं है।

इसके बाद, डिफ़ॉल्ट मॉडल निर्दिष्ट करें। मॉडल संदर्भ में omniproxy/ और उसके बाद मॉडल ID शामिल होता है। ID में पहले से मौजूद प्रत्येक स्लैश को सुरक्षित रखें। यदि मॉडल सूची में ID नीचे दिए गए संक्षिप्त नाम से लंबी है, तो सूची से पूर्ण मान का उपयोग करें:

openclaw config set agents.defaults.model.primary '"omniproxy/claude-sonnet-5-5"' --strict-json

reasoning, input, cost, contextWindowऔर maxTokens सभी को छोड़ा जा सकता है। जब वे प्रदान नहीं किए जाते हैं, तो टेक्स्ट मॉडल डिफ़ॉल्ट का उपयोग करके संभाले जाते हैं।

आप उन्हीं सेटिंग्स को सीधे कॉन्फ़िगरेशन फ़ाइल में भी लिख सकते हैं। मुख्य कॉन्फ़िगरेशन में, प्रदाता models.providersके अंतर्गत स्थित है। प्रत्येक एजेंट का अपना models.jsonभी हो सकता है; एक एजेंट एक असिस्टेंट इंस्टेंस है जो वास्तव में कार्य प्राप्त करता है और मॉडल को कॉल करता है। फ़ाइल agent/models.json के अंतर्गत संबंधित एजेंट डायरेक्टरी में ~/.openclaw/agents/पर स्थित है।

यदि इस models.json में एक गैर-रिक्त baseUrlहै, तो यह मुख्य कॉन्फ़िगरेशन में पते को ओवरराइड कर देता है।

इंस्टॉलेशन की जांच करें

तीन कमांड

• openclaw --version
• openclaw doctor
• gateway status

कॉन्फ़िगरेशन

models.providers

• baseUrl /v1 पर समाप्त होता है
• api को completions पर सेट करें
• कम से कम मॉडल id निर्दिष्ट करें

चुनें

provider/model

• प्राथमिक के लिए इस संदर्भ का उपयोग करें
• कुंजी के लिए एनवायरनमेंट वेरिएबल को प्राथमिकता दें
• सत्य के स्रोत के रूप में गेटवे सूची का उपयोग करें

वास्तविक कार्य सत्यापित करें

एक नियमित प्रोजेक्ट डायरेक्टरी दर्ज करें और एक बहुत छोटा संदेश भेजें। कमांड में मॉडल संदर्भ को अपनी पूर्ण मॉडल ID से बदलें:

openclaw agent --local --model omniproxy/claude-sonnet-5-5 --timeout 300 --message "Reply with one word."

--local इस एजेंट कार्य को स्थानीय रूप से चलाता है, --model इस रन के लिए उपयोग किए जाने वाले मॉडल को निर्दिष्ट करता है, और --timeout 300 अधिकतम प्रतीक्षा समय को 300 सेकंड पर सेट करता है।

टर्मिनल में एक वास्तविक मॉडल प्रतिक्रिया दिखाई देनी चाहिए। 2026-10-09 को, OpenClaw 2026.9.9 ने इस कमांड का उपयोग करके एक प्रतिक्रिया प्राप्त की। पहली कॉल में एक या दो मिनट लग सकते हैं।

यदि मूल त्रुटि Request timed out before a response was generated दिखाई देती है, तो --timeout बढ़ाएं और अनुरोध फिर से भेजें। इसका मतलब आमतौर पर यह है कि प्रतीक्षा समय अपर्याप्त था और यह जरूरी नहीं कि पता गलत है।

छोटी प्रतिक्रिया सफल होने के बाद, इसे आपके द्वारा निर्दिष्ट स्थानीय फ़ाइल को पढ़ने के लिए कहें। फिर OmniProxy के अनुरोध रिकॉर्ड खोलें और रिकॉर्ड में दिखाए गए स्रोत और मॉडल ID की पुष्टि करें। केवल वर्ज़न कमांड या डॉक्टर से आउटपुट का मतलब यह नहीं है कि मॉडल कनेक्शन पूरी तरह से कॉन्फ़िगर हो गया है।

इंस्टॉलेशन

कमांड प्रतिक्रिया देता है

• वर्ज़न नंबर प्रदर्शित होता है
• डॉक्टर कोई अवरोधक रिपोर्ट नहीं करता है
• गेटवे स्थिति पठनीय है

कार्य

इसने एक छोटा कार्य पूरा किया

• उदाहरण के लिए, एक स्थानीय फ़ाइल पढ़ें
• प्रतिक्रिया कोई त्रुटि नहीं है
• मॉडल संदर्भ सही है

लॉग

गेटवे में दिखाई देता है

• स्रोत OpenClaw है
• मॉडल ID मेल खाता है
• कुंजी रिपॉजिटरी में नहीं जोड़ी गई थी

सामान्य त्रुटियां

• openclawनहीं मिल सकता: npm ग्लोबल बिन डायरेक्टरी को PATH में जोड़ें, फिर टर्मिनल को फिर से खोलें। यदि आपने किसी निर्दिष्ट डायरेक्टरी में इंस्टॉल किया है, तो उस डायरेक्टरी के bin फोल्डर से एक्जीक्यूटेबल चलाएं।
• node -v 24.16 से कम है: आपको पहले पुराने वर्ज़न को अनइंस्टॉल करने की आवश्यकता नहीं है। इंस्टॉलेशन स्क्रिप्ट द्वारा तैयार किए गए Node वर्ज़न की जांच करें, या इंस्टॉलेशन पेज पर वर्णित अनुसार 24.16+ या 26.1+ का उपयोग करें। Node 26 की अनुशंसा की जाती है।
• मॉडल दिखाई नहीं देता है: मॉडल को models के अंतर्गत models.providers ऐरे में शामिल किया जाना चाहिए और कम से कम समान idहोना चाहिए। केवल agents.defaults.models सेट करना अपने आप में एक नया मॉडल पंजीकृत नहीं करता है।
• 400 प्रतिक्रिया डेवलपर भूमिका का उल्लेख करती है: जब पता होस्ट api.openai.comनहीं है, तो डिफ़ॉल्ट रखें और supportsDeveloperRole को true पर सेट न करें। भले ही इसे true पर सेट किया गया हो, फिर भी इसे ओवरराइड कर दिया जाएगा।
• यह जल्दी टाइम आउट हो जाता है: पते को बदलने से पहले --timeout को 300 सेकंड से अधिक बढ़ाएं।
• gpt-6-lunaचुनने के बाद टूल कॉल विफल हो जाते हैं: यह चैट कंप्लीशन्स का समर्थन करता है; चैट कंप्लीशन्स में फ़ंक्शन कॉलिंग केवल तभी समर्थित है जब reasoning_effort है none। यदि सूची में ID इससे भिन्न है, तो सूची में दिखाई गई ID का उपयोग करें।
• पते तक नहीं पहुँचा जा सकता: पुष्टि करें कि OmniProxy चल रहा है, कि baseUrl /v1 पर समाप्त होता है, और यह कि कॉन्फ़िगरेशन में लिखा गया पता सुलभ है। अन्य निजी-नेटवर्क पतों को अलग से अनुमति दी जानी चाहिए।
• कॉन्फ़िगरेशन के बाद भी अनुरोध दूसरे पते पर जाते हैं: जांचें कि क्या उस एजेंट के models.json में एक अलग baseUrl है।

आधिकारिक संदर्भ

इंस्टॉलेशन चरणों के लिए, OpenClaw install देखें। कस्टम प्रदाता कॉन्फ़िगरेशन के लिए, Custom providers और configuration fields देखें। उदाहरणों में उपयोग की गई मॉडल ID के लिए, Claude model overview और GPT-6 Luna के साथ तुलना करें।

अपनी स्वयं की OmniProxy कॉन्फ़िगरेशन से प्रत्येक प्लेसहोल्डर को मान से बदलें। कभी भी एक वास्तविक कुंजी प्रकाशित न करें।

एक सहेजा गया परिणाम या HTTP 200 अकेले पूरी एजेंट संगतता को साबित नहीं करता है। OmniProxy के कॉल रिकॉर्ड में स्रोत और मॉडल जांचें।

आधिकारिक स्रोत · OpenClaw ↗