Перейти к основному содержанию
OpenClaw импортирует состояние Hermes через встроенный поставщик миграции. Поставщик показывает предварительный просмотр всего перед изменением состояния, редактирует секреты в планах и отчетах и создает проверенную резервную копию перед применением.
Для импорта требуется новая настройка OpenClaw. Если у вас уже есть локальное состояние OpenClaw, сначала сбросьте конфигурацию, учетные данные, сеансы и рабочую область либо используйте openclaw migrate напрямую с --overwrite после проверки плана.

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

Самый быстрый путь. Мастер обнаруживает Hermes в ~/.hermes и показывает предварительный просмотр перед применением.
openclaw onboard --flow import
Или укажите конкретный источник:
openclaw onboard --import-from hermes --import-source ~/.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 из OpenCode auth.json, записи OpenCode и GitHub Copilot из OpenCode auth.json, а также поддерживаемые ключи .env. Записи OAuth Hermes auth.json являются устаревшим состоянием и отображаются как задачи ручной повторной авторизации или doctor вместо импорта в рабочую авторизацию. Используйте --include-secrets для неинтерактивного импорта учетных данных через openclaw migrate, --no-auth-credentials, чтобы пропустить его, или --import-secrets в первичной настройке при импорте из мастера первичной настройки.

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

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

​
Рекомендуемый порядок

1

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

openclaw migrate hermes --dry-run
План перечисляет все, что будет изменено, включая конфликты, пропущенные элементы и любые чувствительные элементы. Вывод плана редактирует вложенные ключи, похожие на секреты.
2

Примените с резервной копией

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

Запустите doctor

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

Перезапустите и проверьте

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

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

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

​
Секреты

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

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

openclaw migrate hermes --dry-run --json
openclaw migrate apply hermes --json --yes
С --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 игнорируются.

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