openclaw backup

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

openclaw backup createopenclaw backup create --output ~/Backupsopenclaw backup create --dry-run --jsonopenclaw backup create --verifyopenclaw backup create --no-include-workspaceopenclaw backup create --only-configopenclaw backup verify ./2026-03-09T08-00-00.000+08-00-openclaw-backup.tar.gz

Примечания

• Архив включает файл manifest.json с разрешенными исходными путями и структурой архива.
• По умолчанию выводом является архив .tar.gz с временной меткой в текущем рабочем каталоге.
• Имена файлов резервных копий с временной меткой используют локальный часовой пояс вашего компьютера и включают смещение UTC.
• Если текущий рабочий каталог находится внутри резервируемого исходного дерева, OpenClaw использует ваш домашний каталог как расположение архива по умолчанию.
• Существующие файлы архивов никогда не перезаписываются.
• Пути вывода внутри исходных деревьев состояния/рабочего пространства отклоняются, чтобы избежать включения архива в самого себя.
• openclaw backup verify <archive> проверяет, что архив содержит ровно один корневой манифест, отклоняет пути архива в стиле обхода каталогов и проверяет, что каждая заявленная в манифесте полезная нагрузка существует в tarball.
• openclaw backup create --verify запускает эту проверку сразу после записи архива.
• openclaw backup create --only-config создает резервную копию только активного файла конфигурации JSON.

Что попадает в резервную копию

openclaw backup create планирует источники резервного копирования из вашей локальной установки OpenClaw:

• Каталог состояния, возвращаемый локальным резолвером состояния OpenClaw, обычно ~/.openclaw
• Путь к активному файлу конфигурации
• Разрешенный каталог credentials/, когда он существует вне каталога состояния
• Каталоги рабочих пространств, обнаруженные из текущей конфигурации, если вы не передали --no-include-workspace

Профили аутентификации моделей уже являются частью каталога состояния в agents/<agentId>/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 <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 links не поддерживаются

Большие рабочие пространства обычно являются главным фактором размера архива. Если вам нужна меньшая или более быстрая резервная копия, используйте --no-include-workspace.

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

Связанные материалы

• Справочник CLI