openclaw reset

إعادة تعيين OpenClaw لحالته الأولية أو حذف مكونات محددة.

⚠️ تحذير هام

أوامر reset تحذف البيانات بشكل نهائي. تأكد من عمل نسخة احتياطية قبل المتابعة.

الاستخدام الأساسي

openclaw reset [options]

الأوامر

إعادة تعيين التكوين

# حذف التكوين فقط
openclaw reset --config

# مع تأكيد
openclaw reset --config --confirm

# معاينة بدون حذف
openclaw reset --config --dry-run

حذف الجلسات

# حذف جميع الجلسات
openclaw reset --sessions

# حذف الجلسات القديمة فقط
openclaw reset --sessions --older-than 30d

# حذف جلسة محددة
openclaw reset --session agent:main:telegram:chat123

حذف السجلات

# حذف جميع السجلات
openclaw reset --logs

# حذف السجلات القديمة
openclaw reset --logs --older-than 7d

# حذف سجلات قناة محددة
openclaw reset --logs --source telegram

إعادة تعيين الإقرانات

# إلغاء جميع الإقرانات
openclaw reset --pairings

# لقناة محددة
openclaw reset --pairings --channel telegram

# مع الاحتفاظ بالطلبات المعلقة
openclaw reset --pairings --keep-pending

إعادة تعيين كاملة

# حذف كل شيء (تكوين، جلسات، سجلات، إقرانات)
openclaw reset --all

# مع تأكيد إضافي
openclaw reset --all --confirm

# حذف كل شيء بما في ذلك الإضافات
openclaw reset --all --purge

الخيارات

الخيارالوصف
--allإعادة تعيين كاملة لكل شيء
--configحذف التكوين فقط
--sessionsحذف الجلسات
--logsحذف السجلات
--pairingsإلغاء جميع الإقرانات
--pluginsإزالة جميع الإضافات
--confirmتأكيد بدون سؤال
--dry-runمعاينة بدون حذف
--purgeحذف شامل بما في ذلك الملفات المخفية
--older-than <duration>حذف العناصر الأقدم من المدة المحددة
--channel <name>قناة محددة فقط
--keep-workspaceالاحتفاظ بملفات workspace

ما الذي يتم حذفه؟

--config

  • • ملف التكوين الرئيسي (config.json)
  • • إعدادات القنوات
  • • API keys (إن لم يكن في متغيرات البيئة)
  • • تفضيلات النماذج

--sessions

  • • تاريخ المحادثات
  • • ذاكرة الجلسات
  • • السياق المضغوط
  • • ملفات الجلسات المؤقتة

--logs

  • • ملفات السجلات النصية
  • • سجلات Gateway
  • • سجلات القنوات
  • • سجلات الأخطاء

--pairings

  • • قائمة الأجهزة المقترنة
  • • طلبات الإقران المعلقة
  • • مفاتيح الإقران
  • • سجل الإقرانات

--plugins

  • • الإضافات المثبتة
  • • تكوينات الإضافات
  • • بيانات الإضافات
  • • cache الإضافات

أمثلة متقدمة

تنظيف دوري

# حذف الجلسات القديمة (أكثر من شهر)
openclaw reset --sessions --older-than 30d

# حذف السجلات القديمة (أكثر من أسبوع)
openclaw reset --logs --older-than 7d

# جدولة التنظيف التلقائي
openclaw cron add "0 0 * * 0" "openclaw reset --sessions --older-than 30d"

إعادة تعيين انتقائية

# حذف بيانات قناة محددة فقط
openclaw reset --sessions --channel telegram
openclaw reset --logs --channel telegram
openclaw reset --pairings --channel telegram

# مع الاحتفاظ بالتكوين
# (الجلسات والسجلات فقط)

إعادة تعيين مع نسخة احتياطية

# نسخ احتياطي قبل الحذف
openclaw backup create --full

# إعادة تعيين
openclaw reset --all --confirm

# استعادة إذا لزم الأمر
openclaw backup restore backup-2024-02-07.tar.gz

💡 نصائح مهمة

  • استخدم --dry-run للمعاينة أولاً
  • قم بعمل نسخة احتياطية قبل --all
  • أوقف Gateway قبل إعادة التعيين الكاملة
  • استخدم --keep-workspace للاحتفاظ بملفاتك

إعادة البناء بعد Reset

بعد إعادة تعيين كاملة، اتبع هذه الخطوات:

# 1. إعادة التعيين الكاملة
openclaw reset --all --confirm

# 2. بدء معالج الإعداد
openclaw onboard

# 3. تكوين القنوات
openclaw channels configure telegram
openclaw channels configure discord

# 4. استعادة الإقرانات
openclaw pairing approve telegram <request-id>

# 5. بدء Gateway
openclaw gateway start

# 6. التحقق من النظام
openclaw doctor

استكشاف الأخطاء

فشل الحذف

# أوقف Gateway أولاً
openclaw gateway stop

# محاولة مجدداً
openclaw reset --all --confirm

# فرض الحذف
openclaw reset --all --force

بقايا ملفات

# حذف شامل مع purge
openclaw reset --all --purge

# حذف يدوي لمجلد OpenClaw
rm -rf ~/.openclaw

# إعادة التثبيت
openclaw onboard

مشاكل الأذونات

# تصحيح الأذونات
chmod -R u+w ~/.openclaw

# الحذف مع sudo (إذا لزم الأمر)
sudo openclaw reset --all --force

⚠️ تحذير نهائي

إعادة التعيين الكاملة (--all) لا يمكن التراجع عنها.

سيتم حذف:

  • ✗ جميع المحادثات والذاكرة
  • ✗ جميع الإعدادات والتكوينات
  • ✗ جميع الإقرانات والأجهزة
  • ✗ جميع السجلات والتاريخ

قم بعمل نسخة احتياطية أولاً!

الحفاظ على البيانات

استثناء ملفات محددة

# الاحتفاظ بـ workspace
openclaw reset --all --keep-workspace

# الاحتفاظ بملفات محددة
openclaw reset --all --except "config.json,AGENTS.md"

# نسخ ملفات مهمة قبل الحذف
cp ~/.openclaw/config.json ~/config-backup.json
openclaw reset --all
cp ~/config-backup.json ~/.openclaw/config.json

الأوامر ذات الصلة

  • openclaw backup - نسخ احتياطي واستعادة
  • openclaw onboard - معالج الإعداد بعد reset
  • openclaw sessions clean - تنظيف الجلسات بدون حذف كامل
  • openclaw logs --clean - تنظيف السجلات فقط