# openclaw backup

یک بایگانی پشتیبان محلی برای وضعیت، پیکربندی، پروفایل‌های احراز هویت، اعتبارنامه‌های کانال/ارائه‌دهنده، نشست‌ها، و به‌صورت اختیاری فضاهای کاری OpenClaw ایجاد کنید.

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 اکنون وقتی فایل پیکربندی وجود دارد اما نامعتبر است و پشتیبان‌گیری از فضای کاری همچنان فعال است، سریعاً شکست می‌خورد.

اگر در آن وضعیت همچنان یک پشتیبان جزئی می‌خواهید، دوباره اجرا کنید:

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