Installer အတွင်းပိုင်းလုပ်ဆောင်ပုံ¶

OpenClaw တွင် installer စခရစ် သုံးခု ပါဝင်ပြီး openclaw.ai မှ ပံ့ပိုးပေးထားပါသည်။

စကရစ်	ပလက်ဖောင်း	လုပ်ဆောင်ပုံ
install.sh	macOS / Linux / WSL	လိုအပ်ပါက Node ကို ထည့်သွင်းပြီး npm (မူလ) သို့မဟုတ် git ဖြင့် OpenClaw ကို ထည့်သွင်းကာ onboarding ကို လုပ်ဆောင်နိုင်သည်။
install-cli.sh	macOS / Linux / WSL	Node + OpenClaw ကို local prefix (~/.openclaw) အတွင်း install လုပ်ပါသည်။ root မလိုအပ်ပါ။
install.ps1	Windows (PowerShell)	လိုအပ်ပါက Node ကို ထည့်သွင်းပြီး npm (မူလ) သို့မဟုတ် git ဖြင့် OpenClaw ကို ထည့်သွင်းကာ onboarding ကို လုပ်ဆောင်နိုင်သည်။

အမြန်အမိန့်များ¶

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

install အောင်မြင်ပြီးသော်လည်း terminal အသစ်တွင် openclaw မတွေ့ပါက Node.js troubleshooting ကို ကြည့်ပါ။

---

install.sh¶

macOS/Linux/WSL တွင် အပြန်အလှန်အသုံးပြုသော install များအတွက် အများအားဖြင့် အကြံပြုပါသည်။

Flow (install.sh)¶

macOS နဲ့ Linux (WSL အပါအဝင်) ကို ထောက်ပံ့ပါတယ်။ macOS ကို တွေ့ရှိပါက မရှိသေးလျှင် Homebrew ကို install လုပ်ပါသည်။ Node ဗားရှင်းကို စစ်ဆေးပြီး လိုအပ်ပါက Node 22 ကို ထည့်သွင်းသည် (macOS တွင် Homebrew၊ Linux apt/dnf/yum တွင် NodeSource setup scripts)။ Git မရှိပါက ထည့်သွင်းသည်။ - npm နည်းလမ်း (မူလ): global npm install - git နည်းလမ်း: repo ကို clone/update လုပ်ပြီး pnpm ဖြင့် deps ကို ထည့်သွင်း၊ build လုပ်ကာ ~/.local/bin/openclaw တွင် wrapper ကို ထည့်သွင်းသည် - upgrade နှင့် git install များတွင် openclaw doctor --non-interactive ကို run လုပ်သည် (အတတ်နိုင်ဆုံး) - သင့်လျော်သည့်အခါ onboarding ကို ကြိုးပမ်းလုပ်ဆောင်သည် (TTY ရှိ၊ onboarding မပိတ်ထား၊ bootstrap/config စစ်ဆေးချက်များ အောင်မြင်) - မူလအဖြစ် SHARP_IGNORE_GLOBAL_LIBVIPS=1

Source checkout ကို သိရှိခြင်း¶

OpenClaw checkout (package.json + pnpm-workspace.yaml) အတွင်းတွင် run လုပ်ပါက စခရစ်သည် အောက်ပါရွေးချယ်မှုများကို ပေးသည်—

• checkout ကို အသုံးပြုခြင်း (git), သို့မဟုတ်
• global install ကို အသုံးပြုခြင်း (npm)

TTY မရှိဘဲ install နည်းလမ်းကို မသတ်မှတ်ထားပါက npm ကို မူလအဖြစ် သတ်မှတ်ပြီး သတိပေးချက် ထုတ်ပေးသည်။

နည်းလမ်းရွေးချယ်မှု မမှန်ကန်ခြင်း သို့မဟုတ် --install-method တန်ဖိုးများ မမှန်ကန်ပါက စခရစ်သည် exit code 2 ဖြင့် အဆုံးသတ်သည်။

Examples (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

Flag	ဖော်ပြချက်
--install-method npm\\|git	install နည်းလမ်းကို ရွေးပါ (default: npm)။ Alias: --method
--npm	npm နည်းလမ်းအတွက် shortcut
--git	git နည်းလမ်းအတွက် shortcut ဖြစ်ပါသည်။ Alias: --github
--version <version\\|dist-tag>	npm ဗားရှင်း သို့မဟုတ် dist-tag (မူလ: latest)
--beta	ရရှိနိုင်ပါက beta dist-tag ကို အသုံးပြုပြီး မရှိပါက latest သို့ ပြန်လည် fallback
--git-dir <path>	Checkout directory (default: ~/openclaw)။ Alias: --dir
--no-git-update	ရှိပြီးသား checkout အတွက် git pull ကို ကျော်လွှားရန်
--no-prompt	prompts များကို ပိတ်ရန်
--no-onboard	onboarding ကို ကျော်လွှားရန်
--onboard	onboarding ကို ဖွင့်ရန်
--dry-run	ပြောင်းလဲမှု မပြုလုပ်ဘဲ လုပ်ဆောင်ချက်များကိုသာ ပြရန်
--verbose	debug output ကို ဖွင့်ရန် (set -x, npm notice-level logs)
--help	အသုံးပြုပုံကို ပြရန် (-h)

Variable	ဖော်ပြချက်
OPENCLAW_INSTALL_METHOD=git\\|npm	install နည်းလမ်း
OPENCLAW_VERSION=latest\\|next\\|<semver>	npm ဗားရှင်း သို့မဟုတ် dist-tag
OPENCLAW_BETA=0\\|1	ရရှိနိုင်ပါက beta ကို အသုံးပြုရန်
OPENCLAW_GIT_DIR=<path>	Checkout directory
OPENCLAW_GIT_UPDATE=0\\|1	git updates ကို ဖွင့်/ပိတ်
OPENCLAW_NO_PROMPT=1	prompts များကို ပိတ်ရန်
OPENCLAW_NO_ONBOARD=1	onboarding ကို ကျော်လွှားရန်
OPENCLAW_DRY_RUN=1	Dry run mode
OPENCLAW_VERBOSE=1	Debug mode
OPENCLAW_NPM_LOGLEVEL=error\\|warn\\|notice	npm log level
SHARP_IGNORE_GLOBAL_LIBVIPS=0\\|1	sharp/libvips လုပ်ဆောင်ပုံကို ထိန်းချုပ်ရန် (မူလ: 1)

---

install-cli.sh¶

အရာအားလုံးကို local prefix (မူလ ~/.openclaw) အောက်တွင်ထားပြီး system Node အပေါ် မမူတည်လိုသည့် ပတ်ဝန်းကျင်များအတွက် ဒီဇိုင်းပြုလုပ်ထားပါသည်။

Flow (install-cli.sh)¶

Node tarball (မူလ 22.22.0) ကို <prefix>/tools/node-v<version> သို့ download လုပ်ပြီး SHA-256 ကို အတည်ပြုစစ်ဆေးသည်။ Git မရှိပါက Linux တွင် apt/dnf/yum သို့မဟုတ် macOS တွင် Homebrew ဖြင့် ထည့်သွင်းရန် ကြိုးပမ်းသည်။ --prefix <prefix> ကို အသုံးပြုပြီး npm ဖြင့် ထည့်သွင်းကာ <prefix>/bin/openclaw သို့ wrapper ကို ရေးထည့်သည်။

Examples (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

Flag	ဖော်ပြချက်
--prefix <path>	Install prefix (မူလ: ~/.openclaw)
--version <ver>	OpenClaw ဗားရှင်း သို့မဟုတ် dist-tag (မူလ: latest)
--node-version <ver>	Node ဗားရှင်း (မူလ: 22.22.0)
--json	NDJSON events ကို ထုတ်ပေးရန်
--onboard	install ပြီးနောက် openclaw onboard ကို run လုပ်ရန်
--no-onboard	onboarding ကို ကျော်လွှားရန် (မူလ)
--set-npm-prefix	Linux တွင် လက်ရှိ prefix ကို မရေးနိုင်ပါက npm prefix ကို ~/.npm-global သို့ အတင်းအကျပ် ပြောင်းရန်
--help	အသုံးပြုပုံကို ပြရန် (-h)

Variable	ဖော်ပြချက်
OPENCLAW_PREFIX=<path>	Install prefix
OPENCLAW_VERSION=<ver>	OpenClaw ဗားရှင်း သို့မဟုတ် dist-tag
OPENCLAW_NODE_VERSION=<ver>	Node ဗားရှင်း
OPENCLAW_NO_ONBOARD=1	onboarding ကို ကျော်လွှားရန်
OPENCLAW_NPM_LOGLEVEL=error\\|warn\\|notice	npm log level
OPENCLAW_GIT_DIR=<path>	Legacy cleanup lookup path (ဟောင်း Peekaboo submodule checkout ကို ဖယ်ရှားရာတွင် အသုံးပြုသည်)
SHARP_IGNORE_GLOBAL_LIBVIPS=0\\|1	sharp/libvips လုပ်ဆောင်ပုံကို ထိန်းချုပ်ရန် (မူလ: 1)

---

install.ps1¶

Flow (install.ps1)¶

PowerShell 5+ လိုအပ်သည်။ မရှိပါက winget၊ ထို့နောက် Chocolatey၊ ထို့နောက် Scoop ဖြင့် ထည့်သွင်းရန် ကြိုးပမ်းသည်။ - npm နည်းလမ်း (မူလ): ရွေးချယ်ထားသော -Tag ကို အသုံးပြုပြီး global npm install - git နည်းလမ်း: repo ကို clone/update လုပ်ပြီး pnpm ဖြင့် install/build လုပ်ကာ %USERPROFILE%\.local\bin\openclaw.cmd တွင် wrapper ကို ထည့်သွင်းသည် ဖြစ်နိုင်ပါက လိုအပ်သော bin directory ကို user PATH ထဲသို့ ထည့်သွင်းပြီး upgrade နှင့် git install များတွင် openclaw doctor --non-interactive ကို run လုပ်သည် (အတတ်နိုင်ဆုံး)။

Examples (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

Flag	ဖော်ပြချက်
-InstallMethod npm\\|git	install နည်းလမ်း (မူလ: npm)
-Tag <tag>	npm dist-tag (မူလ: latest)
-GitDir <path>	Checkout directory (မူလ: %USERPROFILE%\openclaw)
-NoOnboard	onboarding ကို ကျော်လွှားရန်
-NoGitUpdate	git pull ကို ကျော်လွှားရန်
-DryRun	လုပ်ဆောင်ချက်များကိုသာ ပြရန်

Variable	ဖော်ပြချက်
OPENCLAW_INSTALL_METHOD=git\\|npm	install နည်းလမ်း
OPENCLAW_GIT_DIR=<path>	Checkout directory
OPENCLAW_NO_ONBOARD=1	onboarding ကို ကျော်လွှားရန်
OPENCLAW_GIT_UPDATE=0	git pull ကို ပိတ်ရန်
OPENCLAW_DRY_RUN=1	Dry run mode

-InstallMethod git ကို အသုံးပြုထားပြီး Git မရှိပါက စခရစ်သည် အဆုံးသတ်ပြီး Git for Windows လင့်ခ်ကို ထုတ်ပြပါသည်။

---

CI နှင့် automation¶

ခန့်မှန်းနိုင်သော run များအတွက် non-interactive flags/env vars ကို အသုံးပြုပါ။

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

---

Troubleshooting¶

git install နည်းလမ်းအတွက် Git လိုအပ်ပါသည်။ npm install များအတွက်လည်း dependencies များက git URLs ကို အသုံးပြုသောအခါ spawn git ENOENT အမှားများ မဖြစ်စေရန် Git ကို စစ်ဆေး/ install လုပ်ပါသည်။

Linux setup အချို့တွင် npm global prefix ကို root ပိုင် path များသို့ ညွှန်ထားတတ်ပါသည်။ install.sh သည် prefix ကို ~/.npm-global သို့ ပြောင်းနိုင်ပြီး (ဖိုင်များ ရှိပါက) shell rc ဖိုင်များတွင် PATH export များကို ထည့်ပေးနိုင်ပါသည်။

scripts တွေက sharp ကို system libvips နဲ့ build မလုပ်စေဖို့ SHARP_IGNORE_GLOBAL_LIBVIPS=1 ကို default သတ်မှတ်ထားပါတယ်။ override လုပ်ရန်:

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

Git for Windows ကို ထည့်သွင်းပြီး PowerShell ကို ပြန်ဖွင့်ကာ installer ကို ထပ်မံ run လုပ်ပါ။

npm config get prefix ကို run လုပ်ပြီး \bin ကို ပေါင်းထည့်ကာ ထို directory ကို user PATH ထဲသို့ ထည့်ပြီး PowerShell ကို ပြန်ဖွင့်ပါ။

ပုံမှန်အားဖြင့် PATH ပြဿနာ ဖြစ်တတ်ပါသည်။ Node.js troubleshooting ကို ကြည့်ပါ။