OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Maintenance

Миграция с Hermes

Встроенный провайдер миграции Hermes обнаруживает состояние в ~/.hermes, показывает предварительный просмотр каждого изменения перед применением, скрывает секреты в планах и отчётах и создаёт проверенную резервную копию OpenClaw, прежде чем что-либо изменить.

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

Мастер первоначальной настройки

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

bash
openclaw onboard --flow import

Или укажите конкретный источник:

bash
openclaw onboard --import-from hermes --import-source ~/.hermes

CLI

Используйте openclaw migrate для автоматизированных или повторяемых запусков. Полное справочное руководство см. в разделе openclaw migrate.

bash
openclaw migrate hermes --dry-run    # только предварительный просмотрopenclaw migrate apply hermes --yes  # применить без запроса подтверждения

Добавьте --from <path>, если Hermes находится не в ~/.hermes.

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

Конфигурация модели
  • Выбор модели по умолчанию из файла Hermes config.yaml.
  • Настроенные провайдеры моделей и пользовательские конечные точки, совместимые с OpenAI, из providers и custom_providers.
Серверы MCP

Определения серверов MCP из mcp_servers или mcp.servers.

Файлы рабочего пространства
  • SOUL.md и AGENTS.md копируются в рабочее пространство агента OpenClaw.
  • memories/MEMORY.md и memories/USER.md добавляются в соответствующие файлы памяти OpenClaw вместо их перезаписи.
Конфигурация памяти

Значения конфигурации по умолчанию для файловой памяти OpenClaw. Внешние провайдеры памяти, такие как Honcho, записываются как элементы архива или элементы для ручной проверки, чтобы вы могли перенести их осознанно.

Skills

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 отказывается автоматически выполнять это состояние или считать его доверенным, поскольку форматы и предположения о доверии могут различаться между системами. После проверки архива перенесите нужные элементы вручную.

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

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

    bash
    openclaw migrate hermes --dry-run

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

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

    bash
    openclaw migrate apply hermes --yes

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

  • Запуск doctor

    bash
    openclaw doctor

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

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

    bash
    openclaw gateway restartopenclaw status

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

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

    Применение прерывается, если план сообщает о конфликтах — когда файл или значение конфигурации уже существует в целевом расположении.

    При чистой установке конфликты возникают редко. Обычно они появляются при повторном импорте в установку, уже содержащую пользовательские изменения.

    Если конфликт возникает в процессе применения, например из-за неожиданной гонки при работе с файлом конфигурации, 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 для автоматизации

    bash
    openclaw migrate hermes --dry-run --jsonopenclaw migrate apply hermes --json --yes

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

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

    Применение прерывается из-за конфликтов

    Изучите вывод плана. Для каждого конфликта указаны исходный путь и существующий целевой элемент. Для каждого элемента решите, следует ли его пропустить, изменить целевой элемент или повторить запуск с --overwrite.

    Hermes находится не в ~/.hermes

    Передайте --from /actual/path для CLI или --import-source /actual/path для первоначальной настройки.

    Первоначальная настройка отказывается импортировать в существующую установку

    Для импорта через первоначальную настройку требуется чистая установка. Сбросьте состояние и повторите первоначальную настройку либо используйте openclaw migrate apply hermes напрямую: эта команда поддерживает --overwrite и явное управление резервным копированием.

    Ключи API не импортировались

    Интерактивный запуск openclaw migrate импортирует ключи API, только если вы согласитесь на импорт учётных данных. Для неинтерактивных запусков с --yes требуется --include-secrets, а для импорта через первоначальную настройку — --import-secrets. Распознаются только поддерживаемые ключи .env, остальные переменные .env игнорируются.

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

    Was this useful?
    On this page

    On this page