# 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> من أن الأرشيف يحتوي على بيان جذر واحد بالضبط، ويرفض مسارات الأرشيف ذات نمط الاجتياز، ويتأكد من وجود كل حمولة مُعلنة في البيان داخل ملف 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 المضمّن مسارات المصدر المطلقة التي تم حلّها، إضافةً إلى تخطيط الأرشيف المستخدم لكل أصل.

تُضمَّن ملفات مصدر 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