Install overview
इंस्टॉलर की आंतरिक कार्यप्रणाली
OpenClaw तीन इंस्टॉलर स्क्रिप्ट के साथ आता है, जिन्हें openclaw.ai से प्रस्तुत किया जाता है।
| स्क्रिप्ट | प्लेटफ़ॉर्म | यह क्या करती है |
|---|---|---|
install.sh |
macOS / Linux / WSL | आवश्यकता होने पर Node इंस्टॉल करती है, npm (डिफ़ॉल्ट) या git के माध्यम से OpenClaw इंस्टॉल करती है और ऑनबोर्डिंग चला सकती है। |
install-cli.sh |
macOS / Linux / WSL | npm या git के माध्यम से स्थानीय प्रीफ़िक्स (~/.openclaw) में Node + OpenClaw इंस्टॉल करती है। root की आवश्यकता नहीं है। |
install.ps1 |
Windows (PowerShell) | आवश्यकता होने पर Node इंस्टॉल करती है, npm (डिफ़ॉल्ट) या git के माध्यम से OpenClaw इंस्टॉल करती है और ऑनबोर्डिंग चला सकती है। |
तीनों Node 22.22.3+, 24.15+, या 25.9+ का समर्थन करती हैं; नए इंस्टॉल के लिए Node 24 डिफ़ॉल्ट लक्ष्य है।
त्वरित कमांड
install.sh
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bashcurl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --helpinstall-cli.sh
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bashcurl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --helpinstall.ps1
iwr -useb https://openclaw.ai/install.ps1 | iex& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -Tag beta -NoOnboard -DryRuninstall.sh
प्रवाह (install.sh)
OS का पता लगाएँ
macOS और Linux (WSL सहित) का समर्थन करती है।
डिफ़ॉल्ट रूप से 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-आधारित होस्ट का उपयोग करें।
Git सुनिश्चित करें
Git मौजूद न होने पर, पहचाने गए पैकेज मैनेजर का उपयोग करके इसे इंस्टॉल करती है, जिसमें macOS पर Homebrew और Alpine पर apk शामिल हैं।
OpenClaw इंस्टॉल करें
npmविधि (डिफ़ॉल्ट): वैश्विक npm इंस्टॉलgitविधि: रिपॉज़िटरी क्लोन/अपडेट करती है, pnpm से डिपेंडेंसी इंस्टॉल करती है, बिल्ड करती है, फिर~/.local/bin/openclawपर रैपर इंस्टॉल करती है
इंस्टॉल के बाद के कार्य
- अनुवर्ती कमांड के लिए अभी-अभी इंस्टॉल की गई
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)
डिफ़ॉल्ट
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bashऑनबोर्डिंग छोड़ें
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --no-onboardGit इंस्टॉल
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method gitGitHub main चेकआउट
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git --version mainड्राई रन
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --dry-runइंस्टॉल के बाद पुष्टि करें
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --no-onboard --verifyफ़्लैग संदर्भ
| फ़्लैग | विवरण |
|---|---|
--install-method | --method npm|git |
इंस्टॉल विधि चुनें (डिफ़ॉल्ट: npm) |
--npm |
npm विधि का शॉर्टकट |
--git | --github |
git विधि का शॉर्टकट |
--version <version|dist-tag|spec> |
npm संस्करण, dist-tag या पैकेज विनिर्देश (डिफ़ॉल्ट: latest) |
--beta |
उपलब्ध होने पर beta dist-tag का उपयोग करें, अन्यथा latest पर वापस जाएँ |
--git-dir | --dir <path> |
चेकआउट डायरेक्टरी (डिफ़ॉल्ट: ~/openclaw) |
--no-git-update |
मौजूदा चेकआउट के लिए git pull छोड़ें |
--no-prompt |
प्रॉम्प्ट अक्षम करें |
--no-onboard |
ऑनबोर्डिंग छोड़ें |
--onboard |
ऑनबोर्डिंग सक्षम करें |
--verify |
इंस्टॉल के बाद स्मोक पुष्टि चलाएँ (--version, लोड होने पर Gateway की स्थिति) |
--dry-run |
बदलाव लागू किए बिना कार्रवाइयाँ प्रिंट करें |
--verbose |
डीबग आउटपुट सक्षम करें (set -x, npm notice-स्तरीय लॉग) |
--help | -h |
उपयोग दिखाएँ |
एनवायरनमेंट वेरिएबल संदर्भ
| वेरिएबल | विवरण |
|---|---|
OPENCLAW_INSTALL_METHOD=git|npm |
इंस्टॉल विधि |
OPENCLAW_VERSION=latest|next|<semver>|<spec> |
npm संस्करण, dist-tag या पैकेज विनिर्देश |
OPENCLAW_BETA=0|1 |
उपलब्ध होने पर beta का उपयोग करें |
OPENCLAW_HOME=<path> |
OpenClaw स्थिति और डिफ़ॉल्ट git/ऑनबोर्डिंग पथों की आधार डायरेक्टरी |
OPENCLAW_GIT_DIR=<path> |
चेकआउट डायरेक्टरी |
OPENCLAW_GIT_UPDATE=0|1 |
git अपडेट टॉगल करें |
OPENCLAW_NO_PROMPT=1 |
प्रॉम्प्ट अक्षम करें |
OPENCLAW_VERIFY_INSTALL=1 |
इंस्टॉल के बाद स्मोक पुष्टि चलाएँ |
OPENCLAW_NO_ONBOARD=1 |
ऑनबोर्डिंग छोड़ें |
OPENCLAW_DRY_RUN=1 |
ड्राई रन मोड |
OPENCLAW_VERBOSE=1 |
डीबग मोड |
OPENCLAW_NPM_LOGLEVEL=error|warn|notice |
npm लॉग स्तर (डिफ़ॉल्ट: error, npm पदावनति संबंधी अनावश्यक संदेश छिपाता है) |
install-cli.sh
प्रवाह (install-cli.sh)
स्थानीय 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-आधारित होस्ट का उपयोग करें।
Git सुनिश्चित करें
Git मौजूद न होने पर, Linux पर apt/dnf/yum/apk या macOS पर Homebrew के माध्यम से इसे इंस्टॉल करने का प्रयास करता है।
प्रीफ़िक्स के अंतर्गत OpenClaw इंस्टॉल करें
npmविधि (डिफ़ॉल्ट): npm के साथ प्रीफ़िक्स के अंतर्गत इंस्टॉल करती है, फिर<prefix>/bin/openclawमें रैपर लिखती हैgitविधि: चेकआउट (डिफ़ॉल्ट~/openclaw) को क्लोन/अपडेट करती है और फिर भी रैपर को<prefix>/bin/openclawमें लिखती है
लोड की गई Gateway सेवा रीफ़्रेश करें
यदि उसी प्रीफ़िक्स से कोई Gateway सेवा पहले से लोड है, तो स्क्रिप्ट
openclaw gateway install --force चलाती है, जो प्रतिस्थापन सेवा को सक्रिय करता है,
और फिर यथासंभव Gateway की स्थिति की जाँच करती है।
उदाहरण (install-cli.sh)
डिफ़ॉल्ट
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bashकस्टम प्रीफ़िक्स + संस्करण
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --prefix /opt/openclaw --version latestGit इंस्टॉल
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --install-method git --git-dir ~/openclawऑटोमेशन JSON आउटपुट
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --json --prefix /opt/openclawऑनबोर्डिंग चलाएँ
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --onboardफ़्लैग संदर्भ
| फ़्लैग | विवरण |
|---|---|
--prefix <path> |
इंस्टॉल प्रीफ़िक्स (डिफ़ॉल्ट: ~/.openclaw) |
--install-method | --method npm|git |
इंस्टॉल विधि चुनें (डिफ़ॉल्ट: npm) |
--npm |
npm विधि का शॉर्टकट |
--git | --github |
git विधि का शॉर्टकट |
--git-dir | --dir <path> |
Git चेकआउट डायरेक्टरी (डिफ़ॉल्ट: ~/openclaw) |
--version <ver> |
OpenClaw संस्करण या dist-tag (डिफ़ॉल्ट: latest) |
--node-version <ver> |
Node संस्करण (डिफ़ॉल्ट: 24.15.0; Linux ARMv7 पर 22.22.3) |
--json |
NDJSON इवेंट उत्सर्जित करें |
--onboard |
इंस्टॉल के बाद openclaw onboard चलाएँ |
--no-onboard |
ऑनबोर्डिंग छोड़ें (डिफ़ॉल्ट) |
--set-npm-prefix |
Linux पर, यदि मौजूदा प्रीफ़िक्स लिखने योग्य नहीं है, तो npm प्रीफ़िक्स को बलपूर्वक ~/.npm-global पर सेट करें |
--help | -h |
उपयोग दिखाएँ |
एनवायरनमेंट वेरिएबल संदर्भ
| वेरिएबल | विवरण |
|---|---|
OPENCLAW_PREFIX=<path> |
इंस्टॉल प्रीफ़िक्स |
OPENCLAW_INSTALL_METHOD=git|npm |
इंस्टॉल विधि |
OPENCLAW_VERSION=<ver> |
OpenClaw संस्करण या dist-tag |
OPENCLAW_NODE_VERSION=<ver> |
Node संस्करण |
OPENCLAW_HOME=<path> |
OpenClaw स्थिति और डिफ़ॉल्ट git/ऑनबोर्डिंग पथों की आधार डायरेक्टरी |
OPENCLAW_GIT_DIR=<path> |
git इंस्टॉल के लिए Git चेकआउट डायरेक्टरी |
OPENCLAW_GIT_UPDATE=0|1 |
मौजूदा चेकआउट के लिए git अपडेट टॉगल करें |
OPENCLAW_NO_ONBOARD=1 |
ऑनबोर्डिंग छोड़ें |
OPENCLAW_NPM_LOGLEVEL=error|warn|notice |
npm लॉग स्तर (डिफ़ॉल्ट: error) |
install.ps1
प्रवाह (install.ps1)
PowerShell + Windows एनवायरनमेंट सुनिश्चित करें
PowerShell 5+ आवश्यक है।
डिफ़ॉल्ट रूप से 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 समर्थित नहीं है।
OpenClaw इंस्टॉल करें
npmविधि (डिफ़ॉल्ट): चुने गए-Tagका उपयोग करके वैश्विक npm इंस्टॉल, जिसे लिखने योग्य इंस्टॉलर अस्थायी डायरेक्टरी से शुरू किया जाता है ताकिC:\जैसे सुरक्षित फ़ोल्डर में खोले गए शेल भी काम करेंgitविधि: रिपॉज़िटरी क्लोन/अपडेट करें, pnpm से इंस्टॉल/बिल्ड करें और%USERPROFILE%\.local\bin\openclaw.cmdपर रैपर इंस्टॉल करें। यदि Git उपलब्ध नहीं है, तो स्क्रिप्ट%LOCALAPPDATA%\OpenClaw\deps\portable-gitके अंतर्गत उपयोगकर्ता-स्थानीय MinGit बूटस्ट्रैप करती है और उसे मौजूदा प्रोसेस तथा उपयोगकर्ता PATH में जोड़ती है।
इंस्टॉल के बाद के कार्य
- जहाँ संभव हो, आवश्यक bin डायरेक्टरी को उपयोगकर्ता PATH में जोड़ता है
- लोड की गई Gateway सेवा को यथासंभव रीफ़्रेश करता है (
openclaw gateway install --force, फिर पुनः आरंभ) - अपग्रेड और git इंस्टॉल पर
openclaw doctor --non-interactiveचलाता है (यथासंभव)
विफलताएँ संभालें
iwr ... | iex और scriptblock इंस्टॉल मौजूदा PowerShell सत्र बंद किए बिना एक समापनकारी त्रुटि रिपोर्ट करते हैं। प्रत्यक्ष powershell -File / pwsh -File इंस्टॉल अब भी ऑटोमेशन के लिए गैर-शून्य कोड के साथ बाहर निकलते हैं।
उदाहरण (install.ps1)
डिफ़ॉल्ट
iwr -useb https://openclaw.ai/install.ps1 | iexGit इंस्टॉल
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -InstallMethod gitGitHub main चेकआउट
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -InstallMethod git -Tag mainकस्टम git डायरेक्टरी
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -InstallMethod git -GitDir "C:\openclaw"ड्राई रन
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -DryRunफ़्लैग संदर्भ
| फ़्लैग | विवरण |
|---|---|
-InstallMethod npm|git |
इंस्टॉल विधि (डिफ़ॉल्ट: npm) |
-Tag <tag|version|spec> |
npm dist-tag, संस्करण या पैकेज विनिर्देश (डिफ़ॉल्ट: latest) |
-GitDir <path> |
चेकआउट डायरेक्टरी (डिफ़ॉल्ट: %USERPROFILE%\openclaw) |
-NoOnboard |
ऑनबोर्डिंग छोड़ें |
-NoGitUpdate |
git pull छोड़ें |
-DryRun |
केवल कार्रवाइयाँ प्रिंट करें |
एनवायरनमेंट वेरिएबल संदर्भ
| वेरिएबल | विवरण |
|---|---|
OPENCLAW_INSTALL_METHOD=git|npm |
इंस्टॉल विधि |
OPENCLAW_GIT_DIR=<path> |
चेकआउट डायरेक्टरी |
OPENCLAW_NO_ONBOARD=1 |
ऑनबोर्डिंग छोड़ें |
OPENCLAW_GIT_UPDATE=0 |
git pull अक्षम करें |
OPENCLAW_DRY_RUN=1 |
ड्राई रन मोड |
CI और ऑटोमेशन
अनुमानित ढंग से चलाने के लिए गैर-इंटरैक्टिव फ़्लैग/एनवायरनमेंट वेरिएबल का उपयोग करें।
install.sh (गैर-इंटरैक्टिव npm)
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --no-prompt --no-onboardinstall.sh (गैर-इंटरैक्टिव git)
OPENCLAW_INSTALL_METHOD=git OPENCLAW_NO_PROMPT=1 \ curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bashinstall-cli.sh (JSON)
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --json --prefix /opt/openclawinstall.ps1 (ऑनबोर्डिंग छोड़ें)
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboardसमस्या निवारण
Git क्यों आवश्यक है?
git इंस्टॉल विधि के लिए Git आवश्यक है। npm इंस्टॉल के लिए भी Git की जाँच/इंस्टॉल की जाती है, ताकि निर्भरताओं द्वारा git URL उपयोग किए जाने पर spawn git ENOENT विफलताओं से बचा जा सके।
Linux पर npm में EACCES क्यों आता है?
कुछ Linux सेटअप npm के वैश्विक प्रीफ़िक्स को root के स्वामित्व वाले पथों पर इंगित करते हैं। install.sh प्रीफ़िक्स को ~/.npm-global पर बदल सकता है और शेल rc फ़ाइलों में PATH एक्सपोर्ट जोड़ सकता है (जब वे फ़ाइलें मौजूद हों)।
Windows: "npm error spawn git / ENOENT"
इंस्टॉलर दोबारा चलाएँ ताकि वह उपयोगकर्ता-स्थानीय MinGit बूटस्ट्रैप कर सके, या Git for Windows इंस्टॉल करके PowerShell दोबारा खोलें।
Windows: "openclaw is not recognized"
npm config get prefix चलाएँ और उस डायरेक्टरी को अपने उपयोगकर्ता PATH में जोड़ें (Windows पर \bin प्रत्यय आवश्यक नहीं है), फिर PowerShell दोबारा खोलें।
Windows: इंस्टॉलर का विस्तृत आउटपुट कैसे प्राप्त करें
install.ps1 कोई -Verbose स्विच उपलब्ध नहीं कराता।
स्क्रिप्ट-स्तरीय निदान के लिए PowerShell ट्रेसिंग का उपयोग करें:
Set-PSDebug -Trace 1& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboardSet-PSDebug -Trace 0इंस्टॉल के बाद openclaw नहीं मिला
आमतौर पर यह PATH की समस्या होती है। Node.js समस्या निवारण देखें।