English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaishiالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiruفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

Maintenance

Миграция с Hermes

OpenClaw импортирует состояние Hermes через встроенный поставщик миграции. Поставщик показывает предварительный просмотр всего перед изменением состояния, редактирует секреты в планах и отчетах и создает проверенную резервную копию перед применением.

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

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

Самый быстрый путь. Мастер обнаруживает 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    # preview onlyopenclaw migrate apply hermes --yes  # apply with confirmation skipped

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

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

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

    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 загружены.

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

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

    Для новой установки 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-вывод для автоматизации

    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