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. जेव्हा तुम्ही सोर्सपासून OpenClaw बिल्ड करता तेव्हाच pnpm आवश्यक असते.

जर 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 .dmg OpenClaw च्या GitHub रिलीजमधून. 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 इन्स्टॉल केले. इन्स्टॉलेशननंतर, चालवा openclaw एक्झिक्युटेबल डिरेक्टरीच्या bin फोल्डरमधून.

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.

जरी गेटवे की (key) सत्यापित करत नसला तरी, apiKey मध्ये अजूनही एक व्हॅल्यू असणे आवश्यक आहे. तुम्ही एक प्लेसहोल्डर स्ट्रिंग वापरू शकता जी फक्त या संगणकावर वापरली जाते. रिपॉझिटरीमध्ये खरी की (key) कमिट करू नका.

टूल कॉन्फिगरेशन प्रविष्ट करा

प्रदाता (Provider) म्हणजे कनेक्शन सेटिंग्जचा एक संच जो OpenClaw मॉडेल सेवा शोधण्यासाठी वापरतो. येथे, प्रदात्याचे नाव आहे omniproxy.

टर्मिनलमध्ये खालील कमांड चालवा, पत्ता, की (key) आणि दोन मॉडेल 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

• प्राथमिकसाठी हा संदर्भ वापरा
• की (key) साठी एन्वायरमेंट व्हेरिएबलला प्राधान्य द्या
• सत्याचे स्रोत म्हणून गेटवे यादी वापरा

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

एका सामान्य प्रोजेक्ट डिरेक्टरीमध्ये प्रवेश करा आणि एक अतिशय लहान मेसेज पाठवा. कमांडमधील मॉडेल संदर्भ तुमच्या पूर्ण मॉडेल 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 तपासा. फक्त आवृत्ती कमांड किंवा डॉक्टरकडून मिळालेले आउटपुट म्हणजे मॉडेल कनेक्शन पूर्णपणे कॉन्फिगर झाले आहे असा होत नाही.

इन्स्टॉलेशन

कमांड प्रतिसाद देते

• आवृत्ती क्रमांक प्रदर्शित केला जातो
• डॉक्टर कोणतेही अडथळे दर्शवत नाही
• Gateway स्टेटस वाचण्यायोग्य आहे

कार्य

ते एक छोटे कार्य पूर्ण केले

• उदाहरणार्थ, स्थानिक फाईल वाचा
• प्रतिसाद त्रुटी नाही
• मॉडेल संदर्भ योग्य आहे

लॉग्स

गेटवेमध्ये दृश्यमान

• स्रोत OpenClaw आहे
• मॉडेल ID जुळते
• की (key) रिपॉझिटरीमध्ये जोडली गेली नाही

सामान्य त्रुटी

• शोधू शकत नाही 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 ↗