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

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

Найшвидший шлях. Майстер виявляє Hermes у ~/.hermes і показує попередній перегляд перед застосуванням.
openclaw onboard --flow import
Або вкажіть конкретне джерело:
openclaw onboard --import-from hermes --import-source ~/.hermes

​
Що буде імпортовано

  • Вибір моделі за замовчуванням із Hermes config.yaml.
  • Налаштовані провайдери моделей і власні сумісні з OpenAI endpoint-и з providers і custom_providers.
Визначення MCP-серверів із mcp_servers або mcp.servers.
  • SOUL.md і AGENTS.md копіюються до workspace агента OpenClaw.
  • memories/MEMORY.md і memories/USER.md додаються до відповідних файлів пам’яті OpenClaw, а не перезаписують їх.
Типові параметри конфігурації пам’яті для файлової пам’яті OpenClaw. Зовнішні провайдери пам’яті, такі як Honcho, фіксуються як елементи архіву або ручної перевірки, щоб ви могли перенести їх усвідомлено.
Skills із файлом SKILL.md у skills/<name>/ копіюються разом із значеннями конфігурації для кожного skill із skills.config.
Установіть --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. Без цього прапорця секрети ніколи не копіюються.

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

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

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

1

Перегляньте план

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

Застосуйте з резервною копією

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

Запустіть doctor

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

Перезапустіть і перевірте

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

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

Застосування відмовляється продовжувати, коли план повідомляє про конфлікти (файл або значення config уже існує в цільовому місці).
Повторно запускайте з --overwrite лише тоді, коли заміна наявної цілі є свідомим рішенням. Провайдери все одно можуть записувати резервні копії окремих елементів для перезаписаних файлів у каталог звіту міграції.
Для свіжої інсталяції OpenClaw конфлікти нетипові. Зазвичай вони з’являються, коли ви повторно запускаєте імпорт у налаштуванні, де вже є внесені користувачем зміни.

​
Секрети

Секрети ніколи не імпортуються за замовчуванням.
  • Спочатку виконайте openclaw migrate apply hermes --yes, щоб імпортувати стан без секретів.
  • Якщо ви також хочете скопіювати підтримувані ключі .env, повторно запустіть із --include-secrets.
  • Для credentials під керуванням 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 і явне керування резервними копіями.
Потрібен --include-secrets, і розпізнаються лише перелічені вище ключі. Інші змінні в .env ігноруються.

​
Пов’язане