Skip to main content
OpenClaw поддерживает три способа миграции: импорт из другой агентной системы, перенос существующей установки на новый компьютер и обновление плагина на месте.

​
Импорт из другой агентной системы

Встроенные провайдеры миграции переносят в OpenClaw инструкции, серверы MCP, навыки, конфигурацию моделей и, при явном согласии, ключи API. Перед внесением изменений отображается предварительный план, секреты в отчётах скрываются, а применение изменений сопровождается созданием проверенной резервной копии.

Миграция с Claude

Импортируйте состояние Claude Code и Claude Desktop, включая CLAUDE.md, серверы MCP, навыки и команды проектов.

Миграция с Hermes

Импортируйте конфигурацию Hermes, провайдеров, серверы MCP, память, навыки и поддерживаемые ключи .env.
Точка входа CLI — openclaw migrate. Первоначальная настройка также может предложить миграцию при обнаружении известного источника (openclaw onboard --flow import).

​
Перенос OpenClaw на новый компьютер

Скопируйте каталог состояния (по умолчанию ~/.openclaw/) и рабочее пространство, чтобы сохранить:
  • Конфигурацию — openclaw.json и все настройки Gateway.
  • Аутентификацию — отдельные для каждого агента auth-profiles.json (ключи API и OAuth), а также любое состояние каналов или провайдеров в credentials/.
  • Сеансы — историю разговоров и состояние агентов.
  • Состояние каналов — данные входа в WhatsApp, сеанс Telegram и аналогичные данные.
  • Файлы рабочего пространства — MEMORY.md, USER.md, навыки и промпты.
Выполните openclaw status на старом компьютере, чтобы уточнить путь к каталогу состояния. Пользовательские профили используют ~/.openclaw-<profile>/ или путь, заданный через OPENCLAW_STATE_DIR.

​
Этапы миграции

1

Остановите Gateway и создайте резервную копию

На старом компьютере остановите Gateway, чтобы файлы не изменялись во время копирования, затем создайте архив:
Если вы используете несколько профилей (например, ~/.openclaw-work), создайте отдельный архив для каждого из них.
2

Установите OpenClaw на новый компьютер

Установите CLI (и Node, если требуется) на новый компьютер. Ничего страшного, если первоначальная настройка создаст новый ~/.openclaw/ — на следующем этапе вы его перезапишете.
3

Скопируйте каталог состояния и рабочее пространство

Передайте архив через scp, rsync -a или на внешнем накопителе, затем распакуйте его:
Убедитесь, что скрытые каталоги были включены, а владельцем файлов является пользователь, от имени которого будет запускаться Gateway.
4

Запустите Doctor и выполните проверку

На новом компьютере запустите Doctor, чтобы применить миграции конфигурации и восстановить службы:
Если Telegram или Discord использует резервное значение из переменной среды по умолчанию (TELEGRAM_BOT_TOKEN или DISCORD_BOT_TOKEN), убедитесь, что файл .env в перенесённом каталоге состояния содержит эти ключи, не выводя значения секретов:
openclaw doctor также выводит предупреждение, если у включённой учётной записи Telegram или Discord по умолчанию не настроен токен, а соответствующая переменная среды недоступна процессу Doctor.

​
Распространённые ошибки

Если старый Gateway использовал --profile или OPENCLAW_STATE_DIR, а новый их не использует, каналы будут отображаться как вышедшие из системы, а сеансы окажутся пустыми. Запустите Gateway с тем же профилем или каталогом состояния, который вы перенесли, а затем повторно выполните openclaw doctor.
Одного файла конфигурации недостаточно. Профили аутентификации моделей хранятся в agents/<agentId>/agent/auth-profiles.json, а состояние каналов и провайдеров — в credentials/. Всегда переносите весь каталог состояния.
Если вы выполняли копирование от имени root или сменили пользователя, Gateway может не получить доступ к учётным данным. Убедитесь, что каталог состояния и рабочее пространство принадлежат пользователю, от имени которого запускается Gateway.
Если ваш интерфейс подключён к удалённому Gateway, сеансы и рабочее пространство принадлежат удалённому узлу. Перенесите сам узел Gateway, а не локальный ноутбук. См. часто задаваемые вопросы.
Каталог состояния содержит профили аутентификации, учётные данные каналов и другое состояние провайдеров. Храните резервные копии в зашифрованном виде, избегайте небезопасных каналов передачи и замените ключи, если подозреваете их раскрытие.

​
Контрольный список проверки

На новом компьютере убедитесь, что:
  • openclaw status показывает, что Gateway работает.
  • Каналы по-прежнему подключены (повторное сопряжение не требуется).
  • Панель управления открывается и показывает существующие сеансы.
  • Файлы рабочего пространства (память, конфигурации) присутствуют.

​
Обновление плагина на месте

При обновлении плагина на месте сохраняются его идентификатор и ключи конфигурации, но состояние на диске может быть перемещено в текущую структуру. Руководства по обновлению конкретных плагинов находятся рядом с документацией соответствующих каналов:
  • Миграция Matrix: ограничения восстановления зашифрованного состояния, поведение автоматических снимков состояния и команды ручного восстановления.

​
Связанные материалы