---
read_when:
    - تريد أرشيف نسخ احتياطي من الدرجة الأولى لحالة OpenClaw المحلية
    - تريد معاينة المسارات التي ستُدرج قبل إعادة الضبط أو إلغاء التثبيت
summary: مرجع CLI لـ `openclaw backup` (إنشاء أرشيفات نسخ احتياطي محلية)
title: النسخ الاحتياطي
x-i18n:
    generated_at: "2026-04-30T07:46:34Z"
    model: gpt-5.5
    provider: openai
    source_hash: 5c16f953bb32a1613181448f0e4c6ba8777383bce95bddc856dc7e1c3afe8550
    source_path: cli/backup.md
    workflow: 16
---

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

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

```bash
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](/ar/cli)
