Skip to main content
Встроенный провайдер миграции Hermes обнаруживает состояние в ~/.hermes, показывает предварительный просмотр каждого изменения перед применением, скрывает секреты в планах и отчётах и создаёт проверенную резервную копию OpenClaw, прежде чем что-либо изменить.
Для импорта требуется чистая установка OpenClaw. Если у вас уже есть локальное состояние OpenClaw, сначала сбросьте конфигурацию, учётные данные, сеансы и рабочее пространство либо используйте openclaw migrate apply hermes напрямую с --overwrite после проверки плана.

​
Два способа импорта

Обнаруживает Hermes в ~/.hermes и показывает предварительный просмотр перед применением.
Или укажите конкретный источник:

​
Что импортируется

  • Выбор модели по умолчанию из файла Hermes config.yaml.
  • Настроенные провайдеры моделей и пользовательские конечные точки, совместимые с OpenAI, из providers и custom_providers.
Определения серверов MCP из mcp_servers или mcp.servers.
  • SOUL.md и AGENTS.md копируются в рабочее пространство агента OpenClaw.
  • memories/MEMORY.md и memories/USER.md добавляются в соответствующие файлы памяти OpenClaw вместо их перезаписи.
Значения конфигурации по умолчанию для файловой памяти OpenClaw. Внешние провайдеры памяти, такие как Honcho, записываются как элементы архива или элементы для ручной проверки, чтобы вы могли перенести их осознанно.
Skills с файлом SKILL.md в каталоге skills/<name>/ копируются вместе со значениями конфигурации каждого Skills из skills.config.
Интерактивный запуск openclaw migrate запрашивает подтверждение перед импортом учётных данных аутентификации, при этом по умолчанию выбран ответ «да». При согласии импортируются записи OpenCode OpenAI OAuth и GitHub Copilot из файла OpenCode auth.json, а также поддерживаемые ключи .env Hermes. Собственные записи OAuth из файла Hermes auth.json являются устаревшим состоянием: вместо импорта в действующую систему аутентификации они отображаются как элементы, требующие повторной аутентификации вручную или запуска doctor. Используйте --include-secrets для импорта учётных данных при неинтерактивном запуске, --no-auth-credentials для полного пропуска импорта учётных данных или флаг мастера первоначальной настройки --import-secrets.

​
Что остаётся только в архиве

Провайдер копирует перечисленные ниже элементы в каталог отчёта о миграции для ручной проверки, но не загружает их в действующую конфигурацию или учётные данные OpenClaw:
  • plugins/
  • sessions/
  • logs/
  • cron/
  • mcp-tokens/
  • state.db
OpenClaw отказывается автоматически выполнять это состояние или считать его доверенным, поскольку форматы и предположения о доверии могут различаться между системами. После проверки архива перенесите нужные элементы вручную.

​
Рекомендуемый порядок действий

1

Предварительный просмотр плана

В плане перечислены все предстоящие изменения, включая конфликты, пропущенные и конфиденциальные элементы. Вложенные ключи, похожие на секреты, скрываются в выводе.
2

Применение с резервным копированием

Перед применением OpenClaw создаёт и проверяет резервную копию. Этот неинтерактивный пример импортирует только несекретное состояние. Запустите команду без --yes, чтобы ответить на запрос об учётных данных в интерактивном режиме, или добавьте --include-secrets, чтобы включить поддерживаемые учётные данные в автоматический запуск.
3

Запуск doctor

Doctor повторно применяет все ожидающие миграции конфигурации и проверяет наличие проблем, возникших во время импорта.
4

Перезапуск и проверка

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

​
Обработка конфликтов

Применение прерывается, если план сообщает о конфликтах — когда файл или значение конфигурации уже существует в целевом расположении.
Повторно запускайте команду с --overwrite только в том случае, если существующий целевой элемент необходимо заменить намеренно. Провайдеры всё равно могут создавать резервные копии отдельных перезаписываемых файлов в каталоге отчёта о миграции.
При чистой установке конфликты возникают редко. Обычно они появляются при повторном импорте в установку, уже содержащую пользовательские изменения. Если конфликт возникает в процессе применения, например из-за неожиданной гонки при работе с файлом конфигурации, Hermes помечает оставшиеся зависимые элементы конфигурации как skipped с причиной blocked by earlier apply conflict, не записывая их частично. В отчёте о миграции фиксируется каждый заблокированный элемент, чтобы вы могли устранить исходный конфликт и повторить импорт.

​
Секреты

Интерактивный запуск openclaw migrate спрашивает, следует ли импортировать обнаруженные учётные данные аутентификации, при этом по умолчанию выбран ответ «да».
  • При согласии импортируются записи OpenCode OpenAI OAuth и GitHub Copilot из файла OpenCode auth.json, а также поддерживаемые ключи .env. Собственные записи OAuth из файла Hermes auth.json вместо этого включаются в отчёт как требующие ручной повторной аутентификации OpenAI или исправления с помощью doctor.
  • Используйте --no-auth-credentials или ответьте «нет» на запрос, чтобы импортировать только несекретное состояние.
  • Используйте --include-secrets, чтобы импортировать учётные данные при автоматическом запуске с --yes.
  • Используйте флаг мастера первоначальной настройки --import-secrets, чтобы импортировать учётные данные через мастер.

​
Вывод JSON для автоматизации

При использовании --json без --yes команда применения выводит план и не изменяет состояние — это самый безопасный режим для CI и общих скриптов.

​
Устранение неполадок

Изучите вывод плана. Для каждого конфликта указаны исходный путь и существующий целевой элемент. Для каждого элемента решите, следует ли его пропустить, изменить целевой элемент или повторить запуск с --overwrite.
Передайте --from /actual/path для CLI или --import-source /actual/path для первоначальной настройки.
Для импорта через первоначальную настройку требуется чистая установка. Сбросьте состояние и повторите первоначальную настройку либо используйте openclaw migrate apply hermes напрямую: эта команда поддерживает --overwrite и явное управление резервным копированием.
Интерактивный запуск openclaw migrate импортирует ключи API, только если вы согласитесь на импорт учётных данных. Для неинтерактивных запусков с --yes требуется --include-secrets, а для импорта через первоначальную настройку — --import-secrets. Распознаются только поддерживаемые ключи .env, остальные переменные .env игнорируются.

​
Связанные разделы