---
read_when:
    - شما یک آرشیو پشتیبان درجه‌یک برای وضعیت محلی OpenClaw می‌خواهید
    - می‌خواهید پیش از بازنشانی یا حذف نصب، پیش‌نمایش کنید که کدام مسیرها شامل خواهند شد.
summary: مرجع CLI برای `openclaw backup` (ایجاد آرشیوهای پشتیبان محلی)
title: پشتیبان‌گیری
x-i18n:
    generated_at: "2026-06-27T17:22:40Z"
    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>` اعتبارسنجی می‌کند که بایگانی دقیقاً یک مانیفست ریشه دارد، مسیرهای بایگانی از نوع پیمایش را رد می‌کند، و بررسی می‌کند که هر payload اعلام‌شده در مانیفست در 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 پیش از ساخت بایگانی مسیرها را canonicalize می‌کند. اگر پیکربندی،
دایرکتوری اعتبارنامه‌ها، یا یک فضای کاری از قبل داخل دایرکتوری وضعیت قرار داشته باشند،
به عنوان منابع پشتیبان سطح بالای جداگانه تکرار نمی‌شوند. مسیرهای مفقود
نادیده گرفته می‌شوند.

payload بایگانی محتوای فایل‌ها را از آن درخت‌های منبع ذخیره می‌کند، و `manifest.json` تعبیه‌شده مسیرهای منبع مطلق حل‌شده به‌همراه چیدمان بایگانی استفاده‌شده برای هر دارایی را ثبت می‌کند.

در طول ایجاد بایگانی، OpenClaw فایل‌های شناخته‌شده‌ای را که زنده تغییر می‌کنند و ارزش بازیابی ندارند رد می‌کند، از جمله رونوشت‌های نشست عامل فعال، لاگ‌های اجرای cron، لاگ‌های چرخشی، صف‌های تحویل، فایل‌های socket/pid/temp زیر دایرکتوری وضعیت، و فایل‌های temp مرتبط با صف پایدار. نتیجه JSON شامل `skippedVolatileCount` است تا اتوماسیون بتواند ببیند چند فایل عمداً حذف شده‌اند.

فایل‌های منبع و مانیفست Plugin نصب‌شده زیر درخت
`extensions/` دایرکتوری وضعیت گنجانده می‌شوند، اما درخت‌های وابستگی تو در توی `node_modules/`
آن‌ها رد می‌شوند. آن وابستگی‌ها artifactهای نصب بازساختنی هستند؛ پس از
بازیابی یک بایگانی، وقتی 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` هنگامی که پیکربندی malformed است نیز کار می‌کند، چون برای کشف فضای کاری به تجزیه پیکربندی متکی نیست.

## اندازه و کارایی

OpenClaw هیچ حداکثر اندازه پشتیبان داخلی یا محدودیت اندازه برای هر فایل اعمال نمی‌کند.

محدودیت‌های عملی از دستگاه محلی و سیستم فایل مقصد می‌آیند:

- فضای موجود برای نوشتن موقت بایگانی به‌علاوه بایگانی نهایی
- زمان لازم برای پیمایش درخت‌های بزرگ فضای کاری و فشرده‌سازی آن‌ها در یک `.tar.gz`
- زمان لازم برای اسکن دوباره بایگانی اگر از `openclaw backup create --verify` استفاده کنید یا `openclaw backup verify` را اجرا کنید
- رفتار سیستم فایل در مسیر مقصد. OpenClaw یک مرحله انتشار hard-link بدون بازنویسی را ترجیح می‌دهد و وقتی hard link پشتیبانی نشود، به copy انحصاری عقب‌نشینی می‌کند

فضاهای کاری بزرگ معمولاً عامل اصلی اندازه بایگانی هستند. اگر پشتیبان کوچک‌تر یا سریع‌تری می‌خواهید، از `--no-include-workspace` استفاده کنید.

برای کوچک‌ترین بایگانی، از `--only-config` استفاده کنید.

## مرتبط

- [مرجع CLI](/fa/cli)