Tutorial Migration

Von OpenClaw zu Hermes Agent — eine Migration Schritt für Schritt

Hermes Agent

Hermes Agent

@hermesagents

May 19, 2026

8 Min. Lesezeit

Wenn du OpenClaw schon eine Weile fährst, ist Hermes Agent sein Nachfolger. Gleiche Projekt-Herkunft, dieselben Maintainer, ein neuer Name und ein Redesign obendrauf. Der Hermes-Installer ist darauf vorbereitet — v0.14.0 bringt einen erstklassigen Befehl mit, hermes claw migrate, der deinen vorhandenen OpenClaw-Zustand in einem Rutsch übernimmt, mit Dry-run-Unterstützung und expliziten Presets.

Hier kommt die praktische Migrations-Anleitung: was übernommen wird, welche Flags es gibt und der „erst dry-run"-Workflow, der dir Überraschungen erspart.

1. Hermes Agent installieren

Der Hermes-Setup-Assistent erkennt ~/.openclaw automatisch und bietet vor Beginn der Konfiguration eine Migration an. Der schnellste Weg:

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

Wenn der Assistent dein OpenClaw-Home-Verzeichnis sieht, fragt er, ob er migrieren soll. Sag ja — aber wenn du genau sehen willst, was migriert würde, verlässt du den Assistenten und führst den Migrate-Befehl direkt aus.

2. Mit --dry-run vorab durchspielen

Diesen Schritt immer zuerst. Er listet alles auf, was der Migrator importieren würde, ohne irgendetwas auf die Platte zu schreiben:

bash
hermes claw migrate --dry-run

Die Ausgabe ist nach Kategorien gruppiert — SOUL.md, Memories, Skills, Allowlist, Messaging-Configs, API Keys, TTS-Assets. Lies sie durch. Wenn dir etwas schief vorkommt (ein alter API Key, den du nicht mitnehmen willst, eine Persönlichkeitsdatei, der du entwachsen bist), überspringst du den entsprechenden Abschnitt per Preset.

3. Ein Preset wählen

Zwei Presets gibt es by default:

  • full (Standard) — alles migrieren, Secrets inklusive
  • user-data — alles migrieren außer den API Keys; Secrets gibst du danach manuell wieder ein

Du wechselst auf eine frische Maschine und willst bei Secrets einen sauberen Schnitt? Nimm user-data:

bash
hermes claw migrate --preset user-data

Du aktualisierst dieselbe Maschine und willst Kontinuität?

bash
hermes claw migrate

4. Was alles übernommen wird

Laut README:

OpenClawHermes-Ziel
SOUL.md (Persönlichkeit)wird unverändert übernommen
Einträge aus MEMORY.md und USER.mdwandern ins Hermes-Memory
Selbst erstellte Skillskopiert nach ~/.hermes/skills/openclaw-imports/
Command-Allowlist (Approval-Patterns)übernommen
Messaging-Einstellungen (Plattform-Configs, erlaubte Nutzer, Arbeitsverzeichnis)übernommen
API Keys (Telegram, OpenRouter, OpenAI, Anthropic, ElevenLabs)unter Preset full übernommen
TTS-Assets (Workspace-Audiodateien)übernommen
Workspace-AGENTS.mdmit --workspace-target übernommen

Skills aus agentskills.io werden nicht automatisch neu installiert — Hermes geht davon aus, dass du den Hub nochmal durchsiehst und dir via hermes skills neu aussuchst, was du willst. Das ist Absicht: Die Umbenennung OpenClaw → Hermes hat den Skills-Hub auch überarbeitet (v0.14.0 hat huggingface/skills zum vertrauenswürdigen Default-Tap gemacht), und neu auswählen ist sauberer als alles pauschal mitzuschleppen.

5. Konflikte handhaben

Wenn Hermes auf dieser Maschine schon Settings hat (zum Beispiel, weil du hermes setup ausgeführt hast, bevor dir wieder einfiel, dass OpenClaw da war), weigert sich der Migrate-Befehl standardmäßig zu überschreiben. Zwei Optionen:

  • --overwrite — Hermes-Einstellungen mit den OpenClaw-Werten überschreiben
  • Die kollidierende Kategorie überspringen mit --preset user-data, wenn der Konflikt bei den Secrets liegt

--overwrite nimmst du erst, nachdem ein --dry-run bestätigt hat, dass die OpenClaw-Werte die sind, die du willst.

6. Verifizieren

bash
hermes doctor

Das führt den Post-Install-Healthcheck aus. Wenn Memories, Skills, Allowlist oder Plattform-Configs nicht da sind, wo sie sein sollten, kommen konkrete Fehler. Du fixt sie, lässt nochmal laufen, gehst weiter.

Alternative: agentgeführte Migration

Wenn du keine Lust auf CLI-Flags hast, bringt Hermes einen openclaw-migration-Skill mit:

bash
hermes
> /openclaw-migration

Der Skill führt dich interaktiv durch dieselbe Migration, mit --dry-run-Vorschau bei jedem Schritt.

Häufige Fragen

Verliere ich meine OpenClaw-Daten? Nein. Der Migrator kopiert — er verschiebt nicht. Dein ~/.openclaw-Verzeichnis bleibt unangetastet. Wenn etwas schiefgeht, kannst du ~/.hermes löschen und mit OpenClaw weitermachen.

Kann ich beide gleichzeitig laufen lassen? Kurzfristig schon. Sie teilen Annahmen über HOME und sind beide nicht darauf ausgelegt, gleichzeitig denselben Memory zu besitzen. Für längeren Parallelbetrieb übernimmt die Community-Bridge HermesClaw das Laufen von OpenClaw und Hermes auf demselben WeChat-Account.

Brechen meine Skills? Selbst erstellte Skills wandern nach ~/.hermes/skills/openclaw-imports/, sie überleben den Umzug. Skills aus agentskills.io hängen am Hub, nicht an deiner lokalen Installation — du installierst sie neu via hermes skills.

Wo bekomme ich Hilfe, wenn etwas schiefgeht? Zuerst hermes doctor. Dann der Nous-Research-Discord oder die GitHub-Issues — beide aus der README verlinkt.

Weiterlesen

Updates abonnieren

Community-Updates zu Hermes-Agent-Releases, neuen Skills und Integrationen. Kein Spam, jederzeit abbestellbar.