---
read_when:
    - تريد أرشيف نسخ احتياطي أساسيًا للحالة المحلية لـ OpenClaw
    - تريد معاينة المسارات التي ستُضمَّن قبل إعادة الضبط أو إلغاء التثبيت
summary: مرجع CLI للأمر `openclaw backup` (إنشاء أرشيفات نسخ احتياطي محلية)
title: backup
x-i18n:
    generated_at: "2026-04-05T12:37:48Z"
    model: gpt-5.4
    provider: openai
    source_hash: 700eda8f9eac1cc93a854fa579f128e5e97d4e6dfc0da75b437c0fb2a898a37d
    source_path: cli/backup.md
    workflow: 15
---

# `openclaw backup`

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

```bash
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` يفشل الآن سريعًا عندما يكون ملف التكوين موجودًا لكنه غير صالح بينما لا يزال نسخ مساحة العمل الاحتياطي مفعّلًا.

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

```bash
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`.
