English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Maintenance

Міграція з Hermes

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

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

Майстер початкового налаштування

Найшвидший шлях. Майстер виявляє Hermes у ~/.hermes і показує попередній перегляд перед застосуванням.

openclaw onboard --flow import

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

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

CLI

Використовуйте openclaw migrate для скриптованих або повторюваних запусків. Див. openclaw migrate для повної довідки.

openclaw migrate hermes --dry-run    # preview only
openclaw migrate apply hermes --yes  # apply with confirmation skipped

Додайте --from <path>, якщо Hermes розташований поза ~/.hermes.

Що імпортується

Конфігурація моделі
  • Вибір моделі за замовчуванням із Hermes config.yaml.
  • Налаштовані провайдери моделей і власні OpenAI-сумісні кінцеві точки з providers і custom_providers.
MCP-сервери

Визначення MCP-серверів із mcp_servers або mcp.servers.

Файли робочої області
  • SOUL.md і AGENTS.md копіюються в робочу область агента OpenClaw.
  • memories/MEMORY.md і memories/USER.md додаються до відповідних файлів пам’яті OpenClaw замість перезапису.
Конфігурація пам’яті

Типові значення конфігурації пам’яті для файлової пам’яті OpenClaw. Зовнішні провайдери пам’яті, як-от Honcho, записуються як архівні елементи або елементи для ручного перегляду, щоб ви могли перенести їх свідомо.

Skills

Skills із файлом SKILL.md у skills/<name>/ копіюються разом зі значеннями конфігурації для кожного Skill з skills.config.

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

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

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

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

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

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

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

    openclaw migrate hermes --dry-run

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

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

    openclaw migrate apply hermes --yes

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

  • Запустіть doctor

    openclaw doctor

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

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

    openclaw gateway restart
openclaw status

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

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

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

    Для свіжого встановлення 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.

    Hermes розташований поза ~/.hermes

    Передайте --from /actual/path (CLI) або --import-source /actual/path (початкове налаштування).

    Початкове налаштування відмовляється імпортувати в наявне налаштування

    Імпорт під час початкового налаштування потребує свіжого налаштування. Або скиньте стан і пройдіть початкове налаштування знову, або використайте openclaw migrate apply hermes напряму; він підтримує --overwrite і явне керування резервною копією.

    API-ключі не імпортувалися

    Потрібен --include-secrets, і розпізнаються лише перелічені вище ключі. Інші змінні в .env ігноруються.

    Пов’язане