Maintenance
حذف نصب
دو مسیر:
- مسیر آسان اگر
openclawهنوز نصب است. - حذف دستی سرویس اگر CLI حذف شده اما سرویس هنوز در حال اجرا است.
مسیر آسان (CLI هنوز نصب است)
توصیهشده: از حذفکننده داخلی استفاده کنید:
openclaw uninstallهنگام استفاده از CLI، حذف state دایرکتوریهای workspace پیکربندیشده را حفظ میکند مگر اینکه --workspace را هم انتخاب کنید.
پیشنمایش مواردی که حذف میشوند (ایمن):
openclaw uninstall --dry-run --allغیرتعاملی (اتوماسیون / npx). با احتیاط و فقط پس از تأیید scopeها استفاده کنید:
openclaw uninstall --all --yes --non-interactivenpx -y openclaw uninstall --all --yes --non-interactiveمراحل دستی (با همان نتیجه):
- سرویس Gateway را متوقف کنید:
openclaw gateway stop- سرویس Gateway را حذف نصب کنید (launchd/systemd/schtasks):
openclaw gateway uninstall- state + config را حذف کنید:
rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"اگر OPENCLAW_CONFIG_PATH را روی مکانی سفارشی بیرون از دایرکتوری state تنظیم کردهاید، آن فایل را هم حذف کنید.
اگر میخواهید یک workspace داخل دایرکتوری state، مانند ~/.openclaw/workspace را نگه دارید، پیش از اجرای rm -rf آن را کنار بگذارید یا محتوای state را بهصورت انتخابی حذف کنید.
- workspace خود را حذف کنید (اختیاری، فایلهای agent را حذف میکند):
rm -rf ~/.openclaw/workspace- نصب CLI را حذف کنید (موردی را انتخاب کنید که استفاده کردهاید):
npm rm -g openclawpnpm remove -g openclawbun remove -g openclaw- اگر برنامه macOS را نصب کردهاید:
rm -rf /Applications/OpenClaw.appنکتهها:
- اگر از profileها (
--profile/OPENCLAW_PROFILE) استفاده کردهاید، مرحله 3 را برای هر دایرکتوری state تکرار کنید (پیشفرضها~/.openclaw-<profile>هستند). - در حالت remote، دایرکتوری state روی میزبان Gateway قرار دارد، پس مراحل 1-4 را آنجا هم اجرا کنید.
حذف دستی سرویس (CLI نصب نیست)
اگر سرویس Gateway همچنان اجرا میشود اما openclaw وجود ندارد، از این استفاده کنید.
macOS (launchd)
label پیشفرض ai.openclaw.gateway است (یا ai.openclaw.<profile>؛ legacy com.openclaw.* ممکن است هنوز وجود داشته باشد):
launchctl bootout gui/$UID/ai.openclaw.gatewayrm -f ~/Library/LaunchAgents/ai.openclaw.gateway.plistاگر از profile استفاده کردهاید، label و نام plist را با ai.openclaw.<profile> جایگزین کنید. هر plist متعلق به legacy com.openclaw.* را نیز در صورت وجود حذف کنید.
Linux (systemd user unit)
نام unit پیشفرض openclaw-gateway.service است (یا openclaw-gateway-<profile>.service):
systemctl --user disable --now openclaw-gateway.servicerm -f ~/.config/systemd/user/openclaw-gateway.servicesystemctl --user daemon-reloadWindows (Scheduled Task)
نام task پیشفرض OpenClaw Gateway است (یا OpenClaw Gateway (<profile>)).
اسکریپت task زیر دایرکتوری state شما با نام gateway.cmd قرار دارد؛ نصبهای فعلی ممکن است
یک اجراکننده بدون پنجره gateway.vbs هم بسازند که Task Scheduler آن را بهجای
باز کردن مستقیم 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اگر از profile استفاده کردهاید، نام task متناظر و فایلهای gateway.cmd /
gateway.vbs را زیر ~\.openclaw-<profile> حذف کنید.
نصب عادی در برابر checkout منبع
نصب عادی (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).
checkout منبع (git clone)
اگر از یک checkout مخزن اجرا میکنید (git clone + openclaw ... / bun run openclaw ...):
- سرویس Gateway را پیش از حذف مخزن حذف نصب کنید (از مسیر آسان بالا یا حذف دستی سرویس استفاده کنید).
- دایرکتوری مخزن را حذف کنید.
- state + workspace را همانطور که بالا نشان داده شد حذف کنید.