इंस्टॉल गाइड

शुरू से OpenClaw इंस्टॉल करना बहुत आसान है! नीचे दिए गए स्टेप्स फ़ॉलो करें, बस 5-10 मिनट में हो जाएगा। चिंता मत करो, हम हर स्टेप समझाएंगे।

📋 सिस्टम ज़रूरतें

इंस्टॉल शुरू करने से पहले, ये चेक कर लो कि आपका कंप्यूटर इन बेसिक ज़रूरतों को पूरा करता है:

Node.js 22 या उससे ऊपर — यह OpenClaw चलाने का बेसिक एनवायरनमेंट है (चिंता मत करो, इंस्टॉल स्क्रिप्ट खुद चेक कर लेगी)
ऑपरेटिंग सिस्टम — macOS, Linux, या Windows (WSL2 चाहिए)
मेमोरी — कम से कम 2GB फ़्री RAM
डिस्क स्पेस — कम से कम 500MB फ़्री स्पेस
इंटरनेट — डाउनलोड और AI मॉडल API कॉल के लिए ज़रूरी

ℹ️ Node.js क्या है? सीधी भाषा में कहें तो, Node.js एक "ट्रांसलेटर" है जो आपके कंप्यूटर को JavaScript में लिखे प्रोग्राम चलाने देता है। OpenClaw JavaScript में लिखा गया है, इसलिए Node.js चाहिए। आपको JavaScript सीखने की ज़रूरत नहीं है, बस Node.js इंस्टॉल कर लो।

ℹ️ WSL2 क्या है? Windows यूज़र्स ध्यान दें: OpenClaw सीधे Windows पर नहीं चलता, इसके लिए WSL2 (Windows Subsystem for Linux 2) चाहिए — यह Windows के अंदर एक मिनी Linux सिस्टम जैसा है। अगर आप Windows यूज़ करते हैं, तो इंस्टॉल स्क्रिप्ट खुद इसे सेटअप कर देगी।

🌟 तरीक़ा 1: वन-क्लिक इंस्टॉल स्क्रिप्ट (नए लोगों के लिए बेस्ट!)

यह सबसे आसान तरीक़ा है। बस टर्मिनल में एक लाइन कॉपी-पेस्ट करो, स्क्रिप्ट सब कुछ अपने आप कर देगी। सच में बहुत आसान है!

💡 "टर्मिनल" क्या है? टर्मिनल एक विंडो है जहाँ आप टेक्स्ट कमांड टाइप कर सकते हैं। macOS पर इसे "Terminal" कहते हैं, Windows पर "PowerShell" कहते हैं। अपने कंप्यूटर में "Terminal" सर्च करके इसे खोल सकते हैं।

टर्मिनल खोलें

Command + Space दबाएँ, "Terminal" टाइप करें, फिर Enter दबाएँ। एक काली (या सफ़ेद) कमांड लाइन विंडो खुल जाएगी।

इंस्टॉल कमांड कॉपी-पेस्ट करें

नीचे दी गई कमांड कॉपी करें, टर्मिनल में पेस्ट करें, फिर Enter दबाएँ:

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

यह कमांड ये काम करेगी:

चेक करेगी कि आपके कंप्यूटर में Node.js है या नहीं, नहीं है तो खुद इंस्टॉल कर देगी
OpenClaw का लेटेस्ट वर्ज़न डाउनलोड और इंस्टॉल करेगी
सेटअप विज़ार्ड (onboarding) चलाएगी जो बेसिक सेटिंग्स में मदद करेगी

इंस्टॉल होने का इंतज़ार करें

इंस्टॉलेशन में लगभग 2-5 मिनट लगेंगे, आपकी इंटरनेट स्पीड पर निर्भर करता है। टर्मिनल में बहुत सारा टेक्स्ट स्क्रॉल होगा — यह नॉर्मल है, घबराइए नहीं! इंस्टॉल पूरा होने पर सेटअप विज़ार्ड खुद शुरू हो जाएगा।

टर्मिनल खोलें

Linux पर Ctrl + Alt + T दबाकर टर्मिनल खोल सकते हैं, या ऐप मेन्यू में "Terminal" सर्च करें।

इंस्टॉल कमांड कॉपी-पेस्ट करें

macOS जैसा ही, नीचे की कमांड कॉपी करें, टर्मिनल में पेस्ट करें, Enter दबाएँ:

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

स्क्रिप्ट खुद Node.js चेक करेगी, OpenClaw डाउनलोड और इंस्टॉल करेगी, सेटअप विज़ार्ड चलाएगी।

इंस्टॉल होने का इंतज़ार करें

कुछ मिनट का इंतज़ार करें, जब सेटअप विज़ार्ड का प्रॉम्प्ट दिखे तो इंस्टॉल सफल हो गया!

PowerShell खोलें (एडमिनिस्ट्रेटर के रूप में)

Start मेन्यू में "PowerShell" सर्च करें, राइट-क्लिक करें, "Run as Administrator" चुनें। यह स्टेप ज़रूरी है क्योंकि इंस्टॉलेशन के लिए एडमिन परमिशन चाहिए।

इंस्टॉल कमांड कॉपी-पेस्ट करें

Windows यूज़र्स के लिए यह स्पेशल कमांड है:

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

यह स्क्रिप्ट खुद ये सब करेगी:

WSL2 चेक और सेटअप करेगी (अगर पहले से नहीं है)
Node.js इंस्टॉल करेगी
OpenClaw डाउनलोड और इंस्टॉल करेगी
सेटअप विज़ार्ड चलाएगी

इंस्टॉल होने का इंतज़ार करें

Windows पर इंस्टॉलेशन थोड़ा धीमा हो सकता है (WSL2 इंस्टॉल करना पड़ सकता है), लगभग 5-10 मिनट। पूरा होने पर सेटअप विज़ार्ड खुद शुरू हो जाएगा।

⚠️ Windows यूज़र्स ध्यान दें: WSL2 इंस्टॉल करने के बाद कंप्यूटर रीस्टार्ट करना पड़ सकता है। अगर स्क्रिप्ट रीस्टार्ट करने को कहे, तो पहले रीस्टार्ट करें, फिर दोबारा इंस्टॉल कमांड चलाएँ।

📦 तरीक़ा 2: npm से इंस्टॉल

अगर आप Node.js और npm (Node.js का पैकेज मैनेजर) से पहले से परिचित हैं, तो यह तरीक़ा इस्तेमाल कर सकते हैं। इससे आपको ज़्यादा कंट्रोल मिलता है।

Node.js इंस्टॉल है या नहीं चेक करें

टर्मिनल खोलें और यह कमांड टाइप करें:

node --version

अगर v22.x.x या उससे ऊपर दिखे, तो आप तैयार हैं। अगर इंस्टॉल नहीं है या वर्ज़न पुराना है, तो nodejs.org से लेटेस्ट वर्ज़न डाउनलोड करें।

npm से OpenClaw ग्लोबली इंस्टॉल करें

टर्मिनल में यह चलाएँ:

npm install -g openclaw@latest

इस कमांड का मतलब:

npm install — npm से सॉफ़्टवेयर इंस्टॉल करो
-g — ग्लोबल इंस्टॉल, ताकि कहीं से भी openclaw कमांड चला सकें
openclaw@latest — OpenClaw का लेटेस्ट वर्ज़न इंस्टॉल करो

सेटअप चलाएँ और बैकग्राउंड सर्विस रजिस्टर करें

इंस्टॉल होने के बाद यह चलाएँ:

openclaw onboard --install-daemon

यह कमांड दो काम करती है:

onboard — सेटअप विज़ार्ड शुरू करती है (AI मॉडल चुनना, API key डालना आदि)
--install-daemon — OpenClaw को बैकग्राउंड सर्विस के रूप में रजिस्टर करती है, ताकि कंप्यूटर ऑन होते ही यह खुद शुरू हो जाए

💡 Daemon (डेमन) क्या है? सीधे शब्दों में: एक प्रोग्राम जो बैकग्राउंड में चुपचाप चलता रहता है, आपको इसकी विंडो नहीं दिखती लेकिन यह काम करता रहता है। --install-daemon लगाने से OpenClaw बैकग्राउंड में चलता रहेगा, हमेशा आपके मैसेज का इंतज़ार करते हुए।

🐳 तरीक़ा 3: Docker से इंस्टॉल

अगर आप Docker (एक कंटेनर टेक्नोलॉजी) इस्तेमाल करते हैं, या OpenClaw को पूरी तरह अलग एनवायरनमेंट में चलाना चाहते हैं, तो यह तरीक़ा चुनें।

ℹ️ Docker क्या है? Docker एक "वर्चुअल बॉक्स" जैसा है, आप सॉफ़्टवेयर को इसमें डालकर चला सकते हैं। इस तरह अगर सॉफ़्टवेयर में कोई दिक़्क़त आए तो आपके कंप्यूटर पर असर नहीं पड़ता। अगर Docker नहीं जानते, तो तरीक़ा 1 या 2 इस्तेमाल करें।

Docker इंस्टॉल है या नहीं चेक करें

अगर Docker नहीं है, तो docker.com से Docker Desktop डाउनलोड करें।

OpenClaw Docker कंटेनर चलाएँ

docker run -d \
  --name openclaw \
  -p 18789:18789 \
  -v ~/.openclaw:/root/.openclaw \
  ghcr.io/openclaw/openclaw:latest

यह कमांड OpenClaw का Docker इमेज डाउनलोड करके कंटेनर शुरू करेगी। -v पैरामीटर कॉन्फ़िग फ़ाइलों को आपके कंप्यूटर पर मैप करता है ताकि डेटा सेफ़ रहे।

✅ इंस्टॉल के बाद जाँच

इंस्टॉल हो गया? अब चेक करते हैं कि सब ठीक है। नीचे के स्टेप्स फ़ॉलो करें:

हेल्थ चेक चलाएँ

openclaw doctor

यह कमांड OpenClaw का "मेडिकल चेकअप" करती है। सारे ज़रूरी कंपोनेंट्स की जाँच होगी। सब सही है तो हरे रंग के टिक मार्क दिखेंगे।

स्टेटस चेक करें

openclaw status

यह बताता है कि OpenClaw चल रहा है या नहीं। अगर "running" दिखे, तो सब बढ़िया!

वेब कंट्रोल पैनल खोलें

openclaw dashboard

यह कमांड ब्राउज़र में OpenClaw का वेब कंट्रोल पैनल खोल देगी:

http://127.0.0.1:18789/

इस पैनल में आप OpenClaw की सारी सेटिंग्स और स्टेटस देख सकते हैं!

🎉 अगर तीनों कमांड बिना एरर के चल गईं, बधाई हो! OpenClaw सफलतापूर्वक इंस्टॉल हो गया! अब क्विक स्टार्ट सेक्शन पर जाएँ।

🛠️ इंस्टॉल में आम समस्याएँ

कोई दिक़्क़त आई? घबराइए मत! नीचे इंस्टॉल में सबसे आम समस्याएँ और उनके हल दिए हैं:

समस्या 1: कमांड नहीं मिली (command not found: openclaw)

यह आमतौर पर PATH एनवायरनमेंट वैरिएबल की समस्या है। सीधे शब्दों में, आपका कंप्यूटर नहीं जानता कि openclaw कमांड कहाँ है।

हल:

# देखें openclaw कहाँ इंस्टॉल है
which openclaw || npm list -g openclaw

# अगर bash इस्तेमाल करते हैं
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# अगर zsh इस्तेमाल करते हैं (macOS डिफ़ॉल्ट)
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

समस्या 2: Node.js वर्ज़न पुराना है

अगर "Node.js v18 is not supported" जैसी एरर दिखे, तो Node.js अपग्रेड करना होगा।

हल:

# nvm (Node Version Manager) से Node.js वर्ज़न मैनेज करें
# पहले nvm इंस्टॉल करें
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# Node.js 22 इंस्टॉल करें
nvm install 22

# Node.js 22 पर स्विच करें
nvm use 22

# वर्ज़न कन्फ़र्म करें
node --version

समस्या 3: पोर्ट कॉन्फ़्लिक्ट (EADDRINUSE)

अगर "EADDRINUSE: address already in use :::18789" दिखे, तो पोर्ट 18789 पहले से किसी और प्रोग्राम ने ले रखा है।

हल:

# कौन सा प्रोसेस पोर्ट 18789 यूज़ कर रहा है
lsof -i :18789

# अगर पुराना OpenClaw प्रोसेस है, पहले बंद करें
openclaw stop

# फिर दोबारा शुरू करें
openclaw start

समस्या 4: परमिशन एरर (EACCES)

Linux/macOS पर npm ग्लोबल इंस्टॉल करते समय परमिशन की दिक़्क़त हो सकती है।

हल:

# npm की ग्लोबल डायरेक्टरी बदलें
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# फिर दोबारा इंस्टॉल करें
npm install -g openclaw@latest

⚠️ sudo npm install -g कभी इस्तेमाल मत करें! sudo लगाने से परमिशन की समस्या तो हल हो जाएगी, लेकिन इससे सिक्योरिटी प्रॉब्लम हो सकती है। ऊपर बताए गए तरीक़े से npm की ग्लोबल डायरेक्टरी बदलें।

समस्या 5: नेटवर्क टाइमआउट

अगर डाउनलोड बहुत धीमा है या टाइमआउट हो रहा है, तो नेटवर्क की समस्या हो सकती है।

हल:

# npm का मिरर रजिस्ट्री सेट करें
npm config set registry https://registry.npmmirror.com

# फिर दोबारा इंस्टॉल करें
npm install -g openclaw@latest