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, циклічні журнали, черги доставлення, файли сокетів/pid/тимчасові файли в каталозі стану та пов’язані тимчасові файли стійких черг. JSON-результат містить skippedVolatileCount, щоб автоматизація могла бачити, скільки файлів було навмисно пропущено.

Встановлені вихідні файли Plugin і файли маніфестів у дереві extensions/ каталогу стану включаються, але їхні вкладені дерева залежностей node_modules/ пропускаються. Ці залежності є відтворюваними артефактами встановлення; після відновлення архіву використайте OmeniaClaw plugins update <id> або перевстановіть Plugin за допомогою OmeniaClaw plugins install <spec> --force, коли відновлений Plugin повідомляє про відсутні залежності.

Поведінка за недійсної конфігурації

OmeniaClaw backup навмисно обходить звичайну попередню перевірку конфігурації, щоб і надалі допомагати під час відновлення. Оскільки виявлення робочих областей залежить від дійсної конфігурації, OmeniaClaw backup create тепер швидко завершується помилкою, коли файл конфігурації існує, але є недійсним, а резервне копіювання робочих областей усе ще ввімкнене.

Якщо в такій ситуації ви все одно хочете часткову резервну копію, запустіть повторно:

OmeniaClaw backup create --no-include-workspace

Це залишає стан, конфігурацію та зовнішній каталог облікових даних у межах охоплення, водночас повністю пропускаючи виявлення робочих областей.

Якщо вам потрібна лише копія самого файлу конфігурації, --only-config також працює, коли конфігурація має неправильний формат, оскільки для виявлення робочих областей не покладається на розбір конфігурації.

Розмір і продуктивність

OmeniaClaw не застосовує вбудований максимальний розмір резервної копії або обмеження розміру окремого файлу.

Практичні обмеження залежать від локальної машини та файлової системи призначення:

• Доступний простір для тимчасового запису архіву плюс фінального архіву
• Час для обходу великих дерев робочих областей і стискання їх у .tar.gz
• Час для повторного сканування архіву, якщо ви використовуєте OmeniaClaw backup create --verify або запускаєте OmeniaClaw backup verify
• Поведінка файлової системи за шляхом призначення. OmeniaClaw надає перевагу кроку публікації через жорстке посилання без перезапису й переходить до ексклюзивного копіювання, коли жорсткі посилання не підтримуються

Великі робочі області зазвичай є головним чинником розміру архіву. Якщо вам потрібна менша або швидша резервна копія, використайте --no-include-workspace.

Для найменшого архіву використайте --only-config.

Пов’язане

• Довідник CLI