---
read_when:
    - تريد أرشيف نسخ احتياطي من الدرجة الأولى لحالة OpenClaw المحلية
    - تريد معاينة المسارات التي ستُدرج قبل إعادة الضبط أو إلغاء التثبيت
summary: مرجع CLI لـ `openclaw backup` (إنشاء أرشيفات نسخ احتياطي محلية)
title: النسخ الاحتياطي
x-i18n:
    generated_at: "2026-05-10T19:28:59Z"
    model: gpt-5.5
    provider: openai
    source_hash: 2c95cf475a563ad4f0a2dbaeda504b265580545c9d3f6f71d2f4d2a183e76a5c
    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` المضمّن مسارات المصدر المطلقة المحلولة بالإضافة إلى تخطيط الأرشيف المستخدم لكل أصل.

أثناء إنشاء الأرشيف، يتخطى OpenClaw ملفات التعديل الحي المعروفة التي لا تحمل قيمة للاستعادة، بما في ذلك نصوص جلسات الوكلاء النشطة، وسجلات تشغيل Cron، والسجلات الدوّارة، وقوائم انتظار التسليم، وملفات المقبس/معرّف العملية/المؤقتة ضمن دليل الحالة، والملفات المؤقتة ذات الصلة لقوائم الانتظار المتينة. تتضمن نتيجة JSON القيمة `skippedVolatileCount` حتى تتمكن الأتمتة من معرفة عدد الملفات التي حُذفت عمدًا.

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