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

# `openclaw backup`

Створіть локальний резервний архів для стану OpenClaw, конфігурації, профілів автентифікації, облікових даних каналів/провайдерів, сесій і, за бажання, робочих просторів.

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

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

```bash
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](/uk/cli)
