Von OpenClaw zu Hermes Agent migrieren: Manuelle Anleitung

Sie haben die Entscheidung getroffen. Jetzt kommt das Wochenende.

Sie haben sich bereits entschieden. Vielleicht haben Sie den Vergleich Hermes Agent vs. OpenClaw gelesen und festgestellt, dass die fokussierte Agent-Laufzeitumgebung zu Ihrer tatsächlichen Arbeitsweise passt. Vielleicht hat das ein Teammitglied getan. So oder so liegt die Entscheidung hinter Ihnen. Vor Ihnen liegt ein echtes Stück operative Arbeit: ein laufendes OpenClaw-Setup mit monatelang angesammeltem Speicher und feinabgestimmten Skills auf eine saubere Hermes-Agent-Installation zu übertragen, ohne dass etwas Wichtiges verloren geht.

Hermes liefert einen offiziellen Migrationsbefehl mit. Das Paket hermes-migrate wurde am 10. März 2026 veröffentlicht, und der Ablauf hermes claw migrate ist dokumentiert, um Einstellungen, Speicher, Skills, Kanäle und API-Schlüssel zu importieren. Damit ist der Idealfall abgedeckt. Was es nicht abdeckt, ist die umgebende Arbeit: einen Host bereitzustellen, die Anbieter-Konfiguration von OpenClaws altem Format in das snake_case-Schema von Hermes zu übersetzen, Geheimnisse im Ruhezustand abzusichern, Ihren Telegram-Bot neu zu koppeln und alles durchgängig zu verifizieren, bevor Sie Ihrem Team mitteilen, dass der neue Bot live ist.

Diese Anleitung führt das Ganze manuell durch, damit Sie genau wissen, worauf Sie sich einlassen. Am Ende gibt es eine 1-Minuten-Alternative.

Schritt 1: Frieren Sie Ihren OpenClaw-Status ein und exportieren Sie ihn

Beginnen Sie nicht damit, Hermes zu installieren. Beginnen Sie damit, die OpenClaw-Seite stillstehen zu lassen.

OpenClaws eigene Migrationsdokumentation rät Ihnen, das Gateway vor dem Kopieren des Status zu stoppen, da sich sonst der Gesprächsverlauf und die Kanal-Sitzungen unter Ihren Händen verändern. Das Standard-Statusverzeichnis ist ~/.openclaw/, das openclaw.json, Gateway-Einstellungen, auth-profiles.json, Anbieter-Anmeldedaten, Sitzungen, Kanalstatus für WhatsApp und Telegram sowie Ihre Workspace-Dateien einschließlich MEMORY.md, USER.md, Skills und Prompts enthält.

openclaw gateway stop
cd ~
tar -czf openclaw-state-$(date +%Y%m%d).tgz .openclaw
sha256sum openclaw-state-*.tgz

Wenn Sie mit OPENCLAW_STATE_DIR einen benutzerdefinierten Pfad festgelegt haben oder wenn Sie Profile wie ~/.openclaw-work oder ~/.openclaw-personal betreiben, archivieren Sie jedes einzeln. Die Migration ist nur so vollständig wie die Verzeichnisse, an die Sie denken, sie zu erfassen, und der Fehlerfall, ein Profil zu vergessen, ist lautlos: Hermes startet einwandfrei, und Ihre Wochenend-Persönlichkeit ist einfach verschwunden.

Kopieren Sie die Archive auf den neuen Host, bevor Sie irgendetwas anderes ändern. Wenn Sie dies überspringen und die Installation auf dem neuen Host fehlschlägt, möchten Sie einen sauberen Rollback-Pfad, der nicht davon abhängt, dass die alte Maschine noch funktionsfähig ist.

Schritt 2: Stellen Sie einen Host bereit und installieren Sie Hermes

Sie brauchen nun einen Ort, an dem Hermes laufen kann. Die beiden realistischen Optionen sind ein kleiner VPS oder ein lokaler Docker-Host.

Für einen VPS ist eine Maschine mit 2 vCPU / 4 GB eine komfortable Untergrenze. Sie werden die nächste Stunde mit den Teilen verbringen, über die niemand Blogbeiträge schreibt: eine Region in der Nähe Ihrer Messaging-Nutzer auswählen, SSH absichern, eine Firewall konfigurieren, die nur die Ports zulässt, die Sie wirklich brauchen, unbeaufsichtigte Sicherheitsupdates einrichten und entscheiden, ob der Agent als root läuft (das sollte er nicht) oder als dedizierter Dienst-Benutzer mit einem abgeschotteten Home-Verzeichnis.

Bei lokalem Docker ist die Arbeit anders, aber nicht kürzer. Sie schreiben eine Compose-Datei, entscheiden, wo die Status-Volumes liegen, entscheiden, wie der Container beim Neustart des Hosts wieder hochfährt, und finden heraus, wie der Container die Außenwelt erreicht, ohne mehr offenzulegen, als er sollte.

Sobald der Host existiert, installieren Sie Hermes:

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

hermes setup sucht nach ~/.openclaw/ und bietet die Migration an. Wenn Sie Ihr Tarball in einen anderen Pfad hochgeladen haben, entpacken Sie es zuerst, damit der Assistent es findet.

Ein Terminal entpackt ein OpenClaw-Statusarchiv auf einem frischen Server

Schritt 3: Übersetzen Sie die Anbieter-Konfiguration

Dies ist der Schritt, bei dem die meisten manuellen Migrationen lautlos scheitern.

OpenClaw und Hermes lassen Sie beide den Agenten auf OpenAI, Anthropic, OpenRouter, vLLM, Ollama oder einen benutzerdefinierten OpenAI-kompatiblen Endpunkt verweisen. Die Felder sehen ähnlich aus. Sie haben nicht dasselbe Format.

Hermes erkennt in der Anbieter-Konfiguration ausschließlich snake_case. Ein von Hand bearbeitetes apiKey oder baseUrl wird lautlos verworfen. Verwenden Sie api_key und base_url. Wenn base_url gesetzt ist, ignoriert Hermes den Anbieternamen und ruft diesen Endpunkt direkt auf, wobei api_key oder die Umgebungsvariable OPENAI_API_KEY zur Authentifizierung verwendet wird.

Die minimale manuelle Zuordnung sieht für jeden Anbieter, den Sie übernehmen, so aus:

OpenClaw-Feld	Hermes-Feld	Hinweise
`provider`	`provider`	Passend zum kleingeschriebenen Slug, den Hermes erwartet (`openai`, `anthropic`, `openrouter`, `ollama`, `vllm`, `custom`)
`model`	`model`	Gleiche Zeichenkette, keine Übersetzung
`apiKey`	`api_key`	snake_case ist Pflicht, camelCase wird verworfen
`baseUrl`	`base_url`	snake_case ist Pflicht, nur setzen, wenn Sie wirklich einen benutzerdefinierten Endpunkt brauchen
`apiMode`	`api_mode`	Prüfen Sie, ob Hermes den von Ihnen verwendeten Wert noch unterstützt

Wiederholen Sie dies für jeden Anbieter, den Sie konfiguriert haben. Wenn Sie Fallback-Ketten betreiben (primärer Anbieter plus ein günstiges Backup), erledigen Sie sie einzeln und testen Sie jede, bevor Sie weitermachen.

Schritt 4: Persona, Skills und Speicher übertragen

OpenClaw speichert die Persona unter workspace/SOUL.md und IDENTITY.md, mit optionalen Ordnern pro Persönlichkeit unter personalities/, dazu USER.md, MEMORY.md und tägliche Speicherdateien. Skills liegen in Ihrem Workspace-Skills-Verzeichnis.

Eine saubere manuelle Übertragung ist eine Entscheidung pro Datei, kein Kopieren ganzer Verzeichnisse. Öffnen Sie jede Persona-Datei und bestätigen Sie:

Die Stimme und die Einschränkungen passen weiterhin dazu, wie sich der neue Agent verhalten soll.
Verweise auf OpenClaw-spezifische Tools (Control UI, Plugin-Namen, Gateway-Verhalten) sind entfernt oder umformuliert.
Skill-Namen kollidieren nicht mit den integrierten Skills von Hermes, da die importierte Version sonst ohne Warnung andere überschatten oder selbst überschattet werden kann.

Verschieben Sie die Dateien dann in das von Hermes erwartete Layout:

~/.hermes/SOUL.md für die Persona
~/.hermes/memories/ für MEMORY.md, USER.md und tägliche Dateien
~/.hermes/skills/openclaw-imports/ für Skills, mit von Hand durchgeführter Konfliktlösung

Bei den Speicherdateien unterschätzen die meisten Teams die Arbeit. Nach einem Jahr OpenClaw-Nutzung kann MEMORY.md Hunderte von Einträgen haben, die veralteten Projektkontext mit weiterhin relevanten Fakten vermischen. Die Migration ist der richtige Moment, um zu entdoppeln und auszumisten, nicht um blind zu kopieren.

Schritt 5: Sichern Sie Ihre Geheimnisse

Für diesen Schritt gibt es keine Abkürzung. Hermes speichert Anmeldedaten in ~/.hermes/, wobei sensible Auth-Tokens an Pfaden wie ~/.hermes/auth/google_oauth.json mit chmod 0600, atomaren Schreibvorgängen und prozessübergreifenden Dateisperren abgelegt werden. Das ist die Untergrenze, nicht die Obergrenze.

Eine manuelle Migration, die Geheimnisse ernst nimmt, braucht:

Eine klare Bestandsaufnahme jedes API-Schlüssels, den Sie übernehmen, mit einer zur Migrationszeit durchgeführten Rotation, sodass alle Schlüssel, die während Ihrer OpenClaw-Zeit geleakt sind, ungültig werden.
Dateiberechtigungen für ~/.hermes/.env, gesetzt auf 0600, im Besitz des Dienst-Benutzers, niemals lesbar für andere Konten auf dem Host.
Verschlüsselung im Ruhezustand für das Volume, das ~/.hermes/ enthält, besonders wenn der Host ein gemeinsam genutzter VPS ist.
Off-Host-Backups, die selbst verschlüsselt sind, mit einer getesteten Wiederherstellungsprozedur, denn ein Backup, das Sie nie wiederhergestellt haben, ist kein echtes Backup.
Dokumentierte Zugriffslisten, wer und was diese Dateien lesen darf, damit die nächste Person in Bereitschaft nicht raten muss.

Wenn Sie den Rotationsschritt überspringen, haben Sie Ihre Sicherheitslage nicht wirklich migriert, sondern lediglich verlagert.

Schritt 6: Telegram erneut anbinden und durchgängig testen

Telegram ist der häufigste Hermes-Kanal und der, der beim Übergang am leichtesten kaputtgeht. Sie brauchen das Bot-Token, die Liste der erlaubten Nutzer und alle kanalspezifischen Einstellungen wie Gruppen-IDs oder Nur-Admin-Flags. Hermes liest diese aus Umgebungsvariablen in ~/.hermes/.env. Nach dem Import muss das Gateway neu gestartet werden, bevor der Bot antwortet.

hermes status
hermes gateway restart

Wenn Sie Hermes noch nie auf Telegram bereitgestellt haben, behandelt die Setup-Anleitung für Hermes Agent auf Telegram die Bot-Erstellung und die Webhook-Details. Sobald das Gateway wieder läuft, führen Sie einen durchgängigen Test vom tatsächlichen Telegram-Client aus durch, nicht von hermes status. Senden Sie eine Nachricht, die den Speicherabruf prüft, eine Nachricht, die einen migrierten Skill prüft, und eine Nachricht, die Ihre Anbieter-Kette prüft. Wenn eine der drei fehlschlägt, beheben Sie es, bevor Sie irgendjemandem sagen, dass die Migration abgeschlossen ist.

Schritt 7: Fehlerbehebung der üblichen Verdächtigen

Realistischerweise werden Sie auf mindestens einen dieser Punkte stoßen. Planen Sie ihn ein.

Port-Konflikte: Sowohl das OpenClaw-Gateway als auch das Hermes-Gateway wollen einen Port. Wenn Sie sie während des Tests gemeinsam betrieben haben, stoppen Sie zuerst OpenClaw.
Anbieter-Auth-Fehler: fast immer ein snake_case-Fehler oder ein veralteter Schlüssel. Prüfen Sie api_key und base_url erneut, dann hermes status.
Fehlende oder inkompatible Skills: importierte Skills verweisen manchmal auf OpenClaw-exklusive Tools. Lesen Sie den fehlschlagenden Skill und schreiben Sie ihn entweder um oder entfernen Sie ihn.
Speicher-Kodierung: Wenn Ihre MEMORY.md von einer Windows-OpenClaw-Installation mit CRLF-Zeilenenden stammt, lassen Sie sie vor dem Kopieren durch dos2unix laufen.
Persona-Drift: Der Agent fühlt sich anders an, obwohl die Persona-Datei identisch ist. Prüfen Sie, dass Sie nicht zwei Persona-Dateien gleichzeitig laden und dass keine Hermes-Standard-Persona Ihre überschreibt.

Wenn etwas in hermes status funktioniert, aber nicht in Telegram, liegt das Problem fast immer am Gateway, nicht am Agenten.

Oder erledigen Sie all dies in unter 1 Minute mit Hermify

Lesen Sie die letzten sieben Abschnitte noch einmal durch. Das ist irgendwo zwischen einem fokussierten Wochenende und einer unfokussierten Woche voller Abende, je nachdem, wie sauber Ihr OpenClaw-Setup war, als Sie begonnen haben.

Hermify liefert im Dashboard einen OpenClaw-Migrationsassistenten mit einem Klick mit, der dieselbe Arbeit ohne das Wochenende erledigt. Sie laden Ihren OpenClaw-Export hoch, der Assistent zeigt eine Vorschau der Migration mit Zählungen für Persona, Skills, Speicher, Geheimnisse, Anbieter und Telegram an, bevor irgendetwas angewendet wird, und der Anwendungsschritt schreibt alles in eine verwaltete Hermes-Installation mit im Ruhezustand verschlüsselten Geheimnissen. Es gibt keinen Host bereitzustellen, keine snake_case-Übersetzung zu merken, kein Backup-Skript zu schreiben.

Der Artikel, den Sie gerade gelesen haben, ist das, was der Assistent unter der Haube durchläuft. Wenn der manuelle Weg die Erfahrung ist, die Sie wollen, sind die obigen Schritte korrekt und vollständig. Wenn das Ergebnis das ist, was Sie wollen, bringt Sie der Assistent in etwa einer Minute dorthin.

Starten Sie mit Hermify und migrieren Sie von OpenClaw, noch bevor das Wochenende kommt, das Sie dafür einplanen wollten.