حذف نصب

دو مسیر:

• مسیر آسان اگر openclaw همچنان نصب است.
• حذف دستی سرویس اگر CLI حذف شده اما سرویس همچنان در حال اجرا است.

مسیر آسان (CLI همچنان نصب است)

توصیه می‌شود از حذف‌کنندهٔ داخلی استفاده کنید:

openclaw uninstall

حذف وضعیت، دایرکتوری‌های فضای کاری پیکربندی‌شده را حفظ می‌کند، مگر اینکه --workspace را نیز انتخاب کنید.

پیش‌نمایش مواردی که حذف خواهند شد (ایمن):

openclaw uninstall --dry-run --all

حالت غیرتعاملی (خودکارسازی / npx). با احتیاط و فقط پس از تأیید دامنه‌ها استفاده کنید:

openclaw uninstall --all --yes --non-interactivenpx -y openclaw uninstall --all --yes --non-interactive

پرچم‌های --service، --state، --workspace و --app هرکدام دامنه‌ای جداگانه را انتخاب می‌کنند؛ --all هر چهار دامنه را انتخاب می‌کند.

مراحل دستی (با همان نتیجه):

1. سرویس Gateway را متوقف کنید:

openclaw gateway stop

2. سرویس Gateway را حذف نصب کنید (launchd/systemd/schtasks):

openclaw gateway uninstall

3. وضعیت و پیکربندی را حذف کنید:

rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"

اگر OPENCLAW_CONFIG_PATH را روی مکانی سفارشی خارج از دایرکتوری وضعیت تنظیم کرده‌اید، آن فایل را نیز حذف کنید. اگر می‌خواهید فضای کاری داخل دایرکتوری وضعیت، مانند ~/.openclaw/workspace، حفظ شود، پیش از اجرای rm -rf آن را به محل دیگری منتقل کنید یا محتویات وضعیت را به‌صورت انتخابی حذف کنید.

4. فضای کاری خود را حذف کنید (اختیاری، فایل‌های عامل را حذف می‌کند):

rm -rf ~/.openclaw/workspace

5. نصب CLI را حذف کنید (موردی را انتخاب کنید که برای نصب استفاده کرده‌اید):

npm rm -g openclawpnpm remove -g openclawbun remove -g openclaw

6. اگر برنامهٔ macOS را نصب کرده‌اید:

rm -rf /Applications/OpenClaw.app

نکات:

• اگر از پروفایل‌ها (--profile / OPENCLAW_PROFILE) استفاده کرده‌اید، مرحلهٔ ۳ را برای دایرکتوری وضعیت هر پروفایل تکرار کنید (مقدار پیش‌فرض ~/.openclaw-<profile> است).
• در حالت راه دور، دایرکتوری وضعیت روی میزبان Gateway قرار دارد؛ بنابراین مراحل ۱ تا ۴ را در آنجا نیز اجرا کنید.

حذف دستی سرویس (CLI نصب نیست)

اگر سرویس Gateway همچنان در حال اجرا است اما openclaw وجود ندارد، از این روش استفاده کنید.

macOS (launchd)

برچسب پیش‌فرض ai.openclaw.gateway است (یا در صورت استفاده از پروفایل، ai.openclaw.<profile>):

launchctl bootout gui/$UID/ai.openclaw.gatewayrm -f ~/Library/LaunchAgents/ai.openclaw.gateway.plist

اگر از پروفایل استفاده کرده‌اید، برچسب و نام فایل plist را با ai.openclaw.<profile> جایگزین کنید.

Linux (واحد کاربری systemd)

نام پیش‌فرض واحد openclaw-gateway.service است (یا openclaw-gateway-<profile>.service). ممکن است واحد قدیمیِ پیش از تغییر نام، یعنی clawdbot-gateway.service، همچنان روی دستگاه‌هایی که از نصب‌های بسیار قدیمی ارتقا یافته‌اند وجود داشته باشد؛ openclaw uninstall / openclaw gateway uninstall آن را به‌طور خودکار شناسایی و حذف می‌کند.

systemctl --user disable --now openclaw-gateway.servicerm -f ~/.config/systemd/user/openclaw-gateway.servicesystemctl --user daemon-reload

Windows (وظیفهٔ زمان‌بندی‌شده)

نام پیش‌فرض وظیفه OpenClaw Gateway است (یا OpenClaw Gateway (<profile>)). این وظیفه، اسکریپت بدون پنجرهٔ gateway.vbs را از دایرکتوری وضعیت شما اجرا می‌کند که آن نیز gateway.cmd را اجرا می‌کند؛ هر دو را حذف کنید.

schtasks /Delete /F /TN "OpenClaw Gateway"Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd" -ErrorAction SilentlyContinueRemove-Item -Force "$env:USERPROFILE\.openclaw\gateway.vbs" -ErrorAction SilentlyContinue

اگر از پروفایل استفاده کرده‌اید، نام وظیفهٔ منطبق و فایل‌های gateway.cmd / gateway.vbs را در ~\.openclaw-<profile> حذف کنید.

نصب عادی در برابر دریافت کد منبع

نصب عادی (install.sh / npm / pnpm / bun)

اگر از https://openclaw.ai/install.sh یا install.ps1 استفاده کرده‌اید، CLI با npm install -g openclaw@latest نصب شده است. آن را با npm rm -g openclaw حذف کنید (یا اگر با روش دیگری نصب کرده‌اید، از pnpm remove -g / bun remove -g استفاده کنید).

دریافت کد منبع (git clone)

اگر از نسخهٔ دریافت‌شدهٔ مخزن اجرا می‌کنید (git clone + openclaw ... / bun run openclaw ...):

1. سرویس Gateway را پیش از حذف مخزن، حذف نصب کنید (از مسیر آسان بالا یا حذف دستی سرویس استفاده کنید).
2. دایرکتوری مخزن را حذف کنید.
3. وضعیت و فضای کاری را مطابق توضیحات بالا حذف کنید.

مرتبط

• نمای کلی نصب
• راهنمای مهاجرت