Миграция OpenClaw

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

Что переносится

Папка ~/.openclaw/ содержит всё:

  • Конфигурацияopenclaw.json и все настройки Gateway
  • Авторизация — профили агентов с API-ключами и OAuth
  • Сессии — история разговоров
  • Состояние каналов — логин WhatsApp, сессия Telegram и другие
  • Рабочее пространствоMEMORY.md, USER.md, навыки, промпты
  • Кастомный профиль или state-dir

    Если вы использовали --profile или OPENCLAW_STATE_DIR, папка состояния будет в другом месте. Проверьте на старом сервере:

    openclaw status
    

    Кастомные профили хранятся в ~/.openclaw-/ или по пути из OPENCLAW_STATE_DIR. Мигрируйте каждый профиль отдельно.

    Шаги миграции

    1. Остановите Gateway и сделайте бэкап

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

    openclaw gateway stop
    cd ~
    tar -czf openclaw-state.tgz .openclaw
    

    Если используете несколько профилей — архивируйте каждый отдельно.

    2. Установите OpenClaw на новом сервере

    Установите CLI и Node.js на новом сервере. Онбординг создаст новую папку ~/.openclaw/ — это нормально, вы её перезапишете.

    3. Скопируйте папку состояния

    Перенесите архив через scp, rsync или флешку:

    cd ~
    tar -xzf openclaw-state.tgz
    

    Убедитесь, что скрытые папки включены, и права доступа соответствуют пользователю, от которого запускается Gateway.

    4. Запустите и проверьте

    openclaw doctor
    openclaw gateway restart
    openclaw status
    

    Каналы обновлений

    OpenClaw имеет три канала обновлений:

    Канал Описание Для кого
    **stable** npm dist-tag `latest` Большинство пользователей
    **beta** npm dist-tag `beta` Тестирование новых функций
    **dev** Ветка `main` в git Разработчики

    Переключение канала

    openclaw update --channel stable
    openclaw update --channel beta
    openclaw update --channel dev
    

    --channel сохраняет выбор в конфиг (update.channel).

    Установка конкретной версии

    openclaw update --tag 2026.4.1-beta.1
    openclaw update --tag beta
    

    --tag не сохраняется — следующий openclaw update использует настроенный канал.

    Предпросмотр обновления

    openclaw update --dry-run
    openclaw update --channel beta --dry-run
    

    Показывает, что именно произойдёт при обновлении, без реальных изменений.

    Проверка текущего канала

    openclaw update status
    

    Показывает активный канал, тип установки (git/npm), текущую версию и источник.

    Частые ошибки

    Забыли скопировать credentials/ — одних настроек openclaw.json недостаточно. Профили авторизации лежат в agents//agent/auth-profiles.json, состояние каналов — в credentials/. Всегда копируйте всю папку ~/.openclaw/.

    Неправильные права доступа — если копировали от root, Gateway не сможет прочитать credentials. Убедитесь, что владелец папки — тот же пользователь, от которого запускается Gateway.

    Разные профили — если старый Gateway использовал --profile или OPENCLAW_STATE_DIR, а новый нет, каналы покажутся разлогиненными. Запускайте с тем же профилем.

    Бэкапы содержат секреты — в папке ~/.openclaw/ есть API-ключи и credentials. Храните бэкапы в зашифрованном виде и при подозрении на утечку — ротируйте ключи.

    Чек-лист после миграции

  • openclaw status показывает работающий Gateway
  • Каналы подключены (не нужно заново сканировать QR)
  • Dashboard открывается и показывает существующие сессии
  • Файлы рабочего пространства на месте
  • Что дальше

  • Установка OpenClaw — если нужно установить на новом сервере
  • Установка на VPS — для серверных развёртываний