openclaw backup

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

openclaw backup createopenclaw backup create --output ~/Backupsopenclaw backup create --dry-run --jsonopenclaw backup create --verifyopenclaw backup create --no-include-workspaceopenclaw backup create --only-configopenclaw 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 اکنون وقتی فایل پیکربندی وجود دارد اما نامعتبر است و پشتیبان‌گیری از فضای کاری هنوز فعال است، سریع شکست می‌خورد.

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

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