--- read_when: - आप `openclaw.ai/install.sh` को समझना चाहते हैं - आप इंस्टॉलेशन को स्वचालित करना चाहते हैं (CI / हेडलेस) - आप GitHub चेकआउट से इंस्टॉल करना चाहते हैं summary: इंस्टॉलर स्क्रिप्ट कैसे काम करती हैं (install.sh, install-cli.sh, install.ps1), फ़्लैग और ऑटोमेशन title: इंस्टॉलर की आंतरिक कार्यप्रणाली x-i18n: generated_at: "2026-07-27T18:02:31Z" model: gpt-5.6 postprocess_version: locale-links-v1 prompt_version: 32 provider: openai source_hash: 7878f10903893b4e1902bbc79991f43edaa436bd802d5fecde41421e3e05bc2b source_path: install/installer.md workflow: 16 --- OpenClaw तीन इंस्टॉलर स्क्रिप्ट के साथ आता है, जिन्हें `openclaw.ai` से प्रस्तुत किया जाता है। | स्क्रिप्ट | प्लेटफ़ॉर्म | यह क्या करती है | | ---------------------------------- | -------------------- | ---------------------------------------------------------------------------------------------- | | [`install.sh`](#installsh) | macOS / Linux / WSL | आवश्यकता होने पर Node इंस्टॉल करती है, npm (डिफ़ॉल्ट) या git के माध्यम से OpenClaw इंस्टॉल करती है और ऑनबोर्डिंग चला सकती है। | | [`install-cli.sh`](#install-clish) | macOS / Linux / WSL | npm या git के माध्यम से स्थानीय प्रीफ़िक्स (`~/.openclaw`) में Node + OpenClaw इंस्टॉल करती है। root की आवश्यकता नहीं है। | | [`install.ps1`](#installps1) | Windows (PowerShell) | आवश्यकता होने पर Node इंस्टॉल करती है, npm (डिफ़ॉल्ट) या git के माध्यम से OpenClaw इंस्टॉल करती है और ऑनबोर्डिंग चला सकती है। | तीनों Node **22.22.3+, 24.15+, या 25.9+** का समर्थन करती हैं; नए इंस्टॉल के लिए Node 24 डिफ़ॉल्ट लक्ष्य है। ## त्वरित कमांड ```bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash ``` ```bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --help ``` ```bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash ``` ```bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --help ``` ```powershell iwr -useb https://openclaw.ai/install.ps1 | iex ``` ```powershell & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -Tag beta -NoOnboard -DryRun ``` यदि इंस्टॉल सफल हो जाता है, लेकिन नए टर्मिनल में `openclaw` नहीं मिलता, तो [Node.js समस्या निवारण](/hi/install/node#troubleshooting) देखें। --- ## install.sh macOS/Linux/WSL पर अधिकांश इंटरैक्टिव इंस्टॉल के लिए अनुशंसित। ### प्रवाह (install.sh) macOS और Linux (WSL सहित) का समर्थन करती है। 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 मौजूद न होने पर, पहचाने गए पैकेज मैनेजर का उपयोग करके इसे इंस्टॉल करती है, जिसमें macOS पर Homebrew और Alpine पर apk शामिल हैं। - `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) ```bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash ``` ```bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --no-onboard ``` ```bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git ``` ```bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git --version main ``` ```bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --dry-run ``` ```bash 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 ` | npm संस्करण, dist-tag या पैकेज विनिर्देश (डिफ़ॉल्ट: `latest`) | | `--beta` | उपलब्ध होने पर beta dist-tag का उपयोग करें, अन्यथा `latest` पर वापस जाएँ | | `--git-dir \| --dir ` | चेकआउट डायरेक्टरी (डिफ़ॉल्ट: `~/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\|\|` | npm संस्करण, dist-tag या पैकेज विनिर्देश | | `OPENCLAW_BETA=0\|1` | उपलब्ध होने पर beta का उपयोग करें | | `OPENCLAW_HOME=` | OpenClaw स्थिति और डिफ़ॉल्ट git/ऑनबोर्डिंग पथों की आधार डायरेक्टरी | | `OPENCLAW_GIT_DIR=` | चेकआउट डायरेक्टरी | | `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 उन परिवेशों के लिए डिज़ाइन किया गया है, जहाँ आप सब कुछ स्थानीय प्रीफ़िक्स (डिफ़ॉल्ट `~/.openclaw`) के अंतर्गत रखना चाहते हैं और सिस्टम Node डिपेंडेंसी नहीं चाहते। डिफ़ॉल्ट रूप से npm इंस्टॉल का समर्थन करता है, साथ ही उसी प्रीफ़िक्स प्रवाह के अंतर्गत git-चेकआउट इंस्टॉल का भी। ### प्रवाह (install-cli.sh) पिन किया गया समर्थित Node LTS टारबॉल (संस्करण स्क्रिप्ट में अंतर्निहित है और स्वतंत्र रूप से अपडेट किया जाता है, डिफ़ॉल्ट `24.15.0`) `/tools/node-v` में डाउनलोड करता है और 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 मौजूद न होने पर, Linux पर apt/dnf/yum/apk या macOS पर Homebrew के माध्यम से इसे इंस्टॉल करने का प्रयास करता है। - `npm` विधि (डिफ़ॉल्ट): npm के साथ प्रीफ़िक्स के अंतर्गत इंस्टॉल करती है, फिर `/bin/openclaw` में रैपर लिखती है - `git` विधि: चेकआउट (डिफ़ॉल्ट `~/openclaw`) को क्लोन/अपडेट करती है और फिर भी रैपर को `/bin/openclaw` में लिखती है यदि उसी प्रीफ़िक्स से कोई Gateway सेवा पहले से लोड है, तो स्क्रिप्ट `openclaw gateway install --force` चलाती है, जो प्रतिस्थापन सेवा को सक्रिय करता है, और फिर यथासंभव Gateway की स्थिति की जाँच करती है। ### उदाहरण (install-cli.sh) ```bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash ``` ```bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --prefix /opt/openclaw --version latest ``` ```bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --install-method git --git-dir ~/openclaw ``` ```bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --json --prefix /opt/openclaw ``` ```bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --onboard ``` | फ़्लैग | विवरण | | --------------------------------------- | ------------------------------------------------------------------------------- | | `--prefix ` | इंस्टॉल प्रीफ़िक्स (डिफ़ॉल्ट: `~/.openclaw`) | | `--install-method \| --method npm\|git` | इंस्टॉल विधि चुनें (डिफ़ॉल्ट: `npm`) | | `--npm` | npm विधि का शॉर्टकट | | `--git \| --github` | git विधि का शॉर्टकट | | `--git-dir \| --dir ` | Git चेकआउट डायरेक्टरी (डिफ़ॉल्ट: `~/openclaw`) | | `--version ` | OpenClaw संस्करण या dist-tag (डिफ़ॉल्ट: `latest`) | | `--node-version ` | 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=` | इंस्टॉल प्रीफ़िक्स | | `OPENCLAW_INSTALL_METHOD=git\|npm` | इंस्टॉल विधि | | `OPENCLAW_VERSION=` | OpenClaw संस्करण या dist-tag | | `OPENCLAW_NODE_VERSION=` | Node संस्करण | | `OPENCLAW_HOME=` | OpenClaw स्थिति और डिफ़ॉल्ट git/ऑनबोर्डिंग पथों की आधार डायरेक्टरी | | `OPENCLAW_GIT_DIR=` | git इंस्टॉल के लिए Git चेकआउट डायरेक्टरी | | `OPENCLAW_GIT_UPDATE=0\|1` | मौजूदा चेकआउट के लिए git अपडेट टॉगल करें | | `OPENCLAW_NO_ONBOARD=1` | ऑनबोर्डिंग छोड़ें | | `OPENCLAW_NPM_LOGLEVEL=error\|warn\|notice` | npm लॉग स्तर (डिफ़ॉल्ट: `error`) | `openclaw@main` और अन्य GitHub स्रोत विनिर्देश npm इंस्टॉल के लिए मान्य `--version` लक्ष्य नहीं हैं। इसके बजाय `--install-method git --version main` का उपयोग करें। --- ## install.ps1 ### प्रवाह (install.ps1) PowerShell 5+ आवश्यक है। उपलब्ध न होने पर, पहले 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 समर्थित नहीं है। - `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) ```powershell iwr -useb https://openclaw.ai/install.ps1 | iex ``` ```powershell & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -InstallMethod git ``` ```powershell & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -InstallMethod git -Tag main ``` ```powershell & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -InstallMethod git -GitDir "C:\openclaw" ``` ```powershell & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -DryRun ``` | फ़्लैग | विवरण | | --------------------------- | ---------------------------------------------------------- | | `-InstallMethod npm\|git` | इंस्टॉल विधि (डिफ़ॉल्ट: `npm`) | | `-Tag ` | npm dist-tag, संस्करण या पैकेज विनिर्देश (डिफ़ॉल्ट: `latest`) | | `-GitDir ` | चेकआउट डायरेक्टरी (डिफ़ॉल्ट: `%USERPROFILE%\openclaw`) | | `-NoOnboard` | ऑनबोर्डिंग छोड़ें | | `-NoGitUpdate` | `git pull` छोड़ें | | `-DryRun` | केवल कार्रवाइयाँ प्रिंट करें | | वेरिएबल | विवरण | | ---------------------------------- | ------------------ | | `OPENCLAW_INSTALL_METHOD=git\|npm` | इंस्टॉल विधि | | `OPENCLAW_GIT_DIR=` | चेकआउट डायरेक्टरी | | `OPENCLAW_NO_ONBOARD=1` | ऑनबोर्डिंग छोड़ें | | `OPENCLAW_GIT_UPDATE=0` | git pull अक्षम करें | | `OPENCLAW_DRY_RUN=1` | ड्राई रन मोड | यदि `-InstallMethod git` का उपयोग किया जाता है और Git उपलब्ध नहीं है, तो स्क्रिप्ट Git for Windows लिंक दिखाने से पहले उपयोगकर्ता-स्थानीय MinGit बूटस्ट्रैप करने का प्रयास करती है। --- ## CI और ऑटोमेशन अनुमानित ढंग से चलाने के लिए गैर-इंटरैक्टिव फ़्लैग/एनवायरनमेंट वेरिएबल का उपयोग करें। ```bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --no-prompt --no-onboard ``` ```bash OPENCLAW_INSTALL_METHOD=git OPENCLAW_NO_PROMPT=1 \ curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash ``` ```bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --json --prefix /opt/openclaw ``` ```powershell & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard ``` --- ## समस्या निवारण `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 ट्रेसिंग का उपयोग करें: ```powershell Set-PSDebug -Trace 1 & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard Set-PSDebug -Trace 0 ``` आमतौर पर यह PATH की समस्या होती है। [Node.js समस्या निवारण](/hi/install/node#troubleshooting) देखें। ## संबंधित - [इंस्टॉल का अवलोकन](/hi/install) - [अपडेट करना](/hi/install/updating) - [अनइंस्टॉल](/hi/install/uninstall)