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

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

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 -- --help

install.ps1

powershell
iwr -useb https://openclaw.ai/install.ps1 | iex
powershell
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -Tag beta -NoOnboard -DryRun

install.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)

    डिफ़ॉल्ट

    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

    Git इंस्टॉल

    bash
    curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git

    GitHub main चेकआउट

    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 <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)

    डिफ़ॉल्ट

    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

    Git इंस्टॉल

    bash
    curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --install-method git --git-dir ~/openclaw

    ऑटोमेशन JSON आउटपुट

    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 <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)

    डिफ़ॉल्ट

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

    Git इंस्टॉल

    powershell
    & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -InstallMethod git

    GitHub main चेकआउट

    powershell
    & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -InstallMethod git -Tag main

    कस्टम git डायरेक्टरी

    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 <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)

    bash
    curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --no-prompt --no-onboard

    install.sh (गैर-इंटरैक्टिव git)

    bash
    OPENCLAW_INSTALL_METHOD=git OPENCLAW_NO_PROMPT=1 \  curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

    install-cli.sh (JSON)

    bash
    curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --json --prefix /opt/openclaw

    install.ps1 (ऑनबोर्डिंग छोड़ें)

    powershell
    & ([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 ट्रेसिंग का उपयोग करें:

    powershell
    Set-PSDebug -Trace 1& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboardSet-PSDebug -Trace 0
    इंस्टॉल के बाद openclaw नहीं मिला

    आमतौर पर यह PATH की समस्या होती है। Node.js समस्या निवारण देखें।

    संबंधित

    Was this useful?
    On this page

    On this page