Вопрос

Как перенести настройки и агентов из Hermes Agent в OpenClaw

Штатный провайдер миграции забирает конфиг моделей, MCP-серверы, память, скиллы и часть ключей. Hermes-only поля и нестандартные фильтры придётся править руками.

· 4 мин чтения

Коротко

  • Миграция читает HERMES_HOME или активный профиль Hermes: на macOS/Linux по умолчанию ~/.hermes, на Windows — %LOCALAPPDATA%\hermes. Параметр --from <path> всегда побеждает.
  • Импорт забирает конфиг моделей, MCP-серверы, SOUL.md, AGENTS.md, память, скиллы и часть ключей. Секреты в плане маскируются.
  • Импорт через мастер онбординга требует свежей установки. На рабочей OpenClaw сначала сбросьте состояние или используйте openclaw migrate apply hermes с --overwrite после ревью плана.
  • В архив отчёта уходят plugins/, сессии, логи, cron/, mcp-tokens/, plans/, workspace/, skins/, kanban/, хранилища pairing/ и platforms/. Их OpenClaw не активирует автоматически.

Сверено с документацией OpenClaw 2026.10.4, 16 октября 2026.

Переезд с Hermes Agent в OpenClaw 2026.10.4 — это встроенный провайдер @openclaw/migrate-hermes. Он заранее показывает план и маскирует секреты в отчёте перед применением. Доступны две команды: мастер онбординга и отдельная CLI openclaw migrate. Дальше что именно миграция переносит сама, а что придётся переписать руками.

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

Мастер подойдёт для свежей установки. CLI для повторяемых прогонов и ручных сценариев.

openclaw onboard --flow import
openclaw onboard --import-from hermes --import-source ~/.hermes
openclaw migrate hermes --dry-run
openclaw migrate apply hermes --yes
openclaw migrate apply hermes --json --yes

--dry-run строит план без изменений и маскирует ключи в выводе. --json нужен для автоматизации. Неинтерактивный apply требует флага --yes, а ключи и OAuth переносит, только если добавить --include-secrets.

Что миграция забирает сама

  • Конфиг моделей: выбор по умолчанию из config.yaml, настройки model, providers, custom_providers, Hermes-алиасы транспортов, поля провайдеров в camelCase и списки моделей с метаданными. С флагом --agent <id> модель уходит выбранному агенту.
  • MCP-серверы из mcp_servers или mcp.servers: состояние disabled, таймауты, поддержка параллельных вызовов, область OAuth, совместимые TLS-поля и политики нативных инструментов, ресурсов и промптов.
  • Файлы рабочей директории: SOUL.md и AGENTS.md копируются в агентский workspace. memories/MEMORY.md и memories/USER.md дописываются к одноимённым файлам OpenClaw вместо перезаписи.
  • Память: настройки по умолчанию для файлового хранилища. Внешние провайдеры вроде Honcho становятся архивными пунктами для ручного переноса.
  • Скиллы: все каталоги с SKILL.md рекурсивно, плюс конфиг из skills.config и глобальный skills.disabled. Импортируется только активная организация по _org/.active_org.
  • Ключи: текущие OAuth-записи Hermes OpenAI Codex, OpenCode OpenAI OAuth и GitHub Copilot. Перечень поддерживаемых ключей описан в справке openclaw migrate.

Что придётся переписать руками

  • Поля жизненного цикла MCP, специфичные для Hermes: sampling (сэмплинг), elicitation (запрос данных у пользователя), preflight (предварительная проверка), keepalive (поддержание соединения), CA-bundle (набор сертификатов), client-key с паролем и предзарегистрированные OAuth-клиенты. Они становятся пунктами ручной проверки, а не валидным конфигом OpenClaw.
  • Паттерны фильтров инструментов ? и скобочные шаблоны Hermes. OpenClaw понимает в фильтрах только точные имена и *. Неподдерживаемые паттерны в include просто отбрасываются. Серверы с неподдерживаемыми исключающими паттернами импортируются в состоянии disabled, замените фильтр и включите сами.
  • Литеральные значения переменных окружения и заголовков в MCP требуют согласия на импорт учётных данных. Токены из mcp-tokens/ тоже не подтягиваются, они остаются в архиве.

Как проверить результат

  1. Прогоните openclaw doctor. Он накатывает отложенные миграции конфига и ловит проблемы от импорта.
  2. Перезапустите Gateway: openclaw gateway restart.
  3. Снимите статус: openclaw status.
  4. Убедитесь по openclaw status, что импортированные модель, память и скиллы загружены. По Hermes OAuth: не держите Hermes и OpenClaw на одном refresh-токене (токене обновления), переавторизуйте одну сторону до параллельной работы.

Частые ошибки

  • Импорт упал на конфликтах. Это значит, файл или значение уже есть на целевой стороне. Перечитайте план и либо пропустите пункт, либо перезапустите с --overwrite осознанно.
  • Hermes живёт не в ~/.hermes. Передайте путь явно: --from /actual/path для CLI или --import-source /actual/path в онбординге.
  • Онбординг отказался из-за существующего состояния. Либо сбросьте конфиг, учётные данные, сессии и workspace, либо идите через openclaw migrate apply hermes напрямую.
  • Ключи API не приехали. Интерактивная миграция по умолчанию импортирует ключи. В неинтерактивном режиме нужен --include-secrets, в мастере — флаг --import-secrets.
  • После импорта молчат cron, плагины, сессии и хранилища каналов. Они лежат в архивной части отчёта миграции и не активируются автоматически: форматы и допущения о доверии к такому состоянию могут расходиться между системами.