OpenClaw backup и восстановление: как не потерять память и настройки агента

Обновлено 
OpenClaw backup и восстановление: как не потерять память и настройки агента

OpenClaw backup и восстановление: как не потерять память и настройки агента

OpenClaw backup и восстановление: как не потерять память и настройки агента

OpenClaw хранит все важные данные в двух ключевых местах: директории состояния (конфигурация, авторизация, сессии) и рабочих директориях (память, навыки, персоны). Создание резервных копий обеих частей, плюс файлов .env и внешних баз данных, позволяет полностью восстановить агента на новой машине или после сбоя системы.

Где OpenClaw хранит конфигурацию, память и навыки

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

Директория состояния (конфигурация, авторизация, сессии)

Это основное хранилище данных, которое позволяет агенту "вернуться к жизни" после восстановления. Типичные расположения по умолчанию:

  • Linux/macOS: ~/.openclaw/
  • Windows: C:\Users\<User>\.openclaw
  • Старые установки: ~/.clawdbot или C:\Users\<User>\.clawdbot

Основное содержимое директории включает:

  • openclaw.json или clawdbot.json - основной файл конфигурации с настройками провайдеров, каналов, поведения и выбора моделей
  • auth/ - директория с учетными данными, OAuth токенами и API ключами
  • sessions/ - история разговоров и состояние каналов (WhatsApp, Telegram, Discord)
  • hooks/ - пользовательские триггеры событий
  • cron/ - запланированные задачи
  • .bak.* - резервные копии конфигурации (содержат секреты)

Эта директория содержит конфиденциальную информацию и должна рассматриваться как секретная. Особое внимание следует уделить настройке Telegram агента, поскольку токены авторизации хранятся именно здесь.

Рабочая директория (память, навыки, персоны)

Рабочее пространство - это место, где живет "мозг и личность" вашего агента. Типичные расположения:

  • Linux/macOS (2025-2026): ~/.openclaw/workspace
  • Пользовательское: может быть настроено в конфигурации OpenClaw через параметр agent.workspace

Ключевые файлы рабочей директории:

  • MEMORY.md - накопленные знания и предпочтения, изученные со временем
  • AGENTS.md - определения агентов и конфигурации ролей
  • SOUL.md - правила персоны и поведенческие руководства
  • USER.md - профиль пользователя и данные предпочтений
  • TOOLS.md - конфигурации инструментов и разрешения
  • skills/ - пользовательские навыки, созданные или установленные

Потеря файла MEMORY.md эквивалентна "начинанию с нуля" и является наиболее критичной потерей данных. Подробнее о работе с памятью агента можно узнать в руководстве по настройке памяти AI агента.

Обязательные элементы для резервного копирования

Для полного восстановления среды OpenClaw необходимо создать резервные копии следующих компонентов:

  1. Полная директория состояния (~/.openclaw/ или эквиваленты Windows)
  2. Полная рабочая директория: все файлы .md и папка skills/
  3. Файлы .env с секретами и конфигурацией
  4. Папки медиафайлов при сохранении вложений на диск
  5. Локальные файлы БД при использовании SQLite или других локальных баз

Особое внимание следует уделить созданным навыкам, поскольку их восстановление может потребовать дополнительных действий. Рекомендуется ознакомиться с пошаговым руководством по созданию навыков для лучшего понимания их структуры.

Использование встроенных инструментов резервного копирования

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

Команда openclaw backup create

Современные версии OpenClaw включают единую команду резервного копирования:

openclaw backup create

Эта команда создает архив .tar.gz с временной меткой, содержащий:

  • Директорию состояния с конфигурацией, заданиями cron, сессиями и логами
  • Активный файл конфигурации явно
  • Директорию учетных данных с токенами и ключами API
  • Рабочие директории, автоматически обнаруженные из конфигурации

Для проверки целостности резервной копии используйте:

openclaw backup create --verify

Команды openclaw backup и restore

Новые версии 2026 года предоставляют упрощенный интерфейс:

openclaw backup

Для восстановления используйте:

openclaw restore /path/to/openclaw-backup-YYYYMMDD-HHMM.tar.gz

Рекомендуется хранить архивы в зашифрованном виде вне основной машины с использованием инструментов типа gpg или age.

Ручное создание резервных копий

При необходимости интеграции с существующими системами резервного копирования или использования собственных инструментов, можно создавать резервные копии директорий напрямую.

Пример скрипта для Linux серверов

#!/bin/bash
BACKUP_DIR="/opt/backups/openclaw"
TIMESTAMP=$(date +%Y%m%d_%H%M%S)
BACKUP_FILE="${BACKUP_DIR}/openclaw_backup_${TIMESTAMP}.tar.gz"

mkdir -p "$BACKUP_DIR"

tar -czf "$BACKUP_FILE" \
  "$HOME/.openclaw" \
  /opt/openclaw/.env \
  2>/dev/null

При использовании облачных сервисов рекомендуется также создавать снимки дисков в дополнение к файловым резервным копиям. Это особенно актуально при развертывании через reverse proxy на VPS.

Автоматизация через cron

Для регулярного создания резервных копий добавьте задачу в crontab:

0 3 * * * /path/to/backup_script.sh

Это обеспечит ежедневное создание резервных копий в 3:00 утра.

Пошаговое восстановление из резервной копии

Полное восстановление на новую машину

Запустите OpenClaw:

openclaw gateway start

Проверьте права доступа:

chmod 600 ~/.openclaw/auth/*
chmod 700 ~/.openclaw/

Восстановите файл .env:

cp /path/to/backup/.env /opt/openclaw/.env

Расшифруйте и извлеките архив:

age -d -o /tmp/openclaw-restore.tar.gz ~/backups/openclaw-backup.tar.gz.age
tar -xzf /tmp/openclaw-restore.tar.gz -C "$HOME"

Остановите шлюз перед восстановлением:

openclaw gateway stop

Установите OpenClaw на новой машине:

git clone https://github.com/openclaw/openclaw.git
cd openclaw
./scripts/setup.sh

Частичное восстановление

При необходимости восстановления только определенных компонентов:

  • Только память: скопируйте MEMORY.md и связанные файлы
  • Только навыки: восстановите директорию skills/
  • Только конфигурацию: замените openclaw.json

После частичного восстановления перезапустите агента для применения изменений.

Проверка успешного восстановления

Для проверки корректности восстановления выполните следующие действия:

  1. Проверьте статус агента: openclaw status
  2. Убедитесь в наличии памяти через тестовый диалог
  3. Проверьте работу всех настроенных каналов связи
  4. Протестируйте пользовательские навыки

При сравнении различных решений полезно ознакомиться с сравнением OpenClaw и Hermes Agent для понимания особенностей архитектуры.

Часто задаваемые вопросы

Как часто нужно создавать резервные копии?

Рекомендуется ежедневное создание резервных копий для активно используемых агентов. Для критически важных применений - каждые 6-12 часов.

Можно ли восстановить агента на другой операционной системе?

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

Что делать если потеряна только память агента?

Восстановите файл MEMORY.md из резервной копии в рабочую директорию и перезапустите агента. Остальная конфигурация может остаться неизменной.

Безопасно ли хранить резервные копии в облаке?

Только в зашифрованном виде, поскольку резервные копии содержат API ключи и токены доступа. Используйте надежные методы шифрования типа GPG или AES-256.

Как проверить целостность старых резервных копий?

Используйте команду tar -tzf backup.tar.gz для проверки архива или openclaw backup create --verify при создании новых копий.