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

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

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