# 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> перевіряє, що архів містить рівно один кореневий маніфест, відхиляє архівні шляхи у стилі traversal і перевіряє, що кожен payload, оголошений у маніфесті, існує в tarball.
• openclaw backup create --verify запускає цю перевірку одразу після запису архіву.
• openclaw backup create --only-config створює резервну копію лише активного JSON-файлу конфігурації.

# Що потрапляє до резервної копії

openclaw backup create планує джерела резервного копіювання з вашого локального встановлення OpenClaw:

• Каталог стану, який повертає локальний resolver стану OpenClaw, зазвичай ~/.openclaw
• Шлях до активного файлу конфігурації
• Визначений каталог credentials/, якщо він існує поза каталогом стану
• Каталоги робочих просторів, знайдені з поточної конфігурації, якщо ви не передасте --no-include-workspace

Профілі автентифікації моделей уже є частиною каталогу стану в agents/<agentId>/agent/auth-profiles.json, тож зазвичай вони охоплюються записом резервного копіювання стану.

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

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

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

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

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

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