OpenClaw स्थापित करणे आणि OmniProxy कॉन्फिगर करणे

OpenClaw हा तुमच्या स्वतःच्या संगणकावर स्थापित केलेला एक एआय असिस्टंट आहे. तुम्ही टेलिग्राम, डिस्कोर्ड, व्हॉट्सॲप किंवा फीशू (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 वापरा
• स्थानिक गेटवे सुरुवातीच्या सेटअप दरम्यान स्थापित केला जाऊ शकतो

अधिकृतपणे शिफारस केलेले

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

• macOS Linux WSL2
• Windows वर PowerShell वापरा
• तुम्ही --no-onboard जोडू शकता

Node आधीच स्थापित आहे

पॅकेज मॅनेजर

• npm pnpm किंवा bun
• त्यानंतर onboard चालवा
• Node आवृत्तीसाठी इंस्टॉलेशन पृष्ठ पहा

प्रथमच स्थापित आणि लाँच करा

तुम्ही ग्राफिकल विंडोसह डेस्कटॉप कंपॅनियन स्थापित करू शकता किंवा थेट टर्मिनलद्वारे स्थापित करू शकता. गेटवे ही स्थानिक सेवा आहे जी संदेश प्राप्त करण्यासाठी, मॉडेल्सना कॉल करण्यासाठी आणि निकाल परत करण्यासाठी जबाबदार आहे. डेस्कटॉप कंपॅनियन पहिल्यांदा उघडताना तुम्ही ते सेट करू शकता.

जर तुम्हाला विंडो हवी असेल

• Windows: डाउनलोड करा आणि चालवा OpenClawCompanion-Setup-x64.exe किंवा OpenClawCompanion-Setup-arm64.exe. इंस्टॉलर स्वाक्षरीकृत आहे आणि त्यात सेटिंग्ज, ट्रे स्टेटस, चॅट आणि नोड मोड समाविष्ट आहेत.
• macOS: OpenClaw च्या GitHub रिलीजमधून OpenClaw .dmg डाउनलोड करा. dmg ला प्राधान्य द्या, जरी तुम्ही .zipदेखील वापरू शकता. इंस्टॉलेशननंतर OpenClaw.app उघडा. जर या आवृत्तीमध्ये macOS फाईल समाविष्ट नसेल, तर macOS ॲप पृष्ठाचे अनुसरण करा.

पहिल्यांदा उघडताना, तुम्ही OpenClaw ला या संगणकावर गेटवे तयार करू देऊ शकता किंवा विद्यमान रिमोट गेटवेशी कनेक्ट करू शकता.

टर्मिनलद्वारे स्थापित करा

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

जर टर्मिनलने 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द्वारे कार्य करत असेल.

मॉडेल आयडी (Model ID) हा यादीतील मॉडेलचा पूर्ण ओळखकर्ता आहे. तो जसा दिसतो तसाच कॉपी करा, कोणत्याही स्लॅशसह. खालील दोन नावे केवळ 2026-10-09 पर्यंतच्या प्रदाता दस्तऐवजीकरणातील संदर्भ आहेत; जर ती यादीत दिसत नसतील तर त्यांचा वापर करू नका: claude-sonnet-5-5, gpt-6-luna.

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

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

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

टर्मिनलमध्ये खालील कमांड चालवा, पत्ता, की आणि दोन मॉडेल आयडी तुमच्या स्वतःच्या मूल्यांसह बदला:

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

ही कमांड प्रदाता आणि मॉडेल यादी कॉन्फिगरेशनमध्ये लिहिते. कमांड यशस्वी झाल्यानंतर तुम्हाला गेटवे रीस्टार्ट करण्याची गरज नाही.

पुढे, डीफॉल्ट मॉडेल निर्दिष्ट करा. मॉडेल संदर्भामध्ये omniproxy/ आणि त्यानंतर मॉडेल आयडी असतो. आयडीमध्ये आधीपासून असलेले प्रत्येक स्लॅश जतन करा. जर मॉडेल यादीतील आयडी खालील लहान नावापेक्षा मोठा असेल, तर यादीतील पूर्ण मूल्य वापरा:

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 वर सेट करा
• किमान मॉडेल आयडी निर्दिष्ट करा

निवडा

provider/model

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

वास्तविक कार्याची पडताळणी करा

एका सामान्य प्रोजेक्ट डिरेक्टरीमध्ये प्रवेश करा आणि एक अतिशय लहान संदेश पाठवा. कमांडमधील मॉडेल संदर्भ तुमच्या पूर्ण मॉडेल आयडीसह बदला:

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

इंस्टॉलेशन

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

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

कार्य

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

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

लॉग्स

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

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

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

• 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असते. जर यादीतील आयडी यापेक्षा वेगळा असेल, तर यादीत दर्शविलेला आयडी वापरा.
• पत्त्यापर्यंत पोहोचता येत नाही: OmniProxy चालू असल्याची खात्री करा, baseUrl हे /v1सह संपते आणि कॉन्फिगरेशनमध्ये लिहिलेला पत्ता प्रवेशयोग्य आहे. इतर खाजगी-नेटवर्क पत्ते स्वतंत्रपणे परवानगी दिले पाहिजेत.
• कॉन्फिगरेशननंतर विनंत्या अजूनही दुसऱ्या पत्त्यावर जातात: त्या एजंटच्या models.json मध्ये वेगळे baseUrl.

आहे का ते तपासा.

अधिकृत संदर्भ

इंस्टॉलेशन पायऱ्यांसाठी, OpenClaw install पहा. सानुकूल प्रदाता कॉन्फिगरेशनसाठी, Custom providers आणि configuration fields पहा. उदाहरणांमध्ये वापरलेल्या मॉडेल आयडीसाठी, Claude model overview आणि GPT-6 Luna शी तुलना करा.

तुमच्या स्वतःच्या OmniProxy कॉन्फिगरेशनमधील प्रत्येक जागादार मूल्य बदला. वास्तविक की कधीही प्रकाशित करू नका.

संवर्धित परिणाम किंवा HTTP 200 फक्त पूर्ण एजंट सुसंगतता सिद्ध करत नाही. OmniProxy च्या कॉल रेकॉर्डमध्ये स्रोत आणि मॉडेल तपासा.

अधिकृत स्रोत · OpenClaw ↗