الانتقال إلى المحتوى الرئيسي

​
openclaw backup

أنشئ أرشيف نسخ احتياطي محليًا لحالة OpenClaw والتكوين وملفات تعريف المصادقة وبيانات اعتماد القنوات/المزوّدين والجلسات، ومساحات العمل اختياريًا. 
openclaw backup create
openclaw backup create --output ~/Backups
openclaw backup create --dry-run --json
openclaw backup create --verify
openclaw backup create --no-include-workspace
openclaw backup create --only-config
openclaw backup verify ./2026-03-09T00-00-00.000Z-openclaw-backup.tar.gz

​
ملاحظات

  • يتضمن الأرشيف ملف manifest.json يحتوي على مسارات المصدر المحلولة وتخطيط الأرشيف.
  • يكون الإخراج الافتراضي أرشيف .tar.gz مختومًا بطابع زمني في دليل العمل الحالي.
  • إذا كان دليل العمل الحالي داخل شجرة مصدر يجري نسخها احتياطيًا، فإن OpenClaw يعود إلى دليلك المنزلي كموقع افتراضي للأرشيف.
  • لا يتم أبدًا استبدال ملفات الأرشيف الموجودة.
  • تُرفض مسارات الإخراج داخل أشجار المصدر الخاصة بالحالة/مساحة العمل لتجنب تضمين الأرشيف لنفسه.
  • يتحقق openclaw backup verify <archive> من أن الأرشيف يحتوي على root manifest واحد فقط، ويرفض مسارات الأرشيف بنمط traversal، ويتأكد من وجود كل حمولة معلنة في manifest داخل tarball.
  • يشغّل openclaw backup create --verify هذا التحقق مباشرةً بعد كتابة الأرشيف.
  • يقوم openclaw backup create --only-config بنسخ ملف تكوين JSON النشط فقط احتياطيًا.

​
ما الذي يُنسخ احتياطيًا

يخطط openclaw backup create لمصادر النسخ الاحتياطي من تثبيت OpenClaw المحلي لديك:
  • دليل الحالة الذي يعيده محلل الحالة المحلية في OpenClaw، ويكون عادةً ~/.openclaw
  • مسار ملف التكوين النشط
  • دليل credentials/ المحلول عندما يوجد خارج دليل الحالة
  • أدلة مساحات العمل المكتشفة من التكوين الحالي، ما لم تمرر --no-include-workspace
تكون ملفات تعريف مصادقة النموذج موجودة بالفعل ضمن دليل الحالة تحت agents/<agentId>/agent/auth-profiles.json، لذا فهي تكون عادةً مشمولة ضمن إدخال النسخ الاحتياطي للحالة. إذا استخدمت --only-config، فإن OpenClaw يتخطى اكتشاف الحالة ودليل بيانات الاعتماد ومساحة العمل، ويؤرشف فقط مسار ملف التكوين النشط. يقوم OpenClaw بتوحيد المسارات قبل إنشاء الأرشيف. إذا كان التكوين أو دليل بيانات الاعتماد أو مساحة العمل موجودًا بالفعل داخل دليل الحالة، فلن يُكرَّر كمصدر نسخ احتياطي منفصل على المستوى الأعلى. يتم تخطي المسارات المفقودة. تخزّن حمولة الأرشيف محتويات الملفات من أشجار المصدر تلك، ويسجل manifest.json المضمّن مسارات المصدر المطلقة المحلولة بالإضافة إلى تخطيط الأرشيف المستخدم لكل أصل.

​
سلوك التكوين غير الصالح

يتجاوز openclaw backup عمدًا الفحص التمهيدي العادي للتكوين حتى يظل مفيدًا أثناء الاستعادة. ولأن اكتشاف مساحة العمل يعتمد على تكوين صالح، فإن openclaw backup create يفشل الآن سريعًا عندما يكون ملف التكوين موجودًا لكنه غير صالح بينما لا يزال نسخ مساحة العمل الاحتياطي مفعّلًا. إذا كنت لا تزال تريد نسخة احتياطية جزئية في هذه الحالة، فأعد التشغيل باستخدام: 
openclaw backup create --no-include-workspace
هذا يُبقي الحالة والتكوين ودليل بيانات الاعتماد الخارجي ضمن النطاق مع تخطي اكتشاف مساحة العمل بالكامل. إذا كنت تحتاج فقط إلى نسخة من ملف التكوين نفسه، فإن --only-config يعمل أيضًا عندما يكون التكوين غير صحيح لأنه لا يعتمد على تحليل التكوين لاكتشاف مساحة العمل.

​
الحجم والأداء

لا يفرض OpenClaw حدًا أقصى مضمّنًا لحجم النسخة الاحتياطية أو حدًا لحجم كل ملف. تأتي الحدود العملية من الجهاز المحلي ونظام الملفات الوجهة:
  • المساحة المتاحة لكتابة الأرشيف المؤقت بالإضافة إلى الأرشيف النهائي
  • الوقت اللازم لاجتياز أشجار مساحات العمل الكبيرة وضغطها في ملف .tar.gz
  • الوقت اللازم لإعادة فحص الأرشيف إذا استخدمت openclaw backup create --verify أو شغّلت openclaw backup verify
  • سلوك نظام الملفات في مسار الوجهة. يفضّل OpenClaw خطوة نشر عبر hard-link بدون استبدال، ويعود إلى النسخ الحصري عندما لا تكون hard links مدعومة
تكون مساحات العمل الكبيرة عادةً العامل الرئيسي في حجم الأرشيف. إذا كنت تريد نسخة احتياطية أصغر أو أسرع، فاستخدم --no-include-workspace. وللحصول على أصغر أرشيف، استخدم --only-config.