အပ်ဒိတ်လုပ်ခြင်း¶

OpenClaw သည် ("1.0" မတိုင်မီအဆင့်) လျင်မြန်စွာ ဖွံ့ဖြိုးတိုးတက်နေပါသည်။ Update များကို shipping infrastructure ကဲ့သို့ စီမံပါ—update → စစ်ဆေးမှုများ လုပ်ဆောင်ပါ → restart (သို့မဟုတ် restart ပါဝင်သည့် openclaw update ကို အသုံးပြုပါ) → verify လုပ်ပါ။

အကြံပြုချက်: ဝဘ်ဆိုက် installer ကို ပြန်လည် chạy လုပ်ပါ (နေရာမပြောင်းဘဲ အပ်ဂရိတ်)¶

အကြံပြုထားသော အပ်ဒိတ်လုပ်နည်းမှာ ဝဘ်ဆိုဒ်မှ installer ကို ထပ်မံ chạy/run လုပ်ခြင်း ဖြစ်သည်။ ၎င်းသည် ရှိပြီးသား install များကို ရှာဖွေတွေ့ရှိပြီး၊ နေရာတွင်ပင် upgrade လုပ်ကာ လိုအပ်သည့်အခါ openclaw doctor ကို chạy/run လုပ်ပေးပါသည်။

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

မှတ်ချက်များ—

• onboarding wizard ကို ထပ်မံ chạy မလုပ်စေလိုပါက --no-onboard ကို ထည့်ပါ။

• source install များအတွက်—

bash curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --no-onboard

repo သန့်ရှင်းနေပါကသာ installer သည် git pull --rebase ကို သာလျှင် ဆောင်ရွက်ပါမည်။

• global install များအတွက် script သည် အတွင်းပိုင်းတွင် npm install -g openclaw@latest ကို အသုံးပြုပါသည်။

• Legacy မှတ်ချက်: clawdbot ကို compatibility shim အဖြစ် ဆက်လက် အသုံးပြုနိုင်ပါသည်။

အပ်ဒိတ်မလုပ်မီ¶

• သင် ဘယ်လို install လုပ်ထားသည်ကို သိပါ—global (npm/pnpm) သို့မဟုတ် source မှ (git clone)။
• သင်၏ Gateway ကို ဘယ်လို chạy နေသည်ကို သိပါ—foreground terminal သို့မဟုတ် supervised service (launchd/systemd)။
• သင်ပြင်ဆင်ထားသည့် အရာများကို snapshot ယူထားပါ—
• Config: ~/.openclaw/openclaw.json
• Credentials: ~/.openclaw/credentials/
• Workspace: ~/.openclaw/workspace

အပ်ဒိတ် (global install)¶

Global install (တစ်ခုရွေးပါ)—

npm i -g openclaw@latest

pnpm add -g openclaw@latest

Gateway runtime အတွက် Bun ကို မထောက်ခံပါ (WhatsApp/Telegram bug များကြောင့်)။

update channel များကို ပြောင်းရန် (git + npm installs)—

openclaw update --channel beta
openclaw update --channel dev
openclaw update --channel stable

တစ်ကြိမ်တည်း install tag/version အတွက် --tag <dist-tag|version> ကို အသုံးပြုပါ။

channel အဓိပ္ပါယ်နှင့် release notes များအတွက် Development channels ကို ကြည့်ပါ။

မှတ်ချက်: npm ဖြင့် install လုပ်ထားပါက gateway သည် startup အချိန်တွင် update အကြံပြုချက်ကို log ထဲသို့ ရေးသားပါသည် (လက်ရှိ channel tag ကို စစ်ဆေးပါသည်)။ update.checkOnStart: false ဖြင့် ပိတ်နိုင်ပါသည်။

ထို့နောက်—

openclaw doctor
openclaw gateway restart
openclaw health

မှတ်ချက်များ—

• Gateway ကို service အဖြစ် chạy နေပါက PID များကို kill လုပ်ခြင်းထက် openclaw gateway restart ကို အကြံပြုပါသည်။
• တိကျသော version တစ်ခုကို pin လုပ်ထားပါက အောက်ပါ “Rollback / pinning” ကို ကြည့်ပါ။

အပ်ဒိတ် (openclaw update)¶

source install (git checkout) များအတွက် အောက်ပါကို အားပေးပါသည်—

openclaw update

၎င်းသည် အနည်းငယ်လုံခြုံသော update flow ကို chạy လုပ်ပါသည်—

• worktree သန့်ရှင်းရမည်။
• ရွေးချယ်ထားသော channel (tag သို့မဟုတ် branch) သို့ ပြောင်းပါသည်။
• upstream (dev channel) ကို fetch + rebase လုပ်ပါသည်။
• deps install လုပ်ပြီး build လုပ်ကာ Control UI ကို build လုပ်ပြီး openclaw doctor ကို chạy လုပ်ပါသည်။
• default အနေဖြင့် Gateway ကို restart လုပ်ပါသည် (--no-restart ကို သုံးပါက skip လုပ်နိုင်ပါသည်)။

npm/pnpm ဖြင့် install လုပ်ထားပါက (git metadata မရှိပါက) openclaw update သည် သင်၏ package manager မှတစ်ဆင့် update လုပ်ရန် ကြိုးစားပါလိမ့်မည်။ install ကို မသိရှိနိုင်ပါက “Update (global install)” ကို အသုံးပြုပါ။

အပ်ဒိတ် (Control UI / RPC)¶

Control UI တွင် Update & Restart (RPC: update.run) ပါရှိပါသည်။ ၎င်းသည်:

1. openclaw update နှင့်တူသော source-update flow ကို chạy လုပ်ပါသည် (git checkout အတွက်သာ)။
2. stdout/stderr tail ပါဝင်သည့် structured report ဖြင့် restart sentinel ကို ရေးသားပါသည်။
3. Gateway ကို restart လုပ်ပြီး နောက်ဆုံး active session သို့ report ကို ping လုပ်ပါသည်။

rebase မအောင်မြင်ပါက Gateway သည် အပ်ဒိတ်ကို မအသုံးချဘဲ abort လုပ်ကာ restart လုပ်ပါမည်။

အပ်ဒိတ် (source မှ)¶

repo checkout မှ—

အကြံပြု—

openclaw update

Manual (အနည်းငယ်တူညီ)—

git pull
pnpm install
pnpm build
pnpm ui:build # auto-installs UI deps on first run
openclaw doctor
openclaw health

မှတ်ချက်များ—

• packaged openclaw binary (openclaw.mjs) ကို chạy လုပ်နေပါက သို့မဟုတ် Node ဖြင့် dist/ ကို chạy လုပ်ပါက pnpm build သည် အရေးကြီးပါသည်။
• global install မရှိဘဲ repo checkout မှ chạy နေပါက CLI command များအတွက် pnpm openclaw ... ကို အသုံးပြုပါ။
• TypeScript မှ တိုက်ရိုက် chạy နေပါက (pnpm openclaw ...) rebuild မလိုအပ်သည့်အခါများရှိသော်လည်း config migration များသည် မဖြစ်မနေ သက်ရောက်ပါသည် → doctor ကို chạy လုပ်ပါ။
• global နှင့် git installs အကြား ပြောင်းရန် လွယ်ကူပါသည်—အခြား flavor ကို install လုပ်ပြီးနောက် gateway service entrypoint ကို လက်ရှိ install သို့ ပြန်ရေးရန် openclaw doctor ကို chạy လုပ်ပါ။

အမြဲ chạy လုပ်ပါ: openclaw doctor¶

Doctor က “safe update” command ပါ။ ရည်ရွယ်ချက်ရှိရှိ အလွန်ရိုးရှင်းစွာ လုပ်ထားပါသည်: repair + migrate + warn.

မှတ်ချက်: source install (git checkout) ပေါ်တွင် ရှိပါက openclaw doctor သည် ပထမဦးစွာ openclaw update ကို chạy လုပ်ရန် အကြံပြုပါမည်။

ပုံမှန် ဆောင်ရွက်သည့် အရာများ—

• deprecated config keys များ / legacy config ဖိုင်တည်နေရာများကို migrate လုပ်ပါသည်။
• DM policy များကို audit လုပ်ပြီး အန္တရာယ်ရှိသော “open” settings များအတွက် သတိပေးပါသည်။
• Gateway health ကို စစ်ဆေးပြီး restart လုပ်ရန် အကြံပြုနိုင်ပါသည်။
• အဟောင်း gateway services များ (launchd/systemd; legacy schtasks) ကို လက်ရှိ OpenClaw services သို့ ရှာဖွေတွေ့ရှိ၍ migrate လုပ်ပါသည်။
• Linux တွင် systemd user lingering ကို သေချာစေပါသည် (logout ပြုလုပ်ပြီးနောက် Gateway ဆက်လက် chạy နိုင်ရန်)။

အသေးစိတ်: Doctor

Gateway ကို စတင် / ရပ်တန့် / ပြန်လည်စတင်¶

CLI (OS မရွေး အသုံးပြုနိုင်သည်)—

openclaw gateway status
openclaw gateway stop
openclaw gateway restart
openclaw gateway --port 18789
openclaw logs --follow

supervised ဖြစ်ပါက—

• macOS launchd (app-bundled LaunchAgent): launchctl kickstart -k gui/$UID/bot.molt.gateway (use bot.molt.<profile>; legacy com.openclaw.* သည် ဆက်လက် အသုံးပြုနိုင်ပါသည်)
• Linux systemd user service: systemctl --user restart openclaw-gateway[-<profile>].service
• Windows (WSL2): systemctl --user restart openclaw-gateway[-<profile>].service
• launchctl/systemctl သည် service install လုပ်ထားပါကသာ အလုပ်လုပ်ပါသည်; မရှိပါက openclaw gateway install ကို chạy လုပ်ပါ။

Runbook နှင့် တိကျသော service labels များ: Gateway runbook

Rollback / pinning (တစ်ခုခု ပျက်သွားသောအခါ)¶

Pin (global install)¶

အလုပ်လုပ်နေခဲ့သော version ကို install လုပ်ပါ (<version> ကို နောက်ဆုံး အလုပ်လုပ်ခဲ့သည့် version ဖြင့် အစားထိုးပါ)—

npm i -g openclaw@<version>

pnpm add -g openclaw@<version>

အကြံပြုချက်: လက်ရှိ publish လုပ်ထားသော version ကို ကြည့်ရန် npm view openclaw version ကို chạy လုပ်ပါ။

ထို့နောက် restart လုပ်ပြီး doctor ကို ပြန် chạy လုပ်ပါ—

openclaw doctor
openclaw gateway restart

Pin (source) ကို ရက်စွဲအလိုက်¶

ရက်စွဲတစ်ခုမှ commit ကို ရွေးပါ (ဥပမာ—“2026-01-01 အချိန်အထိ main ၏ အခြေအနေ”)—

git fetch origin
git checkout "$(git rev-list -n 1 --before=\"2026-01-01\" origin/main)"

ထို့နောက် deps ကို ပြန် install လုပ်ပြီး restart—

pnpm install
pnpm build
openclaw gateway restart

နောက်ပိုင်း latest သို့ ပြန်လိုပါက—

git checkout main
git pull

အကူအညီလိုအပ်နေပါက¶

• openclaw doctor ကို ထပ်မံ chạy လုပ်ပြီး output ကို သေချာဖတ်ပါ (အများအားဖြင့် ပြုပြင်နည်းကို ပြောပြထားတတ်ပါသည်)။
• စစ်ဆေးရန်: Troubleshooting
• Discord တွင် မေးမြန်းပါ: https://discord.gg/clawd