--- read_when: - Вам нужен первоклассный архив резервных копий для локального состояния OpenClaw - Вы хотите предварительно увидеть, какие пути будут включены перед сбросом или деинсталляцией summary: Справочник CLI для `openclaw backup` (создание локальных архивов резервных копий) title: Резервное копирование x-i18n: generated_at: "2026-06-28T22:41:45Z" model: gpt-5.5 postprocess_version: locale-links-v1 provider: openai source_hash: 1ac7d8e4babd24f1c46ac48dca6c413e12361173df83cfe485dd3945ccd30c3e source_path: cli/backup.md workflow: 16 --- # `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-09T08-00-00.000+08-00-openclaw-backup.tar.gz ``` ## Примечания - Архив включает файл `manifest.json` с разрешенными исходными путями и структурой архива. - По умолчанию выводом является архив `.tar.gz` с временной меткой в текущем рабочем каталоге. - Имена файлов резервных копий с временной меткой используют локальный часовой пояс вашего компьютера и включают смещение UTC. - Если текущий рабочий каталог находится внутри резервируемого исходного дерева, OpenClaw использует ваш домашний каталог как расположение архива по умолчанию. - Существующие файлы архивов никогда не перезаписываются. - Пути вывода внутри исходных деревьев состояния/рабочего пространства отклоняются, чтобы избежать включения архива в самого себя. - `openclaw backup verify ` проверяет, что архив содержит ровно один корневой манифест, отклоняет пути архива в стиле обхода каталогов и проверяет, что каждая заявленная в манифесте полезная нагрузка существует в tarball. - `openclaw backup create --verify` запускает эту проверку сразу после записи архива. - `openclaw backup create --only-config` создает резервную копию только активного файла конфигурации JSON. ## Что попадает в резервную копию `openclaw backup create` планирует источники резервного копирования из вашей локальной установки OpenClaw: - Каталог состояния, возвращаемый локальным резолвером состояния OpenClaw, обычно `~/.openclaw` - Путь к активному файлу конфигурации - Разрешенный каталог `credentials/`, когда он существует вне каталога состояния - Каталоги рабочих пространств, обнаруженные из текущей конфигурации, если вы не передали `--no-include-workspace` Профили аутентификации моделей уже являются частью каталога состояния в `agents//agent/auth-profiles.json`, поэтому обычно они покрываются записью резервной копии состояния. Если вы используете `--only-config`, OpenClaw пропускает обнаружение состояния, каталога учетных данных и рабочих пространств и архивирует только путь к активному файлу конфигурации. OpenClaw канонизирует пути перед созданием архива. Если конфигурация, каталог учетных данных или рабочее пространство уже находятся внутри каталога состояния, они не дублируются как отдельные источники резервного копирования верхнего уровня. Отсутствующие пути пропускаются. Полезная нагрузка архива хранит содержимое файлов из этих исходных деревьев, а встроенный `manifest.json` записывает разрешенные абсолютные исходные пути и структуру архива, использованную для каждого ресурса. Во время создания архива OpenClaw пропускает известные файлы с активными изменениями, которые не имеют ценности для восстановления, включая активные транскрипты сеансов агентов, журналы запусков cron, скользящие журналы, очереди доставки, файлы socket/pid/temp в каталоге состояния и связанные временные файлы durable-queue. Результат JSON включает `skippedVolatileCount`, чтобы автоматизация могла увидеть, сколько файлов было намеренно пропущено. Исходные файлы установленных plugin и файлы манифестов в дереве `extensions/` каталога состояния включаются, но их вложенные деревья зависимостей `node_modules/` пропускаются. Эти зависимости являются восстанавливаемыми артефактами установки; после восстановления архива используйте `openclaw plugins update ` или переустановите plugin с помощью `openclaw plugins install --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 links не поддерживаются Большие рабочие пространства обычно являются главным фактором размера архива. Если вам нужна меньшая или более быстрая резервная копия, используйте `--no-include-workspace`. Для самого маленького архива используйте `--only-config`. ## Связанные материалы - [Справочник CLI](/ru/cli)