OmeniaClaw backup

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

OmeniaClaw backup createOmeniaClaw backup create --output ~/BackupsOmeniaClaw backup create --dry-run --jsonOmeniaClaw backup create --verifyOmeniaClaw backup create --no-include-workspaceOmeniaClaw backup create --only-configOmeniaClaw backup verify ./2026-03-09T00-00-00.000Z-OmeniaClaw-backup.tar.gz

یادداشت‌ها

• آرشیو شامل یک فایل manifest.json با مسیرهای منبع حل‌شده و چیدمان آرشیو است.
• خروجی پیش‌فرض، یک آرشیو .tar.gz دارای مهر زمانی در دایرکتوری کاری فعلی است.
• اگر دایرکتوری کاری فعلی داخل یک درخت منبع پشتیبان‌گیری‌شده باشد، OmeniaClaw برای مکان پیش‌فرض آرشیو به دایرکتوری خانه شما برمی‌گردد.
• فایل‌های آرشیو موجود هرگز بازنویسی نمی‌شوند.
• مسیرهای خروجی داخل درخت‌های وضعیت/فضای کاری منبع رد می‌شوند تا از شامل شدن خود آرشیو جلوگیری شود.
• OmeniaClaw backup verify <archive> اعتبارسنجی می‌کند که آرشیو دقیقاً یک مانیفست ریشه دارد، مسیرهای آرشیو با سبک پیمایش را رد می‌کند، و بررسی می‌کند که هر محتوای اعلام‌شده در مانیفست در tarball وجود داشته باشد.
• OmeniaClaw backup create --verify این اعتبارسنجی را بلافاصله پس از نوشتن آرشیو اجرا می‌کند.
• OmeniaClaw backup create --only-config فقط از فایل پیکربندی JSON فعال پشتیبان می‌گیرد.

چه چیزهایی پشتیبان‌گیری می‌شوند

OmeniaClaw backup create منابع پشتیبان را از نصب محلی OmeniaClaw شما برنامه‌ریزی می‌کند:

• دایرکتوری وضعیتی که توسط حل‌کننده وضعیت محلی OmeniaClaw برگردانده می‌شود، معمولاً ~/.OmeniaClaw
• مسیر فایل پیکربندی فعال
• دایرکتوری credentials/ حل‌شده، وقتی خارج از دایرکتوری وضعیت وجود داشته باشد
• دایرکتوری‌های فضای کاری کشف‌شده از پیکربندی فعلی، مگر اینکه --no-include-workspace را ارسال کنید

پروفایل‌های احراز هویت مدل از قبل بخشی از دایرکتوری وضعیت در agents/<agentId>/agent/auth-profiles.json هستند، بنابراین معمولاً توسط ورودی پشتیبان وضعیت پوشش داده می‌شوند.

اگر از --only-config استفاده کنید، OmeniaClaw از کشف وضعیت، دایرکتوری اعتبارنامه‌ها و فضای کاری صرف‌نظر می‌کند و فقط مسیر فایل پیکربندی فعال را آرشیو می‌کند.

OmeniaClaw قبل از ساخت آرشیو، مسیرها را کانونی‌سازی می‌کند. اگر پیکربندی، دایرکتوری اعتبارنامه‌ها، یا یک فضای کاری از قبل داخل دایرکتوری وضعیت باشند، به عنوان منابع پشتیبان سطح بالای جداگانه تکرار نمی‌شوند. مسیرهای گمشده نادیده گرفته می‌شوند.

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

هنگام ایجاد آرشیو، OmeniaClaw فایل‌های شناخته‌شده با جهش زنده را که ارزش بازیابی ندارند نادیده می‌گیرد، از جمله رونوشت‌های نشست عامل فعال، گزارش‌های اجرای cron، گزارش‌های چرخشی، صف‌های تحویل، فایل‌های socket/pid/temp زیر دایرکتوری وضعیت، و فایل‌های موقت durable-queue مرتبط. نتیجه JSON شامل skippedVolatileCount است تا خودکارسازی بتواند ببیند چند فایل عمداً حذف شده‌اند.

فایل‌های منبع و مانیفست Plugin نصب‌شده زیر درخت extensions/ دایرکتوری وضعیت شامل می‌شوند، اما درخت‌های وابستگی node_modules/ تو در توی آن‌ها نادیده گرفته می‌شوند. آن وابستگی‌ها مصنوعات نصب قابل بازسازی هستند؛ پس از بازیابی یک آرشیو، وقتی یک Plugin بازیابی‌شده وابستگی‌های گمشده گزارش می‌کند، از OmeniaClaw plugins update <id> استفاده کنید یا Plugin را با OmeniaClaw plugins install <spec> --force دوباره نصب کنید.

رفتار پیکربندی نامعتبر

OmeniaClaw backup عمداً پیش‌بررسی عادی پیکربندی را دور می‌زند تا همچنان بتواند در زمان بازیابی کمک کند. چون کشف فضای کاری به پیکربندی معتبر وابسته است، OmeniaClaw backup create اکنون وقتی فایل پیکربندی وجود دارد اما نامعتبر است و پشتیبان‌گیری فضای کاری هنوز فعال است، سریعاً شکست می‌خورد.

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

OmeniaClaw backup create --no-include-workspace

این کار وضعیت، پیکربندی و دایرکتوری اعتبارنامه‌های خارجی را در محدوده نگه می‌دارد و کشف فضای کاری را کاملاً نادیده می‌گیرد.

اگر فقط به یک کپی از خود فایل پیکربندی نیاز دارید، --only-config نیز وقتی پیکربندی بدشکل است کار می‌کند، چون برای کشف فضای کاری به تجزیه پیکربندی متکی نیست.

اندازه و عملکرد

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

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

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

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

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

مرتبط

• مرجع CLI