---
read_when:
    - تريد أرشيف نسخ احتياطي من الدرجة الأولى لحالة OpenClaw المحلية
    - تريد معاينة المسارات التي سيتم تضمينها قبل إعادة الضبط أو إلغاء التثبيت
summary: مرجع CLI لـ `openclaw backup` (إنشاء أرشيفات نسخ احتياطي محلية)
title: نسخ احتياطي
x-i18n:
    generated_at: "2026-06-27T17:20:00Z"
    model: gpt-5.5
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: 1ac7d8e4babd24f1c46ac48dca6c413e12361173df83cfe485dd3945ccd30c3e
    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-09T08-00-00.000+08-00-openclaw-backup.tar.gz
```

## ملاحظات

- يتضمن الأرشيف ملف `manifest.json` يحتوي على مسارات المصدر المحلولة وتخطيط الأرشيف.
- يكون الإخراج الافتراضي أرشيف `.tar.gz` بطابع زمني في دليل العمل الحالي.
- تستخدم أسماء ملفات النسخ الاحتياطي ذات الطابع الزمني المنطقة الزمنية المحلية لجهازك وتتضمن إزاحة UTC.
- إذا كان دليل العمل الحالي داخل شجرة مصدر يتم نسخها احتياطيًا، يعود 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)