openclaw backup
Створіть локальний архів резервної копії для стану OpenClaw, конфігурації, профілів автентифікації, облікових даних каналів/провайдерів, сеансів і, за потреби, робочих просторів.
Примітки
- Архів містить файл
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, ротаційні журнали, черги доставки, файли сокетів/pid/тимчасові файли в каталозі стану та пов’язані тимчасові файли довготривалих черг. JSON-результат містить skippedVolatileCount, щоб автоматизація могла бачити, скільки файлів було навмисно пропущено.
Встановлені вихідні файли Plugin і файли маніфестів у дереві
extensions/ каталогу стану включаються, але їхні вкладені дерева залежностей
node_modules/ пропускаються. Ці залежності є відтворюваними артефактами встановлення; після
відновлення архіву використайте openclaw plugins update <id> або перевстановіть Plugin
за допомогою openclaw plugins install <spec> --force, коли відновлений Plugin повідомляє
про відсутні залежності.
Поведінка за недійсної конфігурації
openclaw backup навмисно обходить звичайну попередню перевірку конфігурації, щоб усе одно допомагати під час відновлення. Оскільки виявлення робочих просторів залежить від дійсної конфігурації, openclaw backup create тепер швидко завершується з помилкою, коли файл конфігурації існує, але є недійсним, а резервне копіювання робочих просторів усе ще ввімкнене.
Якщо в цій ситуації ви все одно хочете часткову резервну копію, запустіть повторно:
--only-config також працює, коли конфігурація має неправильний формат, оскільки він не покладається на розбір конфігурації для виявлення робочих просторів.
Розмір і продуктивність
OpenClaw не застосовує вбудований максимальний розмір резервної копії або обмеження розміру окремого файлу. Практичні обмеження походять від локального комп’ютера та файлової системи призначення:- Доступний простір для тимчасового запису архіву плюс фінальний архів
- Час на обхід великих дерев робочих просторів і стиснення їх у
.tar.gz - Час на повторне сканування архіву, якщо ви використовуєте
openclaw backup create --verifyабо запускаєтеopenclaw backup verify - Поведінка файлової системи за шляхом призначення. OpenClaw надає перевагу кроку публікації через жорстке посилання без перезапису та переходить до ексклюзивного копіювання, коли жорсткі посилання не підтримуються
--no-include-workspace.
Для найменшого архіву використовуйте --only-config.