---
read_when:
    - می‌خواهید یک آرشیو پشتیبان درجه‌یک برای وضعیت محلی OpenClaw داشته باشید
    - می‌خواهید پیش از بازنشانی یا حذف نصب، مسیرهایی را که شامل می‌شوند پیش‌نمایش کنید
summary: مرجع CLI برای `openclaw backup` (ایجاد بایگانی‌های پشتیبان محلی)
title: پشتیبان‌گیری
x-i18n:
    generated_at: "2026-04-29T22:32:58Z"
    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/` تودرتوی آن‌ها نادیده گرفته می‌شوند. آن وابستگی‌ها مصنوعات نصب قابل بازسازی هستند؛ پس از بازیابی یک بایگانی، وقتی یک Plugin بازیابی‌شده وابستگی‌های گمشده گزارش می‌کند، از `openclaw plugins update <id>` استفاده کنید یا Plugin را با `openclaw plugins install <spec> --force` دوباره نصب کنید.

## رفتار پیکربندی نامعتبر

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