> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Миграция с Hermes

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

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

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

<Tabs>
  <Tab title="Мастер первичной настройки">
    Самый быстрый путь. Мастер обнаруживает Hermes в `~/.hermes` и показывает предварительный просмотр перед применением.

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw onboard --flow import
    ```

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

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw onboard --import-from hermes --import-source ~/.hermes
    ```
  </Tab>

  <Tab title="CLI">
    Используйте `openclaw migrate` для скриптовых или повторяемых запусков. Полный справочник см. в [`openclaw migrate`](/ru/cli/migrate).

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw migrate hermes --dry-run    # preview only
    openclaw migrate apply hermes --yes  # apply with confirmation skipped
    ```

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

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

<AccordionGroup>
  <Accordion title="Конфигурация модели">
    * Выбор модели по умолчанию из Hermes `config.yaml`.
    * Настроенные поставщики моделей и пользовательские OpenAI-совместимые конечные точки из `providers` и `custom_providers`.
  </Accordion>

  <Accordion title="Серверы MCP">
    Определения серверов MCP из `mcp_servers` или `mcp.servers`.
  </Accordion>

  <Accordion title="Файлы рабочей области">
    * `SOUL.md` и `AGENTS.md` копируются в рабочую область агента OpenClaw.
    * `memories/MEMORY.md` и `memories/USER.md` **добавляются** в соответствующие файлы памяти OpenClaw вместо их перезаписи.
  </Accordion>

  <Accordion title="Конфигурация памяти">
    Значения по умолчанию конфигурации памяти для файловой памяти OpenClaw. Внешние поставщики памяти, такие как Honcho, записываются как архивные элементы или элементы для ручной проверки, чтобы вы могли перенести их осознанно.
  </Accordion>

  <Accordion title="Skills">
    Skills с файлом `SKILL.md` в `skills/<name>/` копируются вместе со значениями конфигурации отдельных Skills из `skills.config`.
  </Accordion>

  <Accordion title="Учетные данные авторизации">
    Интерактивный `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` в первичной настройке при импорте из мастера первичной настройки.
  </Accordion>
</AccordionGroup>

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

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

* `plugins/`
* `sessions/`
* `logs/`
* `cron/`
* `mcp-tokens/`
* `state.db`

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

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

<Steps>
  <Step title="Предварительно просмотрите план">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw migrate hermes --dry-run
    ```

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

  <Step title="Примените с резервной копией">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw migrate apply hermes --yes
    ```

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

  <Step title="Запустите doctor">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw doctor
    ```

    [Doctor](/ru/gateway/doctor) повторно применяет все ожидающие миграции конфигурации и проверяет наличие проблем, появившихся во время импорта.
  </Step>

  <Step title="Перезапустите и проверьте">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw gateway restart
    openclaw status
    ```

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

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

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

<Warning>
  Повторно запускайте с `--overwrite` только тогда, когда замена существующей цели является намеренной. Поставщики все равно могут записывать резервные копии на уровне элементов для перезаписанных файлов в каталоге отчета миграции.
</Warning>

Для новой установки 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 theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw migrate hermes --dry-run --json
openclaw migrate apply hermes --json --yes
```

С `--json` и без `--yes` применение печатает план и не изменяет состояние. Это самый безопасный режим для CI и общих скриптов.

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

<AccordionGroup>
  <Accordion title="Применение отказывается выполняться из-за конфликтов">
    Изучите вывод плана. Каждый конфликт указывает путь источника и существующую цель. Для каждого элемента решите, нужно ли пропустить его, отредактировать цель или повторно запустить с `--overwrite`.
  </Accordion>

  <Accordion title="Hermes находится вне ~/.hermes">
    Передайте `--from /actual/path` (CLI) или `--import-source /actual/path` (первичная настройка).
  </Accordion>

  <Accordion title="Первичная настройка отказывается импортировать в существующей настройке">
    Для импорта через первичную настройку требуется новая настройка. Либо сбросьте состояние и повторно выполните первичную настройку, либо используйте `openclaw migrate apply hermes` напрямую; он поддерживает `--overwrite` и явное управление резервными копиями.
  </Accordion>

  <Accordion title="API-ключи не импортировались">
    Интерактивный `openclaw migrate` импортирует API-ключи только если вы принимаете запрос учетных данных. Неинтерактивные запуски с `--yes` требуют `--include-secrets`; импорты через первичную настройку требуют `--import-secrets`. Распознаются только [поддерживаемые ключи `.env`](/ru/cli/migrate#supported-env-keys); другие переменные в `.env` игнорируются.
  </Accordion>
</AccordionGroup>

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

* [`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` и файлы памяти.