Tutorial Migration

От OpenClaw к Hermes Agent: миграция шаг за шагом

Hermes Agent

Hermes Agent

@hermesagents

May 19, 2026

8 мин чтения

Если ты до этого гонял OpenClaw, Hermes Agent — его преемник. Та же родословная проекта, те же мейнтейнеры, поверх — переименование и редизайн. Hermes-инсталлер был сделан так, чтобы это видеть — v0.14.0 несёт first-class команду hermes claw migrate, которая в один заход импортирует твой OpenClaw-стейт, с поддержкой dry-run и явными пресетами.

Это практический разбор миграции: что переезжает, какие у тебя есть флаги, и тот самый поток «сначала dry-run», который страхует от сюрпризов.

1. Поставить Hermes Agent

Мастер настройки Hermes автоматически обнаруживает ~/.openclaw и предлагает миграцию перед началом конфигурации. Самый быстрый путь:

bash
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.bashrc
hermes setup

Когда мастер видит твою OpenClaw-хоум-директорию, он спрашивает, мигрировать ли её. Скажи да — но если хочешь сначала глазами увидеть, что именно поедет, выйди из мастера и запусти команду миграции напрямую.

2. Превью через --dry-run

Всегда сначала прогоняй это. Оно перечисляет всё, что миграт перетащил бы, не трогая диск:

bash
hermes claw migrate --dry-run

Вывод сгруппирован по категориям — SOUL.md, memory, skills, allowlist, конфиги мессенджеров, API-ключи, TTS-ассеты. Прочитай. Если что-то выглядит криво (мёртвый API-ключ, который ты не хочешь тянуть, файл личности, из которого ты уже вырос), пропусти соответствующий блок через пресет.

3. Выбрать пресет

По умолчанию два пресета:

  • full (по умолчанию) — переносит всё, включая секреты
  • user-data — переносит всё кроме API-ключей; секреты впишешь руками

Переезжаешь на новую машину и хочешь чистый разрыв по секретам? Берёшь user-data:

bash
hermes claw migrate --preset user-data

Апгрейдишь ту же самую машину и хочешь преемственность?

bash
hermes claw migrate

4. Что именно переезжает

Согласно README:

OpenClawЦель в Hermes
SOUL.md (персона)импортируется as-is
Записи MEMORY.md и USER.mdимпортируются в Hermes memory
Скилы, написанные пользователемкопируются в ~/.hermes/skills/openclaw-imports/
Allowlist команд (паттерны одобрения)импортируется
Настройки мессенджеров (конфиги платформ, allowlist пользователей, working directory)импортируется
API-ключи (Telegram, OpenRouter, OpenAI, Anthropic, ElevenLabs)импортируются на пресете full
TTS-ассеты (аудио-файлы воркспейса)импортируются
AGENTS.md воркспейсаимпортируется по --workspace-target

Скилы из agentskills.io не переустанавливаются автоматически — Hermes исходит из того, что ты заново зайдёшь в hub и подберёшь нужные через hermes skills. Это сделано специально: переименование OpenClaw → Hermes заодно перетряхнуло skills-hub (v0.14.0 завёл huggingface/skills как доверенный tap по умолчанию), и свежий подбор аккуратнее, чем перенос всем гуртом.

5. Конфликты

Если у Hermes на этой машине уже что-то настроено (например, ты сделал hermes setup ещё до того, как вспомнил, что у тебя стоит OpenClaw), команда миграции по умолчанию отказывается перезаписывать. Два варианта:

  • --overwrite — затереть настройки Hermes значениями из OpenClaw
  • Пропустить конфликтную категорию через --preset user-data, если конфликт на секретах

Бери --overwrite только после --dry-run, который подтвердил, что значения из OpenClaw — именно те, которые ты и хочешь.

6. Проверить

bash
hermes doctor

Это пост-установочный health-check. Если memory, skills, allowlist или конфиги платформ оказались не там, где должны быть, doctor выводит конкретные ошибки. Фиксишь, перезапускаешь, едешь дальше.

Альтернатива: миграция руками агента

Если тебе совсем не хочется лезть в флаги CLI, у Hermes есть скил openclaw-migration:

bash
hermes
> /openclaw-migration

Этот скил интерактивно проводит тебя через ту же миграцию, с превью через --dry-run на каждом шаге.

Частые вопросы

Я не потеряю свои OpenClaw-данные? Нет. Миграт копирует, а не перемещает. Твоя ~/.openclaw остаётся нетронутой. Если что-то пойдёт не так — удаляешь ~/.hermes и продолжаешь пользоваться OpenClaw.

Можно ли крутить оба разом? Кратко — да. Они шарят предположения насчёт HOME и не оба ждут, что владеют одной и той же memory одновременно. На долгое сосуществование комьюнити-мост HermesClaw умеет гонять OpenClaw и Hermes на одном WeChat-аккаунте.

Сломаются ли мои скилы? Скилы, которые ты написал руками, копируются в ~/.hermes/skills/openclaw-imports/, так что переезд они переживают. Скилы, которые ты ставил из agentskills.io, привязаны к хабу, а не к твоей локальной установке — переустанови их через hermes skills.

Куда писать, если что-то всё-таки сломалось? Сначала hermes doctor. Потом Nous Research Discord или GitHub Issues — оба линка есть в README.

Дальше

Поделиться в:
star Star on GitHub

Подписаться на обновления

Новости сообщества о релизах Hermes Agent, новых навыках и интеграциях. Без спама, отписаться можно в любой момент.