Skip to main content
OpenClaw तीन इंस्टॉलर स्क्रिप्ट के साथ आता है, जिन्हें openclaw.ai से प्रस्तुत किया जाता है। तीनों Node 22.22.3+, 24.15+, या 25.9+ का समर्थन करती हैं; नए इंस्टॉल के लिए Node 24 डिफ़ॉल्ट लक्ष्य है।

त्वरित कमांड

यदि इंस्टॉल सफल हो जाता है, लेकिन नए टर्मिनल में openclaw नहीं मिलता, तो Node.js समस्या निवारण देखें।

install.sh

macOS/Linux/WSL पर अधिकांश इंटरैक्टिव इंस्टॉल के लिए अनुशंसित।

प्रवाह (install.sh)

1

OS का पता लगाएँ

macOS और Linux (WSL सहित) का समर्थन करती है।
2

डिफ़ॉल्ट रूप से Node.js 24 सुनिश्चित करें

Node संस्करण की जाँच करती है और आवश्यकता होने पर Node 24 इंस्टॉल करती है (macOS पर Homebrew, Linux apt/dnf/yum पर NodeSource सेटअप स्क्रिप्ट)। macOS पर Homebrew केवल तभी इंस्टॉल किया जाता है, जब इंस्टॉलर को Node या Git के लिए इसकी आवश्यकता होती है। Node 22.22.3+, Node 24.15+ और Node 25.9+ समर्थित हैं; Node 23 असमर्थित है। Alpine/musl Linux पर इंस्टॉलर NodeSource के बजाय apk पैकेज का उपयोग करता है और वास्तव में लिंक किए गए SQLite संस्करण की पुष्टि करता है। वर्तमान स्थिर Alpine पैकेज स्ट्रीम पर्याप्त रूप से नया Node प्रदान कर सकती हैं, जिसमें असुरक्षित सिस्टम SQLite हो; ऐसा होने पर इसके बजाय आधिकारिक node:24-alpine कंटेनर या glibc-आधारित होस्ट का उपयोग करें।
3

Git सुनिश्चित करें

Git मौजूद न होने पर, पहचाने गए पैकेज मैनेजर का उपयोग करके इसे इंस्टॉल करती है, जिसमें macOS पर Homebrew और Alpine पर apk शामिल हैं।
4

OpenClaw इंस्टॉल करें

  • npm विधि (डिफ़ॉल्ट): वैश्विक npm इंस्टॉल
  • git विधि: रिपॉज़िटरी क्लोन/अपडेट करती है, pnpm से डिपेंडेंसी इंस्टॉल करती है, बिल्ड करती है, फिर ~/.local/bin/openclaw पर रैपर इंस्टॉल करती है
5

इंस्टॉल के बाद के कार्य

  • अनुवर्ती कमांड के लिए अभी-अभी इंस्टॉल की गई openclaw बाइनरी को हल करती है
  • अकॉन्फ़िगर किए गए इंस्टॉल के लिए, doctor या gateway जाँच से पहले ऑनबोर्डिंग शुरू करती है। --no-onboard के साथ या TTY न होने पर, यह सेटअप बाद में पूरा करने के लिए कमांड प्रिंट करती है।
  • कॉन्फ़िगर किए गए इंस्टॉल के लिए, लोड की गई Gateway सेवा को यथासंभव रीफ़्रेश और पुनः आरंभ करती है तथा doctor चलाती है। अपग्रेड संभव होने पर plugins को अपडेट करते हैं, या प्रॉम्प्ट-सक्षम हेडलेस रन में मैन्युअल कमांड प्रिंट करते हैं।
  • जब --verify चलता है, तो यह इंस्टॉल किए गए संस्करण की जाँच करता है और कॉन्फ़िगरेशन मौजूद होने के बाद ही Gateway की स्थिति जाँचता है।

स्रोत चेकआउट की पहचान

यदि इसे किसी OpenClaw चेकआउट (package.json + pnpm-workspace.yaml) के भीतर चलाया जाता है, तो स्क्रिप्ट ये विकल्प देती है:
  • चेकआउट का उपयोग करें (git), या
  • वैश्विक इंस्टॉल का उपयोग करें (npm)
यदि कोई TTY उपलब्ध नहीं है और कोई इंस्टॉल विधि सेट नहीं है, तो यह डिफ़ॉल्ट रूप से npm का उपयोग करती है और चेतावनी देती है। अमान्य विधि चयन या अमान्य --install-method मानों के लिए स्क्रिप्ट कोड 2 के साथ बंद हो जाती है।

उदाहरण (install.sh)


install-cli.sh

उन परिवेशों के लिए डिज़ाइन किया गया है, जहाँ आप सब कुछ स्थानीय प्रीफ़िक्स (डिफ़ॉल्ट ~/.openclaw) के अंतर्गत रखना चाहते हैं और सिस्टम Node डिपेंडेंसी नहीं चाहते। डिफ़ॉल्ट रूप से npm इंस्टॉल का समर्थन करता है, साथ ही उसी प्रीफ़िक्स प्रवाह के अंतर्गत git-चेकआउट इंस्टॉल का भी।

प्रवाह (install-cli.sh)

1

स्थानीय Node रनटाइम इंस्टॉल करें

पिन किया गया समर्थित Node LTS टारबॉल (संस्करण स्क्रिप्ट में अंतर्निहित है और स्वतंत्र रूप से अपडेट किया जाता है, डिफ़ॉल्ट 24.15.0) <prefix>/tools/node-v<version> में डाउनलोड करता है और SHA-256 की पुष्टि करता है। Linux ARMv7, Node 22.22.3 का उपयोग करता है, क्योंकि आधिकारिक Node 24+ ARMv7 बाइनरी उपलब्ध नहीं हैं। Alpine/musl Linux पर, जहाँ Node पिन किए गए रनटाइम के लिए संगत टारबॉल प्रकाशित नहीं करता, apk के साथ nodejs और npm इंस्टॉल करता है, फिर Node और वास्तव में लिंक की गई SQLite लाइब्रेरी, दोनों की पुष्टि करता है। वर्तमान स्थिर Alpine पैकेज स्ट्रीम पर्याप्त रूप से नया Node होने पर भी असुरक्षित SQLite से लिंक हो सकती हैं; सुरक्षा जाँच द्वारा पैकेज अस्वीकार किए जाने पर आधिकारिक node:24-alpine कंटेनर या glibc-आधारित होस्ट का उपयोग करें।
2

Git सुनिश्चित करें

Git मौजूद न होने पर, Linux पर apt/dnf/yum/apk या macOS पर Homebrew के माध्यम से इसे इंस्टॉल करने का प्रयास करता है।
3

प्रीफ़िक्स के अंतर्गत OpenClaw इंस्टॉल करें

  • npm विधि (डिफ़ॉल्ट): npm के साथ प्रीफ़िक्स के अंतर्गत इंस्टॉल करती है, फिर <prefix>/bin/openclaw में रैपर लिखती है
  • git विधि: चेकआउट (डिफ़ॉल्ट ~/openclaw) को क्लोन/अपडेट करती है और फिर भी रैपर को <prefix>/bin/openclaw में लिखती है
4

लोड की गई Gateway सेवा रीफ़्रेश करें

यदि उसी प्रीफ़िक्स से कोई Gateway सेवा पहले से लोड है, तो स्क्रिप्ट openclaw gateway install --force चलाती है, जो प्रतिस्थापन सेवा को सक्रिय करता है, और फिर यथासंभव Gateway की स्थिति की जाँच करती है।

उदाहरण (install-cli.sh)

openclaw@main और अन्य GitHub स्रोत विनिर्देश npm इंस्टॉल के लिए मान्य --version लक्ष्य नहीं हैं। इसके बजाय --install-method git --version main का उपयोग करें।

install.ps1

प्रवाह (install.ps1)

1

PowerShell + Windows एनवायरनमेंट सुनिश्चित करें

PowerShell 5+ आवश्यक है।
2

डिफ़ॉल्ट रूप से Node.js 24 सुनिश्चित करें

उपलब्ध न होने पर, पहले winget, फिर Chocolatey और फिर Scoop के माध्यम से इंस्टॉल करने का प्रयास करता है। यदि कोई पैकेज मैनेजर उपलब्ध नहीं है, तो स्क्रिप्ट आधिकारिक Node.js 24 Windows zip को %LOCALAPPDATA%\OpenClaw\deps\portable-node में डाउनलोड करती है और उसे मौजूदा प्रोसेस तथा उपयोगकर्ता PATH में जोड़ती है। Node 22.22.3+, Node 24.15+, और Node 25.9+ समर्थित हैं; Node 23 समर्थित नहीं है।
3

OpenClaw इंस्टॉल करें

  • npm विधि (डिफ़ॉल्ट): चुने गए -Tag का उपयोग करके वैश्विक npm इंस्टॉल, जिसे लिखने योग्य इंस्टॉलर अस्थायी डायरेक्टरी से शुरू किया जाता है ताकि C:\ जैसे सुरक्षित फ़ोल्डर में खोले गए शेल भी काम करें
  • git विधि: रिपॉज़िटरी क्लोन/अपडेट करें, pnpm से इंस्टॉल/बिल्ड करें और %USERPROFILE%\.local\bin\openclaw.cmd पर रैपर इंस्टॉल करें। यदि Git उपलब्ध नहीं है, तो स्क्रिप्ट %LOCALAPPDATA%\OpenClaw\deps\portable-git के अंतर्गत उपयोगकर्ता-स्थानीय MinGit बूटस्ट्रैप करती है और उसे मौजूदा प्रोसेस तथा उपयोगकर्ता PATH में जोड़ती है।
4

इंस्टॉल के बाद के कार्य

  • जहाँ संभव हो, आवश्यक bin डायरेक्टरी को उपयोगकर्ता PATH में जोड़ता है
  • लोड की गई Gateway सेवा को यथासंभव रीफ़्रेश करता है (openclaw gateway install --force, फिर पुनः आरंभ)
  • अपग्रेड और git इंस्टॉल पर openclaw doctor --non-interactive चलाता है (यथासंभव)
5

विफलताएँ संभालें

iwr ... | iex और scriptblock इंस्टॉल मौजूदा PowerShell सत्र बंद किए बिना एक समापनकारी त्रुटि रिपोर्ट करते हैं। प्रत्यक्ष powershell -File / pwsh -File इंस्टॉल अब भी ऑटोमेशन के लिए गैर-शून्य कोड के साथ बाहर निकलते हैं।

उदाहरण (install.ps1)

यदि -InstallMethod git का उपयोग किया जाता है और Git उपलब्ध नहीं है, तो स्क्रिप्ट Git for Windows लिंक दिखाने से पहले उपयोगकर्ता-स्थानीय MinGit बूटस्ट्रैप करने का प्रयास करती है।

CI और ऑटोमेशन

अनुमानित ढंग से चलाने के लिए गैर-इंटरैक्टिव फ़्लैग/एनवायरनमेंट वेरिएबल का उपयोग करें।

समस्या निवारण

git इंस्टॉल विधि के लिए Git आवश्यक है। npm इंस्टॉल के लिए भी Git की जाँच/इंस्टॉल की जाती है, ताकि निर्भरताओं द्वारा git URL उपयोग किए जाने पर spawn git ENOENT विफलताओं से बचा जा सके।
कुछ Linux सेटअप npm के वैश्विक प्रीफ़िक्स को root के स्वामित्व वाले पथों पर इंगित करते हैं। install.sh प्रीफ़िक्स को ~/.npm-global पर बदल सकता है और शेल rc फ़ाइलों में PATH एक्सपोर्ट जोड़ सकता है (जब वे फ़ाइलें मौजूद हों)।
इंस्टॉलर दोबारा चलाएँ ताकि वह उपयोगकर्ता-स्थानीय MinGit बूटस्ट्रैप कर सके, या Git for Windows इंस्टॉल करके PowerShell दोबारा खोलें।
npm config get prefix चलाएँ और उस डायरेक्टरी को अपने उपयोगकर्ता PATH में जोड़ें (Windows पर \bin प्रत्यय आवश्यक नहीं है), फिर PowerShell दोबारा खोलें।
install.ps1 कोई -Verbose स्विच उपलब्ध नहीं कराता। स्क्रिप्ट-स्तरीय निदान के लिए PowerShell ट्रेसिंग का उपयोग करें:
आमतौर पर यह PATH की समस्या होती है। Node.js समस्या निवारण देखें।

संबंधित