💾 OpenClaw — создание и восстановление бекапа

Полная инструкция: как создать бекап OpenClaw, проверить его и восстановить при сбое.

Что входит в бекап

openclaw backup create сохраняет:

• State-директория (~/.openclaw) — конфиги, агенты, сессии, cron-задачи
• Config-файл — активная JSON-конфигурация шлюза
• Credentials — профили авторизации, токены, пароли
• Workspace — папка workspace (AGENTS.md, MEMORY.md, SOUL.md, skills, скрипты)
• SQLite-базы — снапшот через VACUUM INTO (без live WAL/SHM)

Что не попадает в бекап:
- Логи cron, очереди доставки, temp-файлы
- node_modules плагинов (восстанавливаются переустановкой)
- Активные session-транскрипты (live-данные)

Шаг 1. Создание бекапа

Простой бекап

openclaw backup create

Создаст .tar.gz архив с таймстампом в текущей директории.

Бекап в отдельную папку

openclaw backup create --output ~/Backups

Бекап с проверкой

openclaw backup create --verify

Создаст архив и сразу проверит его целостность.

Только конфиг (минимальный бекап)

openclaw backup create --only-config

Без workspace (только state + config)

openclaw backup create --no-include-workspace

Превью (без записи)

openclaw backup create --dry-run --json

Покажет что попадёт в архив, без создания файла.

Шаг 2. Проверка бекапа

openclaw backup verify ./2026-07-18T11-30-00.000+03-00-openclaw-backup.tar.gz

Проверяет:
- Наличие manifest.json в архиве
- Отсутствие path-traversal в путях
- Все файлы из манифеста существуют в архиве

В JSON-формате:

openclaw backup verify ./backup.tar.gz --json

Шаг 3. Восстановление из бекапа

⚠️ OpenClaw не имеет команды openclaw restore. Восстановление — вручную распаковкой архива.

3.1. Остановить OpenClaw

openclaw gateway stop
# или
systemctl --user stop openclaw-gateway
# или если системный сервис
sudo systemctl stop openclaw-gateway

3.2. Сделать копию текущего state (на всякий случай)

cp -r ~/.openclaw ~/.openclaw.broken.$(date +%Y%m%d)

3.3. Распаковать бекап

# Посмотреть содержимое архива
tar tzf ./backup.tar.gz | head -30

# Распаковать в временную папку
mkdir -p /tmp/openclaw-restore
tar xzf ./backup.tar.gz -C /tmp/openclaw-restore

3.4. Посмотреть структуру

find /tmp/openclaw-restore -maxdepth 3 -type d

Структура обычно:

/tmp/openclaw-restore/
├── manifest.json
├── home/
│   └── dimon/
│       └── .openclaw/          ← state-директория
│           ├── config.json
│           ├── agents/
│           ├── credentials/
│           └── ...
│       └── .openclaw/workspace/  ← workspace

3.5. Восстановить state

# Удалить старый state (или переименовать)
mv ~/.openclaw ~/.openclaw.broken 2>/dev/null

# Скопировать из распакованного бекапа
cp -r /tmp/openclaw-restore/home/dimon/.openclaw ~/.openclaw

3.6. Восстановить workspace (если был в бекапе)

cp -r /tmp/openclaw-restore/home/dimon/.openclaw/workspace/* ~/.openclaw/workspace/

3.7. Исправить права

chown -R dimon:dimon ~/.openclaw
chmod 700 ~/.openclaw

3.8. Восстановить плагины

# Проверить какие плагины установлены
openclaw plugins list

# Переустановить если нужно
openclaw plugins install <plugin> --force
# или
openclaw plugins update <plugin>

3.9. Запустить OpenClaw

openclaw gateway start
# или
systemctl --user start openclaw-gateway
# или
sudo systemctl start openclaw-gateway

3.10. Проверить

openclaw status
openclaw gateway status

Шаг 4. Автоматические бекапы (cron)

Создание cron-задачи

sudo crontab -e

# Бекап OpenClaw каждый день в 06:00
0 6 * * * cd /home/dimon/Backups && openclaw backup create --verify >> /var/log/openclaw-backup.log 2>&1

Хранение последних 5 копий

sudo nano /usr/local/bin/openclaw-backup-cleanup.sh

#!/bin/bash
BACKUP_DIR="/home/dimon/Backups"
KEEP=5

cd "$BACKUP_DIR" || exit 1
ls -t *openclaw-backup.tar.gz 2>/dev/null | tail -n +$((KEEP + 1)) | xargs -r rm

sudo chmod +x /usr/local/bin/openclaw-backup-cleanup.sh

Добавить в cron:

0 6 * * * cd /home/dimon/Backups && openclaw backup create --verify && /usr/local/bin/openclaw-backup-cleanup.sh >> /var/log/openclaw-backup.log 2>&1

Шаг 5. Перенос на другой сервер

На старом сервере

openclaw backup create --output /tmp/
openclaw backup verify /tmp/*openclaw-backup.tar.gz

Передача

scp /tmp/*openclaw-backup.tar.gz user@new-server:/tmp/

На новом сервере

# Установить OpenClaw
curl -fsSL https://openclaw.ai/install.sh | bash

# Остановить шлюз
openclaw gateway stop

# Распаковать бекап
mkdir -p /tmp/openclaw-restore
tar xzf /tmp/*openclaw-backup.tar.gz -C /tmp/openclaw-restore

# Восстановить state
cp -r /tmp/openclaw-restore/home/*/".openclaw" ~/

# Исправить пути в конфиге если IP/порт изменились
nano ~/.openclaw/config.json

# Запустить
openclaw gateway start

⚠️ После переноса проверьте:
- Пути к workspace (могут отличаться)
- Telegram-токены (те же)
- Порт шлюза
- IP-адреса в конфигурации

Частые проблемы

"Config is invalid" при бекапе

openclaw backup create --no-include-workspace
# или
openclaw backup create --only-config

Бекап слишком большой

openclaw backup create --no-include-workspace

После восстановления плагины не работают

openclaw plugins list
openclaw plugins install <plugin> --force

После восстановления нет cron-задач

Cron-задачи хранятся в SQLite. Проверьте:

openclaw cron list

Если пусто — создайте заново (cron-задачи могли быть в skipped-файлах).

Полезные команды

Чеклист ✅

Создание

• [ ] Бекап создан (openclaw backup create --verify)
• [ ] Архив проверен (openclaw backup verify)
• [ ] Авто-бекап в cron настроен
• [ ] Очистка старых копий настроена

Восстановление

• [ ] OpenClaw остановлен
• [ ] Старый state сохранён (на всякий случай)
• [ ] Архив распакован
• [ ] State восстановлен
• [ ] Права исправлены
• [ ] Плагины переустановлены
• [ ] OpenClaw запущен
• [ ] Статус проверен

Последнее обновление: 2026-07-18