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

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

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

Migrating from Claude

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

Migrating from Hermes

Импортируйте конфигурацию Hermes, поставщиков, MCP-серверы, память, skills и поддерживаемые ключи .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, skills и промпты.
Запустите openclaw status на старом компьютере, чтобы подтвердить путь к каталогу состояния. Пользовательские профили используют ~/.openclaw-<profile>/ или путь, заданный через OPENCLAW_STATE_DIR.

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

1

Stop the gateway and back up

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

Install OpenClaw on the new machine

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

Copy state directory and workspace

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

Run doctor and verify

На новом компьютере запустите Doctor, чтобы применить миграции конфигурации и восстановить службы:
openclaw doctor
openclaw gateway restart
openclaw status
Если Telegram или Discord использует резервный вариант env по умолчанию (TELEGRAM_BOT_TOKEN или DISCORD_BOT_TOKEN), проверьте, что перенесенный .env в каталоге состояния содержит эти ключи, не выводя значения секретов: 
awk -F= '/^(TELEGRAM_BOT_TOKEN|DISCORD_BOT_TOKEN)=/ { print $1 "=present" }' ~/.openclaw/.env
openclaw doctor также предупреждает, когда у включенной учетной записи Telegram или Discord по умолчанию нет настроенного токена, а соответствующая переменная env недоступна процессу doctor.

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

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

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

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

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

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

​
Связанное