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

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

Найшвидший шлях. Майстер виявляє Hermes у ~/.hermes і показує попередній перегляд перед застосуванням.
openclaw onboard --flow import
Або вкажіть конкретне джерело:
openclaw onboard --import-from hermes --import-source ~/.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/<name>/ копіюються разом зі значеннями конфігурації для кожного Skill з skills.config.
Інтерактивний openclaw migrate запитує перед імпортом облікових даних автентифікації, з типовим вибором «так». Прийнятий імпорт охоплює облікові дані OpenCode OpenAI OAuth з OpenCode auth.json, записи OpenCode і GitHub Copilot з OpenCode auth.json та підтримувані ключі .env. Записи Hermes auth.json OAuth є застарілим станом і показуються як завдання для ручної повторної автентифікації або doctor замість імпорту в активну автентифікацію. Використовуйте --include-secrets для неінтерактивного імпорту облікових даних openclaw migrate, --no-auth-credentials, щоб пропустити його, або onboarding --import-secrets під час імпорту з майстра налаштування.

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

Постачальник копіює це в каталог звіту міграції для ручного перегляду, але не завантажує в активну конфігурацію або облікові дані OpenClaw:
  • plugins/
  • sessions/
  • logs/
  • cron/
  • mcp-tokens/
  • state.db
OpenClaw відмовляється автоматично виконувати цей стан або довіряти йому, оскільки формати й припущення довіри можуть відрізнятися між системами. Перенесіть потрібне вручну після перегляду архіву.

​
Рекомендований процес

1

Preview the plan

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

Apply with backup

openclaw migrate apply hermes --yes
OpenClaw створює й перевіряє резервну копію перед застосуванням. Цей неінтерактивний приклад імпортує несекретний стан. Запустіть без --yes, щоб відповісти на запит щодо облікових даних, або додайте --include-secrets, щоб включити підтримувані облікові дані в автоматичні запуски.
3

Run doctor

openclaw doctor
Doctor повторно застосовує всі незавершені міграції конфігурації та перевіряє проблеми, внесені під час імпорту.
4

Restart and verify

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. Записи Hermes auth.json OAuth повідомляються для ручної повторної автентифікації OpenAI або відновлення через doctor.
  • Використовуйте --no-auth-credentials або виберіть «ні» у запиті, щоб імпортувати лише несекретний стан.
  • Використовуйте --include-secrets під час автоматичного запуску з --yes.
  • Використовуйте onboarding --import-secrets під час імпорту облікових даних із майстра налаштування.
  • Для облікових даних, керованих SecretRef, налаштуйте джерело SecretRef після завершення імпорту.

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

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; інші змінні в .env ігноруються.

​
Пов’язане