Skip to content

वैकल्पिक इंस्टॉल तरीके: डेस्कटॉप ऐप, Docker और npm ​

पिछले पाठ में आधिकारिक इंस्टॉलर से मुख्य पथ पूरा किया था; लेकिन OpenClaw डाउनलोड और इंस्टॉल का एक ही रास्ता नहीं है—कंपनी के कंप्यूटर पर स्क्रिप्ट चलाने की अनुमति नहीं, ट्रे में रहने वाला डेस्कटॉप ऐप चाहिए, सर्वर पर कंटेनरीकरण चाहिए, या आप खुद Node मैनेज करते हैं और इंस्टॉलर से करवाना नहीं चाहते। यह पाठ डेस्कटॉप ऐप, Docker, npm / pnpm / Bun डायरेक्ट इंस्टॉल, सोर्स से कंपाइल—चार वैकल्पिक रूट एक साथ समझाता है, 8 मिनट बाद अपने परिदृश्य के हिसाब से एक चुनकर चलें। यह पेज v2026.10.9 पर आधारित है।

सीखने के बाद आप क्या कर सकेंगे ​

  • Windows Hub (x64 / ARM64 साइन्ड इंस्टॉलर) या macOS मेनू बार ऐप डाउनलोड कर इंस्टॉल करें—बिना टर्मिनल छुए OpenClaw डाउनलोड का तरीका
  • Docker से कंटेनरीकृत Gateway चालू करें: setup स्क्रिप्ट onboarding अपने आप पूरा करती है, ब्राउज़र में 18789 पोर्ट का Control UI खोलें
  • npm / pnpm / Bun तीन पैकेज मैनेजर से OpenClaw डायरेक्ट इंस्टॉल करें, और हर एक का ज़रूरी पैरामीटर याद रखें
  • सोर्स से कंपाइल कर इंस्टॉल करें, openclaw CLI को अपने checkout से लिंक करें
  • एक तुलना तालिका से अपने परिदृश्य के हिसाब से अपना रूट चुनें (डेस्कटॉप संस्करण / Docker / डायरेक्ट इंस्टॉल / सोर्स)

आपकी अभी की दिक्कत ​

  • कंपनी के कंप्यूटर पर curl | bash जैसी स्क्रिप्ट चलाने की अनुमति नहीं है, कोई ठीक-ठाक इंस्टॉलर चाहिए जिसे डबल-क्लिक से इंस्टॉल कर सकें
  • मैं Windows / macOS डेस्कटॉप यूज़र हूँ, बस एक ऐप चाहिए जो ट्रे या मेनू बार में रहे, टर्मिनल नहीं खोलना
  • सर्वर पर कंटेनर में 7×24 चलाना है, या मैं खुद Node मैनेज करता हूँ—इंस्टॉलर वाली वह 'Node अपने आप लगा देने' वाली बात बल्कि बाधा है

यह तरीका कब अपनाएँ ​

जब आपको चाहिए:

  • OpenClaw डाउनलोड और इंस्टॉल का एक ग्राफ़िकल इंटरफ़ेस तरीका (डेस्कटॉप ऐप)
  • Gateway का एक आइसोलेटेड, डिस्पोज़ेबल वातावरण जो आपकी मशीन को प्रदूषित न करे (Docker)
  • अपने पैकेज मैनेजर से इंस्टॉल (npm / pnpm / Bun), या सीधे नवीनतम main ब्रांच चलाना (सोर्स से कंपाइल)

और आप नहीं चाहते:

  • दोबारा पिछला पाठ वाला curl | bash आधिकारिक इंस्टॉलर का मुख्य पथ चलाएँ
  • सिस्टम में Node रनटाइम का एक सेट इंस्टॉल करना (डेस्कटॉप ऐप और Docker दोनों में रनटाइम पहले से शामिल है)

🎒 शुरू करने से पहले की तैयारी ​

  • इंस्टॉल: 5 मिनट में चालू OpenClaw—यह पेज उसका वैकल्पिक रूट पूरक है; मुख्य पथ चल रहा हो तो बदलने की ज़रूरत नहीं
  • जिस रूट पर जाना है उसके हिसाब से वातावरण तैयार रखें (नीचे तालिका देखें)
  • एक 'मॉडल पास' तैयार रखें: डेस्कटॉप ऐप की पहली बार चलने पर, Docker setup पर, openclaw onboard पर—तीनों आपको मॉडल क्रेडेंशियल कॉन्फ़िगर करने में मार्गदर्शन देंगे (Claude Code / Codex CLI लॉगिन या API Key, जानकारी के लिए देखें मॉडल कनेक्शन की समीक्षा)

हर रूट की वातावरण ज़रूरतें ​

रूटआपके पास पहले से होना चाहिए
डेस्कटॉप ऐपबस इंस्टॉलर डाउनलोड हो जाए तो काफ़ी है: Windows 10 20H2+ / Windows 11 (Hub), macOS 26.2 (Tahoe)+ (मेनू बार ऐप)
DockerDocker Desktop या Docker Engine + Docker Compose v2; लोकल इमेज बिल्ड के लिए कम से कम 6 GB मेमोरी
npm / pnpm / Bun डायरेक्ट इंस्टॉलNode 24.16.0+ (24.x) या 26.1.0+ (सुझाया गया 24.22.1+ / 26.12.1+); Bun रूट के लिए Bun 1.4.4+
सोर्स से कंपाइलNode + Corepack (या खुद pnpm 12 इंस्टॉल) + git

⚠️ चीन का नेटवर्क

आधिकारिक दस्तावेज़ कोई घरेलू मिरर या डाउनलोड एक्सेलेरेशन समाधान प्रदान नहीं करता, इसलिए यह लेख मिरर पते का अनुमान नहीं लगाता। GitHub Releases से डेस्कटॉप इंस्टॉलर डाउनलोड करते समय या GHCR से इमेज खींचते समय यदि टाइमआउट हो, तो पहले नेटवर्क वातावरण जांचें और फिर पुनः प्रयास करें; लगातार विफलता हो तो इंस्टॉल न हो तो क्या करें में जाकर तुलना करके समस्या पहचानें।

मूल विचार ​

सभी इंस्टॉलेशन विधियाँ एक ही चीज़ इंस्टॉल करती हैं: एक Gateway प्रक्रिया + openclaw CLI + एक कॉन्फ़िगरेशन। चार वैकल्पिक रूटों का अंतर केवल इस बात में है कि「Gateway कहाँ चलता है, रनटाइम कौन प्रबंधित करता है」:

रूटGateway कहाँ चलता हैरनटाइमकिसके लिए उपयुक्त
आधिकारिक इंस्टॉलर (पिछले पाठ का मुख्य पथ)स्थानीय मशीन की बैकग्राउंड सेवाNode न होने पर इंस्टॉलर स्वयं जोड़ देता हैसबसे तेज़ चालू करना चाहने वाले
डेस्कटॉप ऐपApp पहली बार चलने पर स्थानीय Gateway कॉन्फ़िगर करता है, या किसी मौजूदा रिमोट Gateway से जुड़ता हैApp रनटाइम स्वयं प्रबंधित करता है, सिस्टम Node पर निर्भर नहींटर्मिनल न छूने वाले डेस्कटॉप उपयोगकर्ता
Docker / Podmanकंटेनर के अंदरइमेज में पहले से शामिलआइसोलेटेड वातावरण, सर्वर, स्थानीय इंस्टॉलेशन नहीं
npm / pnpm / Bun सीधा इंस्टॉलस्थानीय मशीन (--install-daemon सेवा के रूप में इंस्टॉल)आप स्वयं प्रबंधित करते हैंडेवलपर, CI में थोक इंस्टॉलेशन
सोर्स से कंपाइलस्थानीय मशीनआप स्वयं प्रबंधित करते हैं + pnpmयोगदानकर्ता, नवीनतम main चलाने वाले

चारों रूट एक-दूसरे से स्वतंत्र हैं, अपने परिदृश्य के अनुसार कोई एक चुनकर आगे बढ़ें; नीचे चरणों के क्रमांक लगातार हैं, ताकि क्रॉस-रेफ़रेंस आसान रहे।

मेरे साथ करें ​

चरण 1: OpenClaw डेस्कटॉप संस्करण डाउनलोड करें——Windows Hub और macOS मेन्यू बार ऐप ​

क्यों: डेस्कटॉप ऐप उन उपयोगकर्ताओं के लिए आधिकारिक OpenClaw डाउनलोड विधि है जो「टर्मिनल नहीं छूते」——इंस्टॉलर डाउनलोड करें, ग्राफ़िकल इंटरफ़ेस से सेटअप। Windows Hub और macOS मेन्यू बार App, दोनों नेटिव डेस्कटॉप ऐप, पहली बार सेटअप के समय स्थानीय Gateway कॉन्फ़िगर कर सकते हैं, या सीधे किसी मौजूदा रिमोट Gateway से जुड़ सकते हैं।

Windows उपयोगकर्ता: Windows Hub (आधिकारिक अनुशंसा) ​

Windows पर आधिकारिक रूप से सबसे अधिक अनुशंसित Windows Hub है——नेटिव WinUI कंपैनियन ऐप, जो Windows 10 20H2+ और Windows 11 को कवर करता है, बिना एडमिनिस्ट्रेटर अनुमति के इंस्टॉल, x64 / ARM64 दोनों इंस्टॉलर साइन किए गए हैं:

डाउनलोड और इंस्टॉल करने के बाद, Start मेन्यू या सिस्टम ट्रे से OpenClaw Companion लॉन्च करें (इंस्टॉलर Gateway Setup, Chat, Settings, अपडेट जांच और अनइंस्टॉल के लिए भी शॉर्टकट बनाता है)। पहली बार लॉन्च पर यदि कोई उपलब्ध Gateway नहीं मिलता, तो यह स्वयं सेटअप में चला जाता है: सबसे तेज़ रास्ता Set up locally है——यह एक App-प्रबंधित OpenClawGateway WSL डिस्ट्रिब्यूशन बनाता है, उसमें Gateway इंस्टॉल करके पेयरिंग पूरी करता है, और आपके मौजूदा Ubuntu डिस्ट्रिब्यूशन को नहीं छेड़ता। पहले से Gateway हो तो Advanced setup चुनें, जिससे स्थानीय / WSL / रिमोट (URL + token) या SSH टनल के Gateway से जुड़ सकते हैं।

आपको यह दिखना चाहिए: सेटअप पूरा होने पर ट्रे आइकन हरा हो जाता है; ट्रे से Command Center खोलें, तो कनेक्शन, पेयरिंग, नोड स्थिति और चैनल स्वास्थ्य सब सामान्य दिखेगा।

💡 डायरेक्ट लिंक 404 हो गया?

Windows Hub की रिलीज़ गति OpenClaw CLI और Gateway से स्वतंत्र है। ऊपर के डायरेक्ट लिंक खराब होने पर Windows Hub releases पेज पर जाकर नवीनतम स्थिर संस्करण खोलें। विवरण के लिए आधिकारिक Windows प्लेटफ़ॉर्म दस्तावेज़ देखें।

Windows विकल्प: क्रॉस-प्लेटफ़ॉर्म Tauri डेस्कटॉप ऐप——इंस्टॉलर OpenClaw-<version>-windows-x86_64.exe OpenClaw औपचारिक रिलीज़ के साथ आता है (GitHub Releases), इसमें बिल्ट-इन Bun से स्थानीय Windows Gateway कॉन्फ़िगर किया जा सकता है, या रिमोट Gateway से जुड़ा जा सकता है।

macOS उपयोगकर्ता: मेन्यू बार ऐप ​

macOS डेस्कटॉप संस्करण मेन्यू बार कंपैनियन ऐप है: OpenClaw GitHub Releases से OpenClaw-<version>.dmg डाउनलोड करें (प्राथमिक विकल्प) या .zip, फिर इंस्टॉल करके OpenClaw.app लॉन्च करें।

सिस्टम आवश्यकताएँ: macOS 26.2 (Tahoe) या उससे नया।

आपको यह दिखना चाहिए: नए इंस्टॉल पर पहली बार लॉन्च होने पर प्रगति विंडो दिखती है——App अपना साथ लाया रनटाइम तैयार करता है,「This Mac」पर Gateway चालू करता है, dashboard का onboarding डायलॉग खोलता है; तैयार होने पर विंडो स्वयं बंद हो जाती है। इसके बाद मेन्यू बार में OpenClaw आइकन स्थायी रहता है, Quick Chat डिफ़ॉल्ट रूप से ⌥Space से खुलता है।

💡 नवीनतम Release में macOS पैकेज नहीं है?

कुछ Release में केवल CLI या Windows एसेट होते हैं। आधिकारिक निर्देश: macOS पैकेज वाला नवीनतम संस्करण उपयोग करें——आधिकारिक macOS ऐप पेज पर वर्तमान में 2026.10.3 के तीन DMG पिन किए गए हैं (Apple Silicon / Intel / Universal), विवरण के लिए आधिकारिक macOS app दस्तावेज़ देखें।

  • डेस्कटॉप App चालू हो गया: Windows ट्रे आइकन हरा हुआ, या macOS मेन्यू बार में OpenClaw आइकन दिखा

चरण 2: Docker से कंटेनरीकृत Gateway चलाएँ ​

क्यों: आधिकारिक रूप से OpenClaw Docker रूट की स्थिति「वैकल्पिक」है——आइसोलेटेड, त्यागने योग्य Gateway वातावरण चाहने वालों के लिए, या ऐसे होस्ट के लिए जहाँ स्थानीय इंस्टॉलेशन नहीं होता। अपनी डेवलपमेंट मशीन पर रोज़मर्रा के उपयोग के लिए, आधिकारिक सलाह सामान्य इंस्टॉलेशन प्रक्रिया (पिछला पाठ) अपनाने की है।

पहले आवश्यक शर्तें तैयार करें:

  • Docker Desktop (या Docker Engine) + Docker Compose v2
  • सोर्स से इमेज बनाने के लिए स्थानीय स्तर पर कम से कम 6 GB मेमोरी——आधिकारिक प्रीबिल्ट इमेज से यह शर्त टाली जा सकती है
  • इमेज और लॉग के लिए पर्याप्त डिस्क स्पेस

फिर चार कमांड (setup स्क्रिप्ट रिपॉज़िटरी की रूट डायरेक्टरी से चलानी है, पहले क्लोन करें):

bash
git clone https://github.com/openclaw/openclaw.git
cd openclaw
export OPENCLAW_IMAGE="ghcr.io/openclaw/openclaw:latest"
./scripts/docker/setup.sh

OPENCLAW_IMAGE आधिकारिक प्रीबिल्ट इमेज की ओर इशारा करता है (GitHub Container Registry मुख्य रिलीज़ चैनल है, पैकेज पेज); जब यह सेट नहीं होता, स्क्रिप्ट openclaw:local को लोकल बिल्ड करती है। वही Release Docker Hub पर openclaw/openclaw इमेज भी प्रकाशित करता है। आधिकारिक रूप से स्पष्ट चेतावनी दी गई है: केवल इन्हीं दो आधिकारिक पतों का उपयोग करें, थर्ड-पार्टी इमेज से बचें—— उनकी रिलीज़ गति और रिटेंशन नीतियाँ सिंक में नहीं हैं। वर्ज़न पिन करने के लिए कोई विशिष्ट वर्ज़न टैग उपयोग करें (जैसे 2026.9.3); वेरिएंट में slim, -browser (बिल्ट-इन Chromium) आदि शामिल हैं, और डिफ़ॉल्ट इमेज में codex और diagnostics-otel प्लगइन्स बंडल होते हैं।

आपको यह दिखना चाहिए: setup ऑनबोर्डिंग अपने आप पूरी करता है—— provider API Key इनपुट के लिए प्रॉम्प्ट करना → Gateway token जनरेट करके .env में लिखना → Docker Compose से Gateway शुरू करना।

Control UI खोलें: ब्राउज़र में http://127.0.0.1:18789/ पर जाएँ, और .env में मौजूद token को Settings में पेस्ट करें। पता भूल गए हों तो एक बार फिर प्राप्त करें:

bash
docker compose run --rm openclaw-cli dashboard --no-open

कंटेनर हेल्थ चेक (ऑथेंटिकेशन-मुक्त, इमेज में बिल्ट-इन HEALTHCHECK इसी को हिट करता है):

bash
curl -fsS http://127.0.0.1:18789/healthz

आपको यह दिखना चाहिए: healthz सामान्य रूप से लौटता है; /startupz (स्टार्टअप चेक) और /readyz (डीप रेडीनेस) भी उसी पोर्ट पर हैं।

  • curl http://127.0.0.1:18789/healthz सामान्य रूप से लौटता है, Control UI में .env के token से लॉगिन हो जाता है

💡 सर्वर पर 7×24 चलाना चाहते हैं?

यह चरण केवल कंटेनराइज़्ड Gateway चलाने में आपकी मदद करता है। VPS चयन, compose संचालन, पब्लिक एक्सपोज़र के सुरक्षा नियम (Docker DOCKER-USER फ़ायरवॉल चेन सहित) के लिए सर्वर डिप्लॉयमेंट: Docker/VPS पर 7×24 चलाना और सुरक्षा सख्त करना (भाग 1) देखें।

चरण 3: npm / pnpm / Bun से सीधे इंस्टॉल ​

क्यों: जो डेवलपर्स खुद Node मैनेज करते हैं उन्हें इंस्टॉलर की ज़रूरत नहीं——OpenClaw npm इंस्टॉल (pnpm / Bun भी वैसा ही) एक कमांड में पूरा हो जाता है, फिर onboarding चलाकर Gateway को बैकग्राउंड सर्विस के रूप में इंस्टॉल करें। यही CI / बैच मशीनों पर भी स्टैंडर्ड रास्ता है।

पूर्व-आवश्यकता: Node 24.16.0+ (24.x) या 26.1.0+ (आधिकारिक तौर पर 24.22.1+ / 26.12.1+ की दृढ़ सिफ़ारिश)। पहले node --version से जाँचें।

तरीका A: npm (npm 12 या 11.16+) ​

bash
npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon

npm 11.15 और उससे पहले: --allow-scripts=openclaw हटा दें (उस वर्ज़न में न यह नीति है न यह विकल्प)।

--allow-scripts क्यों: npm 12 डिफ़ॉल्ट रूप से अस्वीकृत पैकेज लाइफसाइकल स्क्रिप्ट को रोकता है; इसे न जोड़ें तो OpenClaw के preinstall / postinstall पर blocked because they are not covered by allowScripts की रिपोर्ट मिलेगी। npm 11.16 यह विकल्प स्वीकार करता है लेकिन केवल चेतावनी देकर वैसे ही निष्पादित करता है।

तरीका B: pnpm ​

bash
pnpm add -g --allow-build=openclaw openclaw@latest
openclaw onboard --install-daemon

pnpm बिल्ड स्क्रिप्ट वाले पैकेजों के लिए स्पष्ट स्वीकृति मांगता है, और approve-builds -g ग्लोबल इंस्टॉल को सपोर्ट नहीं करता——इसलिए --allow-build=openclaw को सीधे इंस्टॉल कमांड पर लिखें।

तरीका C: Bun ​

bash
bun add -g --trust openclaw@latest
bun run --bun openclaw onboard --install-daemon --daemon-runtime bun

--trust OpenClaw के पैकेज लाइफसाइकल स्क्रिप्ट को अनुमति देता है; bun run --bun Bun रनटाइम को बाध्य करता है, --daemon-runtime bun मैनेज्ड Gateway को Bun के अंतर्गत इंस्टॉल करता है। Bun 1.4.4 और उसके बाद ही OpenClaw की CLI, लोकल agent और Gateway चल सकते हैं; Node अभी भी मुख्य रनटाइम है——नंगे openclaw एग्ज़ीक्यूटेबल में Node shebang बना रहता है।

आपको यह दिखना चाहिए: तीनों तरीकों से इंस्टॉल का परिणाम एक जैसा है——openclaw कमांड उपलब्ध, onboarding हमेशा की तरह चलता है, Gateway बैकग्राउंड सर्विस के रूप में इंस्टॉल होता है।

  • टर्मिनल में openclaw --version वर्ज़न नंबर प्रिंट कर सकता है

💡 मैनुअल npm इंस्टॉल और "ताज़गी" नीति

आधिकारिक होस्टेड इंस्टॉलर OpenClaw पैकेज के लिए min-release-age जैसे npm ताज़गी फ़िल्टर हटा देता है; जब आप मैन्युअल रूप से npm install -g करते हैं, तो आपकी अपनी npm नीति हमेशा की तरह लागू रहती है। नीति इंस्टॉल रोक दे तो पहले npm कॉन्फ़िगरेशन जाँचें।

चरण 4: OpenClaw सोर्स से कंपाइल कर इंस्टॉल ​

क्यों: योगदानकर्ता, नवीनतम main चलाने वाले, या सोर्स कोड बदलने वाले इस रास्ते पर चलते हैं——GitHub से सोर्स क्लोन करें, pnpm से बिल्ड करें, CLI को इसी checkout से लिंक करें।

bash
git clone https://github.com/openclaw/openclaw.git
cd openclaw
corepack enable
pnpm install && pnpm build && pnpm ui:build
pnpm add --global "openclaw@link:$PWD"
openclaw onboard --install-daemon

तीन बारीकियाँ:

  • pnpm add --global "openclaw@link:$PWD" CLI को मौजूदा checkout से लिंक करता है, पैकेज फ़ाइलें नहीं बदलता; जब pnpm बताए कि ग्लोबल bin डायरेक्टरी PATH में नहीं है, तो pnpm setup चलाएँ, टर्मिनल दोबारा खोलकर पुनः प्रयास करें
  • Corepack package.json के अनुसार सटीक pnpm वर्ज़न चुनता है (वर्तमान में pnpm 12)
  • केवल Gateway चलाने वाले सर्वर checkout में pnpm build:runtime काम करता है (TypeScript डिक्लेरेशन नहीं बनाता); ग्लोबल इंस्टॉल नहीं करना चाहते तो रिपॉज़िटरी में ही सीधे pnpm openclaw ...

आपको यह दिखना चाहिए: बिल्ड बिना किसी त्रुटि के पूरा होता है, openclaw आपके लोकल सोर्स की ओर इशारा करता है।

  • pnpm build और pnpm ui:build दोनों बिना त्रुटि के समाप्त होते हैं

चरण 5: इंस्टॉलेशन सत्यापित करें——तीन कमांड से पुष्टि कि Gateway जीवित है ​

क्यों: कोई भी रास्ता चुनें, इंस्टॉल के बाद उसी कमांड सेट से पुष्टि करें——CLI मौजूद है, कॉन्फ़िगरेशन में कोई समस्या नहीं, Gateway चल रहा है।

bash
openclaw --version      # CLI 可用
openclaw doctor         # 检查配置问题
openclaw gateway status # Gateway 正在运行

आपको यह दिखना चाहिए: --version वर्ज़न नंबर प्रिंट करता है (इस ट्यूटोरियल का बेसलाइन v2026.10.9); doctor हेल्थ-चेक परिणाम देता है; gateway status दिखाता है कि Gateway चल रहा है और 18789 पर सुन रहा है।

Docker रास्ते का संगत ऑपरेशन (Gateway कंटेनर में है, होस्ट मशीन पर नहीं):

bash
docker compose run --rm openclaw-cli dashboard --no-open   # 重新拿到 Control UI 地址
curl -fsS http://127.0.0.1:18789/healthz                   # 容器健康检查
  • तीनों सत्यापन कमांड पास (Docker रास्ते में healthz + dashboard)

चेकपॉइंट ✅ ​

  • डेस्कटॉप रास्ता: Windows Hub ट्रे आइकन हरा हो जाता है, या macOS मेन्यू बार App ने dashboard onboarding खोला
  • Docker रास्ता: http://127.0.0.1:18789/healthz सामान्य रूप से लौटता है, Control UI में .env के token से लॉगिन हो गया
  • npm / pnpm / Bun रास्ता: openclaw --version का आउटपुट है, onboarding पूरा हुआ
  • सोर्स रास्ता: pnpm build && pnpm ui:build बिना त्रुटि, openclaw लोकल checkout से लिंक है
  • मैं "कोर आइडिया" की तालिका देखकर अपने परिदृश्य के लिए सही रास्ता बता सकता/सकती हूँ

सावधानी अलर्ट ​

❌ npm 12 सीधे इंस्टॉल पर blocked because they are not covered by allowScripts त्रुटि ​

कारण: npm 12 डिफ़ॉल्ट रूप से अस्वीकृत पैकेज लाइफसाइकल स्क्रिप्ट को रोकता है, OpenClaw के preinstall / postinstall रोक दिए जाते हैं।

bash
# ❌ npm 12 不带参数
npm install -g openclaw@latest
# → blocked because they are not covered by allowScripts

# ✅ 带上允许脚本的参数
npm install -g openclaw@latest --allow-scripts=openclaw

संस्करण अंतर याद रखें: npm 11.16 यह विकल्प स्वीकार करता है लेकिन केवल चेतावनी देता है और वैसे ही निष्पादित करता है; npm 11.15 और उससे पहले के में न यह नीति है न यह विकल्प, इसलिए कमांड में इसे शामिल न करें। इसके अलावा, npm 11.16 द्वारा सुझाया गया npm approve-scripts openclaw वैश्विक (global) इंस्टॉल पर काम नहीं करता—यह ENOMATCH No installed packages match: openclaw त्रुटि देता है।

❌ macOS सिस्टम पर्याप्त नया नहीं है, मेन्यू बार ऐप इंस्टॉल नहीं होता ​

कारण: OpenClaw.app को macOS 26.2 (Tahoe) या उससे नया चाहिए, यह कठोर सीमा CLI के चलने से कम नहीं होती—आधिकारिक Node 24 / 26 के macOS बाइनरी macOS 13.5+ को समर्थन देते हैं, लेकिन "CLI चल जाता है" का मतलब "नेटिव ऐप संगत है" नहीं है।

सही तरीका: पुराने Mac पर पिछले पाठ का CLI इंस्टॉल मार्ग अपनाएँ (Node के आधिकारिक बाइनरी macOS 13.5+ को समर्थन देते हैं)।

❌ Docker से लोकल इमेज बिल्ड: मेमोरी पर्याप्त नहीं या बिल्ड विफल ​

कारण: सोर्स से Gateway इमेज को लोकल बिल्ड करने के लिए कम से कम 6 GB मेमोरी चाहिए।

सही तरीका: आधिकारिक प्री-बिल्ट इमेज का उपयोग करें—export OPENCLAW_IMAGE="ghcr.io/openclaw/openclaw:latest" सेट करके setup चलाएँ; साथ ही केवल ghcr.io/openclaw/openclaw या Docker Hub का openclaw/openclaw ही उपयोग करें, तृतीय-पक्ष इमेज से बचें।

❌ pnpm से वैश्विक इंस्टॉल के बाद openclaw: command not found ​

कारण: pnpm का वैश्विक bin डायरेक्टरी PATH में नहीं है।

सही तरीका: pnpm setup चलाएँ, टर्मिनल दोबारा खोलकर पुनः प्रयास करें (आधिकारिक सोर्स इंस्टॉल अनुभाग का मूल वाक्य)। npm वैश्विक इंस्टॉल की इसी तरह की समस्या (ज़्यादातर PATH से संबंधित) के लिए इंस्टॉल न हो तो क्या करें देखें।

उन्नत तकनीकें (वैकल्पिक) ​

लोकल प्रीफिक्स इंस्टॉलर: सिस्टम Node को नहीं छूता। यदि आप OpenClaw को Node के साथ ~/.openclaw लोकल प्रीफिक्स के अंतर्गत रखना चाहते हैं, सिस्टम-स्तरीय Node पर निर्भर न होकर:

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

यह डिफ़ॉल्ट रूप से npm से इंस्टॉल करता है, और उसी प्रीफिक्स के अंतर्गत git checkout इंस्टॉल भी समर्थित है; इंस्टॉल के बाद openclaw update --channel dev / --channel stable से पैकेज इंस्टॉल और git इंस्टॉल के बीच स्विच कर सकते हैं।

केवल-Bun इंस्टॉल (आधिकारिक pinned fork)। macOS और glibc Linux (arm64 / x64) पर पूरा इंस्टॉल Node के बिना किया जा सकता है:

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

यह उस Release द्वारा पिन किया गया OpenClaw Bun fork डाउनलोड और सत्यापित करता है; --runtime को छोड़ने पर डिफ़ॉल्ट अभी भी Node ही है। macOS पर यह आवश्यकतानुसार Homebrew SQLite इंस्टॉल करता है (OpenClaw on Bun Apple सिस्टम के SQLite को अस्वीकार करता है)। विवरण के लिए आधिकारिक Bun दस्तावेज़ देखें।

नवीनतम main चलाएँ (मैन्युअल कंपाइल किए बिना)। यदि आप पूर्ण सोर्स कंपाइल नहीं करना चाहते, पर main ब्रांच के साथ चलना चाहते हैं:

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

Podman / Nix / क्लाउड प्लेटफ़ॉर्म। Docker उपयोग नहीं करना चाहते? आधिकारिक रूप से Podman rootless मार्ग भी है (./scripts/podman/setup.sh, होस्ट मशीन का CLI कंट्रोल प्लेन के रूप में); Nix में flake से डिक्लेरेटिव इंस्टॉल; Ansible से बैच डिप्लॉय। क्लाउड प्लेटफ़ॉर्म (Cloudflare, Render, Fly, Railway आदि) और VPS पर 7×24 डिप्लॉय के लिए सर्वर डिप्लॉय देखें।

पाठ का सारांश ​

✅ OpenClaw डाउनलोड के सभी वैकल्पिक मार्ग खोल दिए गए: डेस्कटॉप संस्करण (Windows Hub / macOS मेन्यू बार / Windows वैकल्पिक Tauri), Docker कंटेनरीकरण, npm / pnpm / Bun से सीधा इंस्टॉल, सोर्स से कंपाइल—चारों मार्गों से इंस्टॉल होने वाली चीज़ एक ही Gateway + CLI + कॉन्फ़िगरेशन है, परिदृश्य के अनुसार एक चुनें।

✅ डेस्कटॉप संस्करण चुनना आ गया: Windows पर आधिकारिक सिफ़ारिश Windows Hub है (एडमिन अधिकार अनावश्यक, साइन किया गया इंस्टॉलर, स्व-प्रबंधित WSL Gateway); macOS मेन्यू बार ऐप को macOS 26.2+ चाहिए।

✅ Docker चलाना आ गया: OPENCLAW_IMAGE + ./scripts/docker/setup.sh, onboarding स्वतः पूर्ण होता है, Control UI 18789 पर होता है।

✅ सीधे इंस्टॉल के पैरामीटर जाल याद हैं: npm 12 / 11.16+ के साथ --allow-scripts=openclaw, pnpm के साथ --allow-build=openclaw, Bun के साथ --trust।

मुख्य कमांडों की समीक्षा:

मार्गमुख्य कमांड / फ़ाइलविवरण
Windows HubOpenClawCompanion-Setup-x64.exe / -arm64.exeआधिकारिक रूप से सिफ़ारिश किया गया Windows डेस्कटॉप संस्करण; एडमिन अधिकार अनावश्यक इंस्टॉल
macOS मेन्यू बारOpenClaw-<version>.dmgmacOS 26.2 (Tahoe)+ आवश्यक
Windows वैकल्पिकOpenClaw-<version>-windows-x86_64.exeTauri डेस्कटॉप ऐप, अंतर्निहित Bun संभव
DockerOPENCLAW_IMAGE + ./scripts/docker/setup.shGHCR मुख्य चैनल; Docker Hub इमेज openclaw/openclaw
npmnpm install -g openclaw@latest --allow-scripts=openclawnpm 12 / 11.16+; 11.15 और उससे पहले के में पैरामीटर हटाएँ
pnpmpnpm add -g --allow-build=openclaw openclaw@latestapprove-builds -g वैश्विक इंस्टॉल समर्थित नहीं
Bunbun add -g --trust openclaw@latestBun 1.4.4+; Node अभी भी मुख्य रनटाइम
सोर्सpnpm install && pnpm build && pnpm ui:buildCorepack package.json के अनुसार pnpm संस्करण चुनता है
सामान्य सत्यापनopenclaw --version / openclaw doctor / openclaw gateway statusकिसी भी मार्ग से इंस्टॉल के बाद एक बार चलाएँ

कमांड क्विक-रेफ़रेंस की पूरी सूची के लिए CLI कमांड और कॉन्फ़िगरेशन क्विक-रेफ़रेंस देखें।

अगले पाठ की झलक ​

चार वैकल्पिक मार्गों में से किसी एक को सफलतापूर्वक चलाने के बाद, बैकअप पाठ का फ़िनाले: इंस्टॉल या चालू न हो तो क्या करें: इंस्टॉल और स्टार्टअप समस्या-निवारण।

आप सीखेंगे:

  • Node संस्करण मानक पर न होना, openclaw command not found जैसी इंस्टॉल-समय त्रुटियों की जाँच के चरण
  • Gateway चालू न होने पर निदान की सोच
  • अपडेट विफल होने पर क्या करें
gaodong.aiAboutPrivacyContact

Independent tutorials, not affiliated with any product mentioned. Product names and trademarks belong to their owners. Check official pages for prices and policies.