--- read_when: - Ви переходите з Hermes і хочете зберегти конфігурацію моделі, промпти, пам’ять і Skills - Ви хочете знати, що OpenClaw імпортує автоматично, а що залишається лише в архіві - Вам потрібен чистий, сценарно автоматизований шлях міграції (CI, новий ноутбук, автоматизація) summary: Перейдіть із Hermes на OpenClaw за допомогою імпорту з попереднім переглядом і можливістю скасування title: Перехід з Hermes x-i18n: generated_at: "2026-07-12T13:18:58Z" model: gpt-5.6 postprocess_version: locale-links-v1 provider: openai source_hash: dd9012efb084c00dfe55bb841fea3cc6908c08b528492f1552bf226f125961e6 source_path: install/migrating-hermes.md workflow: 16 --- Вбудований провайдер міграції Hermes виявляє стан у `~/.hermes`, показує попередній перегляд кожної зміни перед застосуванням, приховує секрети в планах і звітах та створює перевірену резервну копію OpenClaw, перш ніж щось змінювати. Імпорт потребує нового налаштування OpenClaw. Якщо у вас уже є локальний стан OpenClaw, спочатку скиньте конфігурацію, облікові дані, сеанси та робочий простір або скористайтеся безпосередньо `openclaw migrate apply hermes` із `--overwrite` після перегляду плану. ## Два способи імпорту Виявляє Hermes у `~/.hermes` і показує попередній перегляд перед застосуванням. ```bash openclaw onboard --flow import ``` Або вкажіть конкретне джерело: ```bash openclaw onboard --import-from hermes --import-source ~/.hermes ``` Використовуйте `openclaw migrate` для сценарних або повторюваних запусків. Повний довідник див. у розділі [`openclaw migrate`](/uk/cli/migrate). ```bash openclaw migrate hermes --dry-run # лише попередній перегляд openclaw migrate apply hermes --yes # застосувати без запиту підтвердження ``` Додайте `--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 і GitHub Copilot із `auth.json` OpenCode, а також [підтримувані ключі Hermes `.env`](/uk/cli/migrate#supported-env-keys). Власні записи OAuth із `auth.json` Hermes є застарілим станом: замість імпорту до активної автентифікації вони відображаються як елемент для ручної повторної автентифікації або перевірки командою 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`, щоб включити підтримувані облікові дані під час автоматичного запуску. ```bash openclaw doctor ``` [Doctor](/uk/gateway/doctor) повторно застосовує всі незавершені міграції конфігурації та перевіряє наявність проблем, що виникли під час імпорту. ```bash openclaw gateway restart openclaw status ``` Переконайтеся, що Gateway працює належним чином, а імпортовані модель, пам’ять і Skills завантажено. ## Обробка конфліктів Застосування не продовжується, якщо план повідомляє про конфлікти — файл або значення конфігурації вже існує в цільовому розташуванні. Повторно запускайте з `--overwrite`, лише якщо ви навмисно замінюєте наявний цільовий елемент. Провайдери все одно можуть створювати резервні копії окремих перезаписаних файлів у каталозі звіту про міграцію. Під час нового встановлення конфлікти трапляються рідко. Зазвичай вони виникають, коли імпорт запускають повторно для налаштування, яке вже містить зміни користувача. Якщо конфлікт виникає під час застосування (наприклад, через неочікувану конкуренцію за файл конфігурації), Hermes позначає решту залежних елементів конфігурації як `skipped` із причиною `blocked by earlier apply conflict`, замість того щоб записувати їх частково. Звіт про міграцію фіксує кожен заблокований елемент, щоб ви могли усунути початковий конфлікт і повторно запустити імпорт. ## Секрети Інтерактивна команда `openclaw migrate` запитує, чи імпортувати виявлені облікові дані автентифікації, причому стандартно вибрано «так». - Після підтвердження імпортуються записи OpenCode OpenAI OAuth і GitHub Copilot із `auth.json` OpenCode, а також [підтримувані ключі `.env`](/uk/cli/migrate#supported-env-keys). Власні записи OAuth із `auth.json` Hermes натомість включаються до звіту для ручної повторної автентифікації OpenAI або виправлення командою doctor. - Використовуйте `--no-auth-credentials` або дайте негативну відповідь на запит, щоб імпортувати лише несекретний стан. - Використовуйте `--include-secrets`, щоб імпортувати облікові дані під час автоматичного запуску з `--yes`. - Використовуйте прапорець `--import-secrets` майстра початкового налаштування, щоб імпортувати облікові дані за допомогою майстра. ## Виведення 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`](/uk/cli/migrate#supported-env-keys) — інші змінні `.env` ігноруються. ## Пов’язані матеріали - [`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` і файлів пам’яті.