---
read_when:
    - شما یک آرشیو پشتیبان درجه‌یک برای وضعیت محلی OpenClaw می‌خواهید
    - می‌خواهید پیش از بازنشانی یا حذف نصب، پیش‌نمایش کنید که کدام مسیرها شامل خواهند شد
summary: مرجع CLI برای `openclaw backup` (ایجاد آرشیوهای پشتیبان محلی)
title: پشتیبان‌گیری
x-i18n:
    generated_at: "2026-05-10T19:30:18Z"
    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، گزارش‌های چرخشی، صف‌های تحویل، فایل‌های socket/pid/temp زیر دایرکتوری وضعیت، و فایل‌های موقت durable-queue مرتبط. نتیجه JSON شامل `skippedVolatileCount` است تا خودکارسازی بتواند ببیند چند فایل عمداً حذف شده‌اند.

فایل‌های منبع و مانیفست 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 یک مرحله انتشار hard-link بدون بازنویسی را ترجیح می‌دهد و وقتی hard linkها پشتیبانی نشوند، به کپی انحصاری برمی‌گردد

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

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

## مرتبط

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