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 قبل حذف المستودع (استخدم المسار السهل أعلاه أو إزالة الخدمة يدويًا).
- احذف دليل المستودع.
- أزل الحالة ومساحة العمل كما هو موضح أعلاه.