--- read_when: - Вы переходите с Hermes и хотите сохранить конфигурацию модели, промпты, память и Skills - Вы хотите знать, что OpenClaw импортирует автоматически, а что остается только в архиве - Вам нужен чистый, скриптованный путь миграции (CI, новый ноутбук, автоматизация) summary: Перейдите с Hermes на OpenClaw с импортом, который можно предварительно просмотреть и откатить title: Миграция с Hermes x-i18n: generated_at: "2026-06-28T23:07:41Z" model: gpt-5.5 postprocess_version: locale-links-v1 provider: openai source_hash: 4f2a2bfea4fd276e3392261e8ecea09d147424636efb200ced1deb86ac0161b5 source_path: install/migrating-hermes.md workflow: 16 --- OpenClaw импортирует состояние Hermes через встроенный поставщик миграции. Поставщик показывает предварительный просмотр всего перед изменением состояния, редактирует секреты в планах и отчетах и создает проверенную резервную копию перед применением. Для импорта требуется новая настройка OpenClaw. Если у вас уже есть локальное состояние OpenClaw, сначала сбросьте конфигурацию, учетные данные, сеансы и рабочую область либо используйте `openclaw migrate` напрямую с `--overwrite` после проверки плана. ## Два способа импорта Самый быстрый путь. Мастер обнаруживает Hermes в `~/.hermes` и показывает предварительный просмотр перед применением. ```bash openclaw onboard --flow import ``` Или укажите конкретный источник: ```bash openclaw onboard --import-from hermes --import-source ~/.hermes ``` Используйте `openclaw migrate` для скриптовых или повторяемых запусков. Полный справочник см. в [`openclaw migrate`](/ru/cli/migrate). ```bash openclaw migrate hermes --dry-run # preview only openclaw migrate apply hermes --yes # apply with confirmation skipped ``` Добавьте `--from `, если 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//` копируются вместе со значениями конфигурации отдельных Skills из `skills.config`. Интерактивный `openclaw migrate` спрашивает перед импортом учетных данных авторизации, при этом по умолчанию выбран ответ «да». Поддерживаемые импорты включают учетные данные OpenCode OpenAI OAuth из OpenCode `auth.json`, записи OpenCode и GitHub Copilot из OpenCode `auth.json`, а также [поддерживаемые ключи `.env`](/ru/cli/migrate#supported-env-keys). Записи 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`, чтобы включить поддерживаемые учетные данные в автоматических запусках. ```bash openclaw doctor ``` [Doctor](/ru/gateway/doctor) повторно применяет все ожидающие миграции конфигурации и проверяет наличие проблем, появившихся во время импорта. ```bash 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`](/ru/cli/migrate#supported-env-keys). Записи OAuth Hermes `auth.json` выводятся для ручной повторной авторизации OpenAI или исправления doctor. - Используйте `--no-auth-credentials` или выберите «нет» в запросе, чтобы импортировать только несекретное состояние. - Используйте `--include-secrets` при автоматическом запуске с `--yes`. - Используйте `--import-secrets` в первичной настройке при импорте учетных данных из мастера первичной настройки. - Для учетных данных, управляемых SecretRef, настройте источник SecretRef после завершения импорта. ## JSON-вывод для автоматизации ```bash 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`](/ru/cli/migrate#supported-env-keys); другие переменные в `.env` игнорируются. ## Связанные материалы - [`openclaw migrate`](/ru/cli/migrate): полный справочник CLI, контракт Plugin и JSON-формы. - [Первичная настройка](/ru/cli/onboard): поток мастера и неинтерактивные флаги. - [Миграция](/ru/install/migrating): перенос установки OpenClaw между машинами. - [Doctor](/ru/gateway/doctor): проверка состояния после миграции. - [Рабочая область агента](/ru/concepts/agent-workspace): где находятся `SOUL.md`, `AGENTS.md` и файлы памяти.