docs/docs/uk/cli/backup.md

read_when	summary	title	x-i18n
Вам потрібен повноцінний архів резервної копії для локального стану OpenClaw Ви хочете попередньо переглянути, які шляхи буде включено перед скиданням або видаленням	Довідка CLI для `openclaw backup` (створення локальних архівів резервних копій)	Резервне копіювання	generated_at model provider source_hash source_path workflow 2026-04-24T04:11:42Z gpt-5.4 openai 88d83cf04c163d76658575aa6d90be1dd7379934fa2822a07e13311c4324f8fd cli/backup.md 15

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 і перевіряє, що кожне оголошене в маніфесті корисне навантаження існує в 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 канонізує шляхи перед побудовою архіву. Якщо конфігурація, каталог облікових даних або робочий простір уже розташовані всередині каталогу стану, вони не дублюються як окремі джерела резервного копіювання верхнього рівня. Відсутні шляхи пропускаються.

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

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

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