Tutorial Migration

Z OpenClaw do Hermes Agent: migracja krok po kroku

Hermes Agent

Hermes Agent

@hermesagents

May 19, 2026

8 min czytania

Jeśli ganisz OpenClaw, Hermes Agent jest jego następcą. Ta sama linia projektu, ci sami maintainerzy, na wierzchu zmiana nazwy i przeprojektowanie. Instalator Hermesa został zbudowany tak, żeby to rozpoznawać — v0.14.0 niesie first-classową komendę hermes claw migrate, która importuje twój istniejący stan OpenClaw w jednym przejściu, z dry-runem i jawnymi presetami.

To praktyczny przewodnik po migracji: co wchodzi, jakie masz flagi i flow „najpierw dry-run", który ratuje przed niespodziankami.

1. Zainstaluj Hermes Agent

Kreator setupu Hermesa automatycznie wykrywa ~/.openclaw i przed startem konfiguracji proponuje migrację. Najszybsza droga:

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

Kiedy kreator zobaczy twoje OpenClaw-owe home, zapyta, czy migrować. Powiedz tak — ale jeśli chcesz najpierw zobaczyć dokładnie, co by wjechało, wyjdź z kreatora i odpal komendę migracyjną wprost.

2. Podgląd z --dry-run

Zawsze odpalaj to najpierw. Wylistuje wszystko, co migrator zaimportowałby, nie pisząc nic na dysk:

bash
hermes claw migrate --dry-run

Output grupuje po kategoriach — SOUL.md, memory, skille, allowlista, configi mesengerów, klucze API, assety TTS. Przeczytaj. Jeśli coś wygląda nie tak (przeterminowany klucz API, którego nie chcesz migrować, plik osobowości, z którego wyrosłeś), pomiń ten dział presetem.

3. Wybierz preset

Domyślnie są dwa presety:

  • full (domyślny) — migruj wszystko, włącznie z sekretami
  • user-data — migruj wszystko oprócz kluczy API; sekrety wpisujesz potem ręcznie

Przeprowadzasz się na świeżą maszynę i chcesz czysty cut na sekretach? Bierzesz user-data:

bash
hermes claw migrate --preset user-data

Aktualizujesz tę samą maszynę i chcesz ciągłość?

bash
hermes claw migrate

4. Co wchodzi

Zgodnie z README:

OpenClawCel w Hermesie
SOUL.md (persona)importowany as-is
Wpisy z MEMORY.md i USER.mdimportowane do memory Hermesa
Skille pisane przez użytkownikakopiowane do ~/.hermes/skills/openclaw-imports/
Allowlista komend (wzorce zatwierdzania)importowana
Ustawienia mesengera (configi platform, allowlista użytkowników, working directory)importowane
Klucze API (Telegram, OpenRouter, OpenAI, Anthropic, ElevenLabs)importowane pod presetem full
Assety TTS (pliki audio w workspace)importowane
AGENTS.md workspace'uimportowany z --workspace-target

Skille z agentskills.io nie są instalowane ponownie automatycznie — Hermes zakłada, że jeszcze raz przejdziesz przez hub i przez hermes skills wybierzesz, czego chcesz. To celowe: zmiana nazwy OpenClaw → Hermes przerobiła też skills-hub (v0.14.0 dodał huggingface/skills jako zaufany tap domyślny), a świeży wybór jest czystszy niż hurtowe przewiezienie.

5. Konflikty

Jeśli Hermes ma już ustawienia na tej maszynie (np. zrobiłeś hermes setup, zanim sobie przypomniałeś, że OpenClaw też tam siedzi), komenda migracji domyślnie odmawia nadpisania. Dwie opcje:

  • --overwrite — nadpisuje ustawienia Hermesa wartościami z OpenClaw
  • Pomiń sporną kategorię przez --preset user-data, jeśli konflikt jest na sekretach

--overwrite używaj dopiero po --dry-run, który potwierdza, że wartości z OpenClaw to te, których chcesz.

6. Weryfikuj

bash
hermes doctor

To uruchamia health-check po instalacji. Jeśli memory, skille, allowlista albo configi platform nie są tam, gdzie powinny, doctor wystawia konkretne błędy. Naprawiasz, odpalasz ponownie, idziesz dalej.

Alternatywa: migracja prowadzona przez agenta

Jeśli wolisz nie ruszać flag CLI, Hermes niesie skill openclaw-migration:

bash
hermes
> /openclaw-migration

Skill prowadzi cię interaktywnie przez tę samą migrację, z podglądem --dry-run na każdym kroku.

Częste pytania

Czy stracę swoje dane z OpenClaw? Nie. Migrator kopiuje — nie przenosi. Twój katalog ~/.openclaw zostaje nietknięty. Jeśli coś pójdzie nie tak, możesz cofnąć się, kasując ~/.hermes i dalej używać OpenClaw.

Czy mogę gonić oba naraz? Krótkookresowo. Mają wspólne założenia co do HOME i obydwa zakładają, że są właścicielami tej samej memory w tym samym momencie. Na dłuższą koegzystencję społecznościowy most HermesClaw ogarnia chodzenie OpenClaw i Hermesa na tym samym koncie WeChat.

Czy moje skille się zepsują? Skille, które sam napisałeś, są kopiowane do ~/.hermes/skills/openclaw-imports/, więc przeprowadzkę przeżywają. Skille, które masz z agentskills.io, są związane z hubem, a nie z lokalną instalacją — zainstaluj je ponownie przez hermes skills.

Gdzie szukać pomocy, jeśli coś się sypnie? Najpierw hermes doctor. Potem Nous Research Discord albo GitHub Issues — oba linki są w README.

Dalsza lektura

Subskrybuj aktualizacje

Aktualności społeczności o wydaniach Hermes Agent, nowych umiejętnościach i integracjach. Bez spamu, wypisz się kiedy chcesz.