Перейти до основного вмісту

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.

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.
Установіть --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. Без цього прапорця секрети ніколи не копіюються.

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

Провайдер копіює це в директорію звіту міграції для ручного перегляду, але не завантажує їх у активну конфігурацію або облікові дані 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 повторно застосовує будь-які очікувані міграції конфігурації та перевіряє проблеми, внесені під час імпорту.
4

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

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

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

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

​
Секрети

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

​
Пов’язане