openclaw backup
Створіть локальний резервний архів для стану OpenClaw, конфігурації, профілів автентифікації, облікових даних каналів/провайдерів, сесій і, за потреби, робочих просторів.
Примітки
- Архів містить файл
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 фіксує визначені абсолютні шляхи джерел і структуру архіву, використану для кожного ресурсу.
Поведінка за некоректної конфігурації
openclaw backup навмисно оминає звичайну попередню перевірку конфігурації, щоб залишатися корисним під час відновлення. Оскільки виявлення робочого простору залежить від коректної конфігурації, openclaw backup create тепер завершується з помилкою одразу, якщо файл конфігурації існує, але є некоректним, а резервне копіювання робочого простору все ще ввімкнене.
Якщо ви все одно хочете часткову резервну копію в такій ситуації, запустіть знову:
--only-config також працює, коли конфігурація має помилки, оскільки не покладається на розбір конфігурації для виявлення робочого простору.
Розмір і продуктивність
OpenClaw не застосовує вбудоване максимальне обмеження розміру резервної копії або обмеження розміру окремого файла. Практичні обмеження залежать від локальної машини та цільової файлової системи:- Доступний простір для тимчасового запису архіву та для фінального архіву
- Час на обхід великих дерев робочих просторів і їх стиснення в
.tar.gz - Час на повторне сканування архіву, якщо ви використовуєте
openclaw backup create --verifyабо запускаєтеopenclaw backup verify - Поведінка файлової системи в цільовому шляху. OpenClaw надає перевагу кроку публікації через hard link без перезапису й повертається до ексклюзивного копіювання, якщо hard links не підтримуються
--no-include-workspace.
Для найменшого архіву використовуйте --only-config.