openclaw backup

أنشئ أرشيف نسخ احتياطي محليًا لحالة OpenClaw، والتكوين، وملفات تعريف المصادقة، وبيانات اعتماد القنوات/المزوّدين، والجلسات، ومساحات العمل اختياريًا.

openclaw backup createopenclaw backup create --output ~/Backupsopenclaw backup create --dry-run --jsonopenclaw backup create --verifyopenclaw backup create --no-include-workspaceopenclaw backup create --only-configopenclaw backup verify ./2026-03-09T08-00-00.000+08-00-openclaw-backup.tar.gz

ملاحظات

• يتضمن الأرشيف ملف manifest.json يحتوي على مسارات المصدر المحلولة وتخطيط الأرشيف.
• يكون الإخراج الافتراضي أرشيف .tar.gz بطابع زمني في دليل العمل الحالي.
• تستخدم أسماء ملفات النسخ الاحتياطي ذات الطابع الزمني المنطقة الزمنية المحلية لجهازك وتتضمن إزاحة UTC.
• إذا كان دليل العمل الحالي داخل شجرة مصدر يتم نسخها احتياطيًا، يعود OpenClaw إلى دليل المنزل لديك ليكون موقع الأرشيف الافتراضي.
• لا تُستبدل ملفات الأرشيف الموجودة أبدًا.
• تُرفض مسارات الإخراج داخل أشجار الحالة/مساحة العمل المصدرية لتجنب تضمينها ذاتيًا.
• يتحقق openclaw backup verify <archive> من أن الأرشيف يحتوي على بيان جذري واحد بالضبط، ويرفض مسارات الأرشيف بأسلوب اجتياز الدلائل، ويتحقق من وجود كل حمولة يعلنها البيان داخل ملف 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 ملفات التعديل الحي المعروفة التي لا قيمة لها عند الاستعادة، بما في ذلك نصوص جلسات الوكلاء النشطة، وسجلات تشغيل Cron، والسجلات الدوّارة، وطوابير التسليم، وملفات المقابس/معرّفات العمليات/الملفات المؤقتة ضمن دليل الحالة، وملفات الطوابير المتينة المؤقتة ذات الصلة. تتضمن نتيجة JSON القيمة skippedVolatileCount حتى تتمكن الأتمتة من معرفة عدد الملفات التي حُذفت عمدًا.

تُضمّن ملفات مصدر Plugin المثبتة وملفات البيان تحت شجرة extensions/ في دليل الحالة، لكن تُتخطى أشجار تبعيات node_modules/ المتداخلة الخاصة بها. هذه التبعيات هي مصنوعات تثبيت قابلة لإعادة البناء؛ بعد استعادة أرشيف، استخدم openclaw plugins update <id> أو أعد تثبيت Plugin باستخدام openclaw plugins install <spec> --force عندما يبلّغ Plugin مستعاد عن تبعيات مفقودة.

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

يتجاوز openclaw backup عمدًا فحص التكوين التمهيدي العادي حتى يظل قادرًا على المساعدة أثناء الاسترداد. ولأن اكتشاف مساحة العمل يعتمد على تكوين صالح، يفشل openclaw backup create الآن بسرعة عندما يكون ملف التكوين موجودًا لكنه غير صالح وما زال النسخ الاحتياطي لمساحة العمل مفعّلًا.

إذا كنت لا تزال تريد نسخة احتياطية جزئية في هذه الحالة، فأعد التشغيل:

openclaw backup create --no-include-workspace

يبقي ذلك الحالة، والتكوين، ودليل بيانات الاعتماد الخارجي ضمن النطاق مع تخطي اكتشاف مساحة العمل بالكامل.

إذا كنت تحتاج فقط إلى نسخة من ملف التكوين نفسه، فإن --only-config يعمل أيضًا عندما يكون التكوين مشوّهًا لأنه لا يعتمد على تحليل التكوين لاكتشاف مساحة العمل.

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

لا يفرض OpenClaw حدًا أقصى مدمجًا لحجم النسخة الاحتياطية أو حدًا لحجم كل ملف.

تأتي الحدود العملية من الجهاز المحلي ونظام ملفات الوجهة:

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

عادةً تكون مساحات العمل الكبيرة هي العامل الرئيسي في حجم الأرشيف. إذا أردت نسخة احتياطية أصغر أو أسرع، فاستخدم --no-include-workspace.

للحصول على أصغر أرشيف، استخدم --only-config.

ذو صلة

• مرجع CLI