---
read_when:
    - Ви переходите з Hermes і хочете зберегти конфігурацію моделі, промпти, пам’ять і Skills
    - Ви хочете знати, що OpenClaw імпортує автоматично, а що залишається лише в архіві
    - Вам потрібен чистий, скриптований шлях міграції (CI, новий ноутбук, автоматизація)
summary: Перейдіть із Hermes на OpenClaw за допомогою імпорту з попереднім переглядом і можливістю скасування
title: Міграція з Hermes
x-i18n:
    generated_at: "2026-04-28T11:17:17Z"
    model: gpt-5.5
    provider: openai
    source_hash: 01f8a71e524b31c85864be63e54fc8a2057ecb06a73aac9e6fb107fc0c49757d
    source_path: install/migrating-hermes.md
    workflow: 16
---

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

<Note>
Імпорт потребує свіжого налаштування OpenClaw. Якщо у вас уже є локальний стан OpenClaw, спершу скиньте конфігурацію, облікові дані, сесії та робочу область або використайте `openclaw migrate` напряму з `--overwrite` після перегляду плану.
</Note>

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

<Tabs>
  <Tab title="Майстер початкового налаштування">
    Найшвидший шлях. Майстер виявляє Hermes у `~/.hermes` і показує попередній перегляд перед застосуванням.

    ```bash
    openclaw onboard --flow import
    ```

    Або вкажіть конкретне джерело:

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

  </Tab>
  <Tab title="CLI">
    Використовуйте `openclaw migrate` для скриптованих або повторюваних запусків. Див. [`openclaw migrate`](/uk/cli/migrate) для повної довідки.

    ```bash
    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>/` копіюються разом зі значеннями конфігурації для кожного Skill з `skills.config`.
  </Accordion>
  <Accordion title="API-ключі (за згодою)">
    Установіть `--include-secrets`, щоб імпортувати підтримувані ключі `.env`: `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, `OPENROUTER_API_KEY`, `GOOGLE_API_KEY`, `GEMINI_API_KEY`, `GROQ_API_KEY`, `XAI_API_KEY`, `MISTRAL_API_KEY`, `DEEPSEEK_API_KEY`. Без цього прапорця секрети ніколи не копіюються.
  </Accordion>
</AccordionGroup>

## Що залишається лише в архіві

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

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

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

## Рекомендований порядок

<Steps>
  <Step title="Перегляньте план">
    ```bash
    openclaw migrate hermes --dry-run
    ```

    План перелічує все, що зміниться, включно з конфліктами, пропущеними елементами та будь-якими чутливими елементами. Вивід плану редагує вкладені ключі, схожі на секрети.

  </Step>
  <Step title="Застосуйте з резервною копією">
    ```bash
    openclaw migrate apply hermes --yes
    ```

    OpenClaw створює й перевіряє резервну копію перед застосуванням. Якщо потрібно імпортувати API-ключі, додайте `--include-secrets`.

  </Step>
  <Step title="Запустіть doctor">
    ```bash
    openclaw doctor
    ```

    [Doctor](/uk/gateway/doctor) повторно застосовує будь-які очікувані міграції конфігурації та перевіряє проблеми, внесені під час імпорту.

  </Step>
  <Step title="Перезапустіть і перевірте">
    ```bash
    openclaw gateway restart
    openclaw status
    ```

    Переконайтеся, що Gateway працює справно, а імпортовані модель, пам’ять і Skills завантажені.

  </Step>
</Steps>

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

Застосування відмовляється продовжувати, коли план повідомляє про конфлікти (файл або значення конфігурації вже існує в цільовому місці).

<Warning>
Повторно запускайте з `--overwrite` лише тоді, коли заміна наявної цілі є навмисною. Провайдери все одно можуть записувати резервні копії на рівні елементів для перезаписаних файлів у директорії звіту міграції.
</Warning>

Для свіжого встановлення OpenClaw конфлікти незвичні. Зазвичай вони з’являються, коли ви повторно запускаєте імпорт у налаштуванні, де вже є правки користувача.

Якщо конфлікт виникає посеред застосування (наприклад, неочікувана гонка за файл конфігурації), Hermes позначає решту залежних елементів конфігурації як `skipped` із причиною `blocked by earlier apply conflict` замість часткового запису. Звіт міграції фіксує кожен заблокований елемент, щоб ви могли розв’язати початковий конфлікт і повторно запустити імпорт.

## Секрети

Секрети ніколи не імпортуються за замовчуванням.

- Спершу запустіть `openclaw migrate apply hermes --yes`, щоб імпортувати стан без секретів.
- Якщо ви також хочете скопіювати підтримувані ключі `.env`, повторно запустіть із `--include-secrets`.
- Для облікових даних, керованих SecretRef, налаштуйте джерело SecretRef після завершення імпорту.

## JSON-вивід для автоматизації

```bash
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-ключі не імпортувалися">
    Потрібен `--include-secrets`, і розпізнаються лише перелічені вище ключі. Інші змінні в `.env` ігноруються.
  </Accordion>
</AccordionGroup>

## Пов’язане

- [`openclaw migrate`](/uk/cli/migrate): повна довідка CLI, контракт Plugin і форми JSON.
- [Початкове налаштування](/uk/cli/onboard): потік майстра та неінтерактивні прапорці.
- [Міграція](/uk/install/migrating): перенесення встановлення OpenClaw між машинами.
- [Doctor](/uk/gateway/doctor): перевірка стану після міграції.
- [Робоча область агента](/uk/concepts/agent-workspace): де розташовані `SOUL.md`, `AGENTS.md` і файли пам’яті.
