Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
openclaw backup
أنشئ أرشيف نسخ احتياطي محليًا لحالة OpenClaw، والإعدادات، وملفات تعريف المصادقة، وبيانات اعتماد القنوات/المزوّدين، والجلسات، ومساحات العمل اختياريًا.
ملاحظات
- يتضمن الأرشيف ملف
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 المضمّن مسارات المصدر المطلقة المحلولة بالإضافة إلى تخطيط الأرشيف المستخدم لكل أصل.
أثناء إنشاء الأرشيف، يتخطى OpenClaw ملفات التعديل الحي المعروفة التي لا تحمل قيمة للاستعادة، بما في ذلك نصوص جلسات الوكلاء النشطة، وسجلات تشغيل Cron، والسجلات الدوّارة، وقوائم انتظار التسليم، وملفات المقبس/معرّف العملية/المؤقتة ضمن دليل الحالة، والملفات المؤقتة ذات الصلة لقوائم الانتظار المتينة. تتضمن نتيجة JSON القيمة skippedVolatileCount حتى تتمكن الأتمتة من معرفة عدد الملفات التي حُذفت عمدًا.
تُضمّن ملفات مصدر وبيان Plugin المثبتة تحت شجرة extensions/ في دليل الحالة،
لكن تُتخطى أشجار تبعيات node_modules/ المتداخلة الخاصة بها. هذه التبعيات
عناصر تثبيت قابلة لإعادة البناء؛ بعد استعادة أرشيف، استخدم openclaw plugins update <id> أو أعد تثبيت Plugin
باستخدام openclaw plugins install <spec> --force عندما يبلّغ Plugin مستعاد
عن تبعيات مفقودة.
سلوك الإعدادات غير الصالحة
يتجاوزopenclaw backup عمدًا فحص الإعدادات التمهيدي المعتاد حتى يظل قادرًا على المساعدة أثناء الاسترداد. نظرًا لأن اكتشاف مساحات العمل يعتمد على إعدادات صالحة، يفشل openclaw backup create الآن سريعًا عندما يكون ملف الإعدادات موجودًا لكنه غير صالح، وكان النسخ الاحتياطي لمساحات العمل لا يزال مفعّلًا.
إذا كنت لا تزال تريد نسخة احتياطية جزئية في هذه الحالة، فأعد التشغيل:
--only-config أيضًا عندما تكون الإعدادات مشوّهة، لأنه لا يعتمد على تحليل الإعدادات لاكتشاف مساحات العمل.
الحجم والأداء
لا يفرض OpenClaw حدًا أقصى مدمجًا لحجم النسخة الاحتياطية أو حدًا لحجم كل ملف. تأتي الحدود العملية من الجهاز المحلي ونظام ملفات الوجهة:- المساحة المتاحة لكتابة الأرشيف المؤقت بالإضافة إلى الأرشيف النهائي
- الوقت اللازم لاجتياز أشجار مساحات العمل الكبيرة وضغطها في
.tar.gz - الوقت اللازم لإعادة فحص الأرشيف إذا استخدمت
openclaw backup create --verifyأو شغّلتopenclaw backup verify - سلوك نظام الملفات عند مسار الوجهة. يفضّل OpenClaw خطوة نشر عبر رابط صلب لا يستبدل الملفات، ويعود إلى النسخ الحصري عندما لا تكون الروابط الصلبة مدعومة
--no-include-workspace.
للحصول على أصغر أرشيف، استخدم --only-config.