انسٹالر کے اندرونی پہلو¶

OpenClaw تین انسٹالر اسکرپٹس فراہم کرتا ہے، جو openclaw.ai سے مہیا کیے جاتے ہیں۔

اسکرپٹ	پلیٹ فارم	یہ کیا کرتا ہے
install.sh	macOS / Linux / WSL	اگر ضرورت ہو تو Node انسٹال کرتا ہے، npm (بطورِ طے شدہ) یا git کے ذریعے OpenClaw انسٹال کرتا ہے، اور آن بورڈنگ چلا سکتا ہے۔
install-cli.sh	macOS / Linux / WSL	Node + OpenClaw کو ایک لوکل پری فکس (~/.openclaw) میں انسٹال کرتا ہے۔ روٹ کی ضرورت نہیں۔
install.ps1	Windows (PowerShell)	اگر ضرورت ہو تو Node انسٹال کرتا ہے، npm (بطورِ طے شدہ) یا git کے ذریعے OpenClaw انسٹال کرتا ہے، اور آن بورڈنگ چلا سکتا ہے۔

فوری کمانڈز¶

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 troubleshooting دیکھیں۔

---

install.sh¶

macOS/Linux/WSL پر زیادہ تر انٹرایکٹو انسٹالیشنز کے لیے سفارش کردہ۔

فلو (install.sh)¶

Supports macOS and Linux (including WSL). If macOS is detected, installs Homebrew if missing. Node ورژن چیک کرتا ہے اور ضرورت پڑنے پر Node 22 انسٹال کرتا ہے (macOS پر Homebrew، Linux apt/dnf/yum پر NodeSource سیٹ اپ اسکرپٹس)۔ اگر Git موجود نہ ہو تو اسے انسٹال کرتا ہے۔ - npm طریقہ (بطورِ طے شدہ): عالمی npm انسٹال - git طریقہ: ریپو کلون/اپ ڈیٹ کریں، pnpm کے ذریعے ڈیپس انسٹال کریں، بلڈ کریں، پھر ~/.local/bin/openclaw پر ریپر انسٹال کریں - اپ گریڈز اور git انسٹالز پر openclaw doctor --non-interactive چلاتا ہے (بہترین کوشش) - موزوں حالات میں آن بورڈنگ کی کوشش کرتا ہے (TTY دستیاب ہو، آن بورڈنگ غیر فعال نہ ہو، اور bootstrap/config چیکس کامیاب ہوں) - بطورِ طے شدہ SHARP_IGNORE_GLOBAL_LIBVIPS=1

سورس چیک آؤٹ کی شناخت¶

اگر 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 -- --dry-run

فلیگ	وضاحت
--install-method npm\\|git	Choose install method (default: npm). Alias: --method
--npm	npm طریقے کے لیے شارٹ کٹ
--git	Shortcut for git method. Alias: --github
--version <version\\|dist-tag>	npm ورژن یا dist-tag (بطورِ طے شدہ: latest)
--beta	اگر دستیاب ہو تو beta dist-tag استعمال کریں، ورنہ latest پر واپس جائیں
--git-dir <path>	Checkout directory (default: ~/openclaw). Alias: --dir
--no-git-update	موجودہ چیک آؤٹ کے لیے git pull چھوڑ دیں
--no-prompt	پرامپٹس غیر فعال کریں
--no-onboard	آن بورڈنگ چھوڑ دیں
--onboard	آن بورڈنگ فعال کریں
--dry-run	تبدیلیاں لاگو کیے بغیر کارروائیاں پرنٹ کریں
--verbose	ڈیبگ آؤٹ پٹ فعال کریں (set -x، npm notice-level لاگز)
--help	استعمال دکھائیں (-h)

متغیر	وضاحت
OPENCLAW_INSTALL_METHOD=git\\|npm	انسٹال طریقہ
OPENCLAW_VERSION=latest\\|next\\|<semver>	npm ورژن یا dist-tag
OPENCLAW_BETA=0\\|1	اگر دستیاب ہو تو beta استعمال کریں
OPENCLAW_GIT_DIR=<path>	چیک آؤٹ ڈائریکٹری
OPENCLAW_GIT_UPDATE=0\\|1	git اپ ڈیٹس کو ٹوگل کریں
OPENCLAW_NO_PROMPT=1	پرامپٹس غیر فعال کریں
OPENCLAW_NO_ONBOARD=1	آن بورڈنگ چھوڑ دیں
OPENCLAW_DRY_RUN=1	Dry run موڈ
OPENCLAW_VERBOSE=1	ڈیبگ موڈ
OPENCLAW_NPM_LOGLEVEL=error\\|warn\\|notice	npm لاگ لیول
SHARP_IGNORE_GLOBAL_LIBVIPS=0\\|1	sharp/libvips کے رویے کو کنٹرول کریں (بطورِ طے شدہ: 1)

---

install-cli.sh¶

ان ماحول کے لیے ڈیزائن کیا گیا ہے جہاں آپ چاہتے ہیں کہ سب کچھ ایک مقامی پری فکس (بطورِ طے شدہ ~/.openclaw) کے تحت ہو اور سسٹم Node پر انحصار نہ ہو۔

فلو (install-cli.sh)¶

Node ٹاربال (بطورِ طے شدہ 22.22.0) کو <prefix>/tools/node-v<version> پر ڈاؤن لوڈ کرتا ہے اور SHA-256 کی تصدیق کرتا ہے۔ اگر Git موجود نہ ہو تو Linux پر apt/dnf/yum یا macOS پر Homebrew کے ذریعے انسٹال کرنے کی کوشش کرتا ہے۔ npm کے ذریعے --prefix <prefix> استعمال کرتے ہوئے انسٹال کرتا ہے، پھر <prefix>/bin/openclaw پر ریپر لکھتا ہے۔

مثالیں (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 -- --json --prefix /opt/openclaw bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --onboard

فلیگ	وضاحت
--prefix <path>	انسٹال پری فکس (بطورِ طے شدہ: ~/.openclaw)
--version <ver>	OpenClaw ورژن یا dist-tag (بطورِ طے شدہ: latest)
--node-version <ver>	Node ورژن (بطورِ طے شدہ: 22.22.0)
--json	NDJSON ایونٹس خارج کریں
--onboard	انسٹال کے بعد openclaw onboard چلائیں
--no-onboard	آن بورڈنگ چھوڑ دیں (بطورِ طے شدہ)
--set-npm-prefix	Linux پر، اگر موجودہ پری فکس قابلِ تحریر نہ ہو تو npm پری فکس کو ~/.npm-global پر مجبور کریں
--help	استعمال دکھائیں (-h)

متغیر	وضاحت
OPENCLAW_PREFIX=<path>	انسٹال پری فکس
OPENCLAW_VERSION=<ver>	OpenClaw ورژن یا dist-tag
OPENCLAW_NODE_VERSION=<ver>	Node ورژن
OPENCLAW_NO_ONBOARD=1	آن بورڈنگ چھوڑ دیں
OPENCLAW_NPM_LOGLEVEL=error\\|warn\\|notice	npm لاگ لیول
OPENCLAW_GIT_DIR=<path>	لیگیسی کلین اپ لوک اپ پاتھ (پرانے Peekaboo سب ماڈیول چیک آؤٹ کو ہٹاتے وقت استعمال ہوتا ہے)
SHARP_IGNORE_GLOBAL_LIBVIPS=0\\|1	sharp/libvips کے رویے کو کنٹرول کریں (بطورِ طے شدہ: 1)

---

install.ps1¶

فلو (install.ps1)¶

PowerShell 5+ درکار ہے۔ اگر موجود نہ ہو تو پہلے winget، پھر Chocolatey، پھر Scoop کے ذریعے انسٹال کرنے کی کوشش کرتا ہے۔ - npm طریقہ (بطورِ طے شدہ): منتخب -Tag استعمال کرتے ہوئے عالمی npm انسٹال - git طریقہ: ریپو کلون/اپ ڈیٹ کریں، pnpm کے ذریعے انسٹال/بلڈ کریں، اور %USERPROFILE%\.local\bin\openclaw.cmd پر ریپر انسٹال کریں ممکن ہونے پر مطلوبہ bin ڈائریکٹری کو صارف کے PATH میں شامل کرتا ہے، پھر اپ گریڈز اور git انسٹالز پر openclaw doctor --non-interactive چلاتا ہے (بہترین کوشش)۔

مثالیں (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 -GitDir "C:\openclaw" powershell & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -DryRun

فلیگ	وضاحت
-InstallMethod npm\\|git	انسٹال طریقہ (بطورِ طے شدہ: npm)
-Tag <tag>	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	Dry run موڈ

اگر -InstallMethod git استعمال کیا جائے اور Git موجود نہ ہو تو اسکرپٹ خارج ہو جاتا ہے اور Git for Windows کا لنک پرنٹ کرتا ہے۔

---

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 is required for git install method. For npm installs, Git is still checked/installed to avoid spawn git ENOENT failures when dependencies use git URLs.

Some Linux setups point npm global prefix to root-owned paths. install.sh can switch prefix to ~/.npm-global and append PATH exports to shell rc files (when those files exist).

The scripts default SHARP_IGNORE_GLOBAL_LIBVIPS=1 to avoid sharp building against system libvips. To override:

````
```bash
SHARP_IGNORE_GLOBAL_LIBVIPS=0 curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash
```
````

Git for Windows انسٹال کریں، PowerShell دوبارہ کھولیں، اور انسٹالر دوبارہ چلائیں۔

npm config get prefix چلائیں، \bin شامل کریں، اس ڈائریکٹری کو صارف کے PATH میں شامل کریں، پھر PowerShell دوبارہ کھولیں۔

عموماً PATH کا مسئلہ ہوتا ہے۔ دیکھیں Node.js خرابیوں کا ازالہ.