Maintenance
حذف نصب
دو مسیر:
- اگر
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 هر چهار مورد را انتخاب میکند.
مراحل دستی (با همان نتیجه):
- سرویس Gateway را متوقف کنید:
openclaw gateway stop- سرویس Gateway را حذف نصب کنید (launchd/systemd/schtasks):
openclaw gateway uninstall- وضعیت و پیکربندی را حذف کنید:
rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"اگر OPENCLAW_CONFIG_PATH را روی مکانی سفارشی خارج از دایرکتوری وضعیت تنظیم کردهاید، آن فایل را نیز حذف کنید.
اگر میخواهید یک فضای کاری داخل دایرکتوری وضعیت، مانند ~/.openclaw/workspace، حفظ شود، پیش از اجرای rm -rf آن را به محل دیگری منتقل کنید یا محتوای وضعیت را بهصورت انتخابی حذف کنید.
- فضای کاری خود را حذف کنید (اختیاری، فایلهای عامل را حذف میکند):
rm -rf ~/.openclaw/workspace- نصب CLI را حذف کنید (موردی را انتخاب کنید که استفاده کردهاید):
npm rm -g openclawpnpm remove -g openclawbun remove -g openclaw- اگر برنامهٔ macOS را نصب کردهاید:
rm -rf /Applications/OpenClaw.appنکات:
- اگر از پروفایلها (
--profile/OPENCLAW_PROFILE) استفاده کردهاید، مرحلهٔ 3 را برای هر دایرکتوری وضعیت تکرار کنید (مقادیر پیشفرض~/.openclaw-<profile>هستند). - در حالت راهدور، دایرکتوری وضعیت روی میزبان Gateway قرار دارد؛ بنابراین مراحل 1 تا 4 را آنجا نیز اجرا کنید.
حذف دستی سرویس (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-reloadWindows (وظیفهٔ زمانبندیشده)
نام پیشفرض وظیفه 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 ...):
- سرویس Gateway را پیش از حذف مخزن، حذف نصب کنید (از مسیر آسان بالا یا حذف دستی سرویس استفاده کنید).
- دایرکتوری مخزن را حذف کنید.
- وضعیت و فضای کاری را مطابق توضیحات بالا حذف کنید.