~/.hermes, показує попередній перегляд кожної зміни перед застосуванням, приховує секрети в планах і звітах та створює перевірену резервну копію OpenClaw, перш ніж щось змінювати.
Імпорт потребує нового налаштування OpenClaw. Якщо у вас уже є локальний стан OpenClaw, спочатку скиньте конфігурацію, облікові дані, сеанси та робочий простір або скористайтеся безпосередньо
openclaw migrate apply hermes із --overwrite після перегляду плану.Два способи імпорту
- Майстер початкового налаштування
- CLI
Виявляє Hermes у Або вкажіть конкретне джерело:
~/.hermes і показує попередній перегляд перед застосуванням.Що імпортується
Конфігурація моделі
Конфігурація моделі
- Вибір стандартної моделі з Hermes
config.yaml. - Налаштовані провайдери моделей і власні сумісні з OpenAI кінцеві точки з
providersтаcustom_providers.
Сервери MCP
Сервери MCP
Визначення серверів MCP із
mcp_servers або mcp.servers.Файли робочого простору
Файли робочого простору
SOUL.mdіAGENTS.mdкопіюються до робочого простору агента OpenClaw.memories/MEMORY.mdіmemories/USER.mdдодаються в кінець відповідних файлів пам’яті OpenClaw замість їх перезаписування.
Конфігурація пам’яті
Конфігурація пам’яті
Стандартні параметри конфігурації файлової пам’яті OpenClaw. Зовнішні провайдери пам’яті, як-от Honcho, записуються як елементи архіву або ручної перевірки, щоб ви могли перенести їх свідомо.
Skills
Skills
Skills із файлом
SKILL.md у skills/<name>/ копіюються разом зі значеннями конфігурації кожного Skills із skills.config.Облікові дані автентифікації
Облікові дані автентифікації
Інтерактивна команда
openclaw migrate запитує підтвердження перед імпортом облікових даних автентифікації, причому стандартно вибрано «так». Після підтвердження імпортуються записи OpenCode OpenAI OAuth і GitHub Copilot із auth.json OpenCode, а також підтримувані ключі Hermes .env. Власні записи OAuth із auth.json Hermes є застарілим станом: замість імпорту до активної автентифікації вони відображаються як елемент для ручної повторної автентифікації або перевірки командою doctor. Використовуйте --include-secrets, щоб імпортувати облікові дані під час неінтерактивного запуску, --no-auth-credentials, щоб повністю пропустити імпорт облікових даних, або прапорець --import-secrets майстра початкового налаштування.Що залишається лише в архіві
Провайдер копіює наведені нижче елементи до каталогу звіту про міграцію для ручної перевірки, але не завантажує їх до активної конфігурації чи облікових даних OpenClaw:plugins/sessions/logs/cron/mcp-tokens/state.db
Рекомендований процес
1
Перегляньте план
2
Застосуйте зі створенням резервної копії
--yes, щоб відповісти на запит щодо облікових даних інтерактивно, або додайте --include-secrets, щоб включити підтримувані облікові дані під час автоматичного запуску.3
Запустіть doctor
4
Перезапустіть і перевірте
Обробка конфліктів
Застосування не продовжується, якщо план повідомляє про конфлікти — файл або значення конфігурації вже існує в цільовому розташуванні. Під час нового встановлення конфлікти трапляються рідко. Зазвичай вони виникають, коли імпорт запускають повторно для налаштування, яке вже містить зміни користувача. Якщо конфлікт виникає під час застосування (наприклад, через неочікувану конкуренцію за файл конфігурації), Hermes позначає решту залежних елементів конфігурації якskipped із причиною blocked by earlier apply conflict, замість того щоб записувати їх частково. Звіт про міграцію фіксує кожен заблокований елемент, щоб ви могли усунути початковий конфлікт і повторно запустити імпорт.
Секрети
Інтерактивна командаopenclaw migrate запитує, чи імпортувати виявлені облікові дані автентифікації, причому стандартно вибрано «так».
- Після підтвердження імпортуються записи OpenCode OpenAI OAuth і GitHub Copilot із
auth.jsonOpenCode, а також підтримувані ключі.env. Власні записи OAuth ізauth.jsonHermes натомість включаються до звіту для ручної повторної автентифікації OpenAI або виправлення командою doctor. - Використовуйте
--no-auth-credentialsабо дайте негативну відповідь на запит, щоб імпортувати лише несекретний стан. - Використовуйте
--include-secrets, щоб імпортувати облікові дані під час автоматичного запуску з--yes. - Використовуйте прапорець
--import-secretsмайстра початкового налаштування, щоб імпортувати облікові дані за допомогою майстра.
Виведення JSON для автоматизації
--json і без --yes команда застосування виводить план і не змінює стан — це найбезпечніший режим для CI та спільних сценаріїв.
Усунення проблем
Застосування не виконується через конфлікти
Застосування не виконується через конфлікти
Перегляньте виведення плану. Для кожного конфлікту вказано шлях до джерела та наявний цільовий елемент. Для кожного елемента вирішіть, чи пропустити його, змінити цільовий елемент або повторно запустити команду з
--overwrite.Hermes розташовано поза ~/.hermes
Hermes розташовано поза ~/.hermes
Передайте
--from /actual/path (CLI) або --import-source /actual/path (початкове налаштування).Майстер початкового налаштування відмовляється імпортувати до наявного налаштування
Майстер початкового налаштування відмовляється імпортувати до наявного налаштування
Імпорт за допомогою майстра початкового налаштування потребує нового налаштування. Або скиньте стан і повторно виконайте початкове налаштування, або скористайтеся безпосередньо
openclaw migrate apply hermes, що підтримує --overwrite і явне керування резервними копіями.Ключі API не імпортувалися
Ключі API не імпортувалися
Інтерактивна команда
openclaw migrate імпортує ключі API, лише якщо ви підтвердите це у запиті щодо облікових даних. Для неінтерактивних запусків із --yes потрібен --include-secrets, а для імпорту за допомогою майстра початкового налаштування — --import-secrets. Розпізнаються лише підтримувані ключі .env — інші змінні .env ігноруються.Пов’язані матеріали
openclaw migrate: повний довідник CLI, контракт Plugin і структури JSON.- Початкове налаштування: процес майстра та прапорці неінтерактивного режиму.
- Міграція: перенесення встановлення OpenClaw між комп’ютерами.
- Doctor: перевірка стану після міграції.
- Робочий простір агента: розташування
SOUL.md,AGENTS.mdі файлів пам’яті.