Claude Code / Hermes → OpenClaw 2026: Vollständiger Migrationsleitfaden mit openclaw migrate auf Mac mini M4

OpenClaw v2026.4.26, veröffentlicht am 28. April 2026, bringt eine lang ersehnte Funktion: openclaw migrate — ein Befehl, der die Konfiguration Ihres KI-Coding-Agenten aus Claude Code oder Hermes in einem Batch-Vorgang nach OpenClaw importiert. Wenn Sie MCP-Serververbindungen, benutzerdefinierte Skills und Workflow-Anpassungen in Claude Code oder Hermes aufgebaut haben, können Sie jetzt nach OpenClaw migrieren, ohne jede Einstellung manuell neu zu erstellen. Dieser Leitfaden deckt den gesamten Prozess auf einem VpsGona Mac mini M4-Knoten ab — was automatisch migriert wird, was manuelle Arbeit erfordert und wie die 6 häufigsten Post-Migrations-Fehler behoben werden.

Warum Entwickler 2026 von Claude Code und Hermes zu OpenClaw wechseln

Der Trend hat sich seit Anfang 2026 beschleunigt. Die Gründe liegen in konkreten Produktlücken, nicht im Marketing. Sie zu verstehen hilft Ihnen zu beurteilen, ob die Migration zu Ihrem Workflow passt.

Grund 1: Nativer Multi-Agent-Orchestrierung ohne Plugin-Hacks. Claude Codes Multi-Agent-Unterstützung erfordert Workarounds und ist auf das Modell-Routing von Anthropic beschränkt. OpenClaws natives Multi-Agent-Framework (ClawHub) orchestriert unabhängige Agent-Prozesse mit einem gemeinsamen Memory-Wiki-Zustandslayer bei jedem Modellanbieter.

Grund 2: OpenClaws OTEL-Observability ist von Produktionsqualität. Seit v2026.4.25 gibt OpenClaw strukturierte Telemetrie für jeden Modellaufruf, Werkzeugaufruf und Speicherzugriff aus. Claude Code und Hermes haben keine gleichwertige strukturierte Observability. Teams, die Token-Kostenzuordnung, Werkzeugschleifen-Erkennung und Speicherdruck-Warnungen benötigen — insbesondere für unbemannte nächtliche autonome Agents — werden anderswo keine vergleichbare Funktionalität finden.

Grund 3: Anbieter-Neutralität und gebündelter Cerebras-Support. OpenClaw v2026.4.26 fügt Cerebras als gebündelten Anbieter hinzu und schließt sich OpenAI, Anthropic, Gemini, DeepSeek und lokalen Ollama-Modellen an. Claude Code ist strukturell an Anthropics API gebunden. Hermes bietet Anbieterflexibilität, aber das Plugin-SDK erreicht nicht die Reife der OpenClaw v2026-Releases.

Was openclaw migrate in v2026.4.26 tatsächlich macht

Der Befehl openclaw migrate führt einen strukturierten Scan des Konfigurationsverzeichnisses des Quell-Tools durch, extrahiert kompatible Konfigurationen, konvertiert sie in das OpenClaw-Konfigurationsformat und schreibt sie. Es werden keine Konversationsverläufe oder Sitzungslogs kopiert — nur Konfiguration, Funktionsdefinitionen und Verbindungsmetadaten werden migriert.

Der Migrationsprozess läuft in drei Phasen:

1. Erkennungsphase: OpenClaw scannt das Quell-Konfigurationsverzeichnis (~/.claude/ für Claude Code, ~/.hermes/ für Hermes), um installierte MCP-Server, benutzerdefinierte Skills/Werkzeuge, API-Schlüssel-Referenzen und Anbieter-Konfiguration zu erkennen.
2. Konvertierungsphase: Jedes erkannte Element wird auf sein OpenClaw-Äquivalent gemappt. MCP-Server-Definitionen werden im OpenClaw-Plugin-Manifest-Format neu ausgedrückt, API-Schlüssel-Umgebungsvariablennamen werden aliasiert und benutzerdefinierte Werkzeugdefinitionen werden im OpenClaw-Skill-Schema eingebettet.
3. Berichtsphase: Ein JSON-Migrationsbericht wird in ~/.openclaw/migrate-report.json geschrieben, der jedes erfolgreich migrierte Element, jedes teilweise migrierte Element (das manuelle Vervollständigung erfordert) und jedes nicht migrierfähige Element auflistet.

Konfigurationselement	Migration von Claude Code	Migration von Hermes	Hinweise
MCP-Server-Endpunkt-Definitionen	✓ Automatisch	✓ Automatisch	Verbindungs-URIs und Auth-Header werden beibehalten
Benutzerdefinierte Skill/Werkzeug-Definitionen	✓ Automatisch	✓ Automatisch	In OpenClaw-Skill-Schema eingebettet; nach Migration testen
API-Schlüssel-Umgebungsvariablen-Referenzen	✓ Auto-Alias	✓ Auto-Alias	Tatsächliche Schlüsselwerte werden nicht gelesen; Aliase in .env erstellt
System-Prompt-Anpassungen	⚠ Partiell (Prüfung nötig)	⚠ Partiell (Prüfung nötig)	Operator-ID-Format unterscheidet sich zwischen Tools
Modellanbieter-Konfiguration	⚠ Partiell (nur Anthropic)	✓ Automatisch (Multi-Anbieter)	Nicht-Anthropic-Anbieter von Claude Code nicht migriert
Speicher/Wissensdatenbank-Inhalt	✗ Nicht migriert	✗ Nicht migriert	Manuelles Re-Ingestion in OpenClaw Memory-Wiki erforderlich
Konversations-/Sitzungsverlauf	✗ Nicht migriert	✗ Nicht migriert	Konstruktionsbedingt — OpenClaw-Sitzungsformat ist inkompatibel
TaskFlow/Webhook-Definitionen	✗ k.A. (in Claude Code nicht vorhanden)	⚠ Partiell	Hermes-Workflows erfordern manuelles Mapping zu TaskFlows

Prüf-Checkliste: 7 Punkte vor dem Ausführen des Befehls

Das Ausführen von openclaw migrate ohne Vorbereitung ist die Ursache der meisten Post-Migrations-Probleme. Prüfen Sie alle 7 Punkte, bevor Sie den Migrationsbefehl ausführen.

1. Bestätigen, dass OpenClaw-Version ≥ 2026.4.26 ist. Der migrate-Unterbefehl existiert nicht in früheren Versionen. Mit openclaw --version prüfen und mit npx openclaw@latest update oder /update im Agent aktualisieren.
2. Quell-Tool-Konfigurationsverzeichnis sichern. cp -r ~/.claude/ ~/claude-backup-$(date +%Y%m%d)/ (Claude Code) oder das Hermes-Äquivalent ausführen. Der Migrationsbefehl ist schreibgeschützt, aber ein datiertes Backup gibt Sicherheit bei Problemen.
3. Aktive MCP-Server auflisten. /mcp in Claude Code ausführen und Namen und Verbindungstypen der verbundenen MCP-Server notieren. Diese Liste wird später verwendet, um die Abdeckung im Migrationsbericht zu verifizieren.
4. Benutzerdefinierte System-Prompt-Anpassungen dokumentieren. Falls Sie Operator-IDs, Persona-Anweisungen oder Sicherheitsüberschreibungen geändert haben, diese in eine Textdatei kopieren. Das sind die Elemente, die nach der Migration am wahrscheinlichsten eine manuelle Prüfung benötigen.
5. Node.js ≥ 20 auf dem Mac mini M4-Knoten prüfen. migrate nutzt die native fetch-API von Node.js, die Node 20+ erfordert. Mit node --version prüfen.
6. Aktuell verwendete API-Anbieter inventarisieren. Falls Sie in Hermes mehrere Anbieter (OpenAI + Gemini + Cerebras usw.) konfiguriert haben, vor der Migration prüfen, dass sie alle in OpenClaws Liste der gebündelten Anbieter vorhanden sind. Fehlende Anbieter erscheinen im Bericht als „manual-required".
7. Ausreichend Speicherplatz auf dem Mac mini M4-Knoten sicherstellen. Der Migrationsprozess schreibt Berichte und konvertierte Konfigurationsdateien in ~/.openclaw/. 500 MB freier Speicherplatz reichen für die meisten Konfigurationen.

Schritt für Schritt: Migration von Claude Code auf Mac mini M4

Die folgenden Schritte setzen voraus, dass Sie eine aktive VpsGona Mac mini M4-Sitzung mit installierten Claude Code und OpenClaw v2026.4.26+ haben. SSH-Verbindung zum Knoten herstellen und folgendes ausführen:

1. Bestätigen, dass beide Tools in den richtigen Versionen vorhanden sind:

   openclaw --version # muss ≥ 2026.4.26 sein claude --version # Claude Code-Installation bestätigen

2. Migrationsbefehl mit Angabe von Claude Code ausführen:

   openclaw migrate --from claude-code

   OpenClaw erkennt ~/.claude/ automatisch. Falls die Claude Code-Konfiguration an einem nicht-standardmäßigen Ort liegt, mit --source explizit angeben:

   openclaw migrate --from claude-code --source /benutzerdefinierter-pfad/.claude/

3. Migrations-Ausgabe prüfen. Die CLI gibt in Echtzeit jedes erkannte Element aus. Das Präfix ✓ zeigt eine erfolgreiche Migration an, ⚠ erfordert Prüfung, ✗ ist nicht migrierbar:

   Discovered: 8 MCP servers, 12 custom tools, 3 system prompt blocks, 1 provider config ✓ MCP server: filesystem-mcp → migrated ✓ MCP server: github-mcp → migrated ⚠ System prompt block 'persona' → manual-required (format differs) ⚠ Provider: anthropic → partial ✗ Memory content → not migrated (re-ingest manually) Migration complete. Report: ~/.openclaw/migrate-report.json

4. Vollständigen Migrationsbericht prüfen:

   cat ~/.openclaw/migrate-report.json | python3 -m json.tool | head -80

5. OpenClaw starten und MCP-Verbindungen prüfen:

   openclaw start /mcp status

   Jeder migrierte MCP-Server sollte einen grünen Verbindungsstatus anzeigen. Für nicht verbundene Server den Fehlerbehebungsabschnitt unten konsultieren.

Schritt für Schritt: Migration von Hermes zu OpenClaw

Die Hermes-Migration folgt demselben Muster, aber mit einem anderen --from-Flag und Hermes-spezifischen Überlegungen. Hermes speichert seine Konfiguration standardmäßig in ~/.hermes/ und verwendet ein YAML-Format, das das OpenClaw-Migrationstool direkt lesen kann.

1. Hermes-Migration ausführen:

   openclaw migrate --from hermes

   Für Hermes-Workspaces (projektbezogene Konfiguration) das Workspace-Verzeichnis angeben:

   openclaw migrate --from hermes --source /pfad/zum/hermes-workspace/

2. Hermes-Workflow-Definitionen manuell verarbeiten. Hermes' „Workflow"-Struktur mappt partiell auf OpenClaws TaskFlows. Das Migrationstool konvertiert Auslöser und Schrittstruktur, kann die Verzweigungslogik jedoch nicht automatisch replizieren. Nach der Migration jedes markierte Workflow im OpenClaw TaskFlow-Editor öffnen und prüfen, ob Verzweigungsbedingungen korrekt ausgedrückt sind.
3. Multi-Anbieter-Konfiguration neu einrichten. Falls Sie in Hermes mehrere Modellanbieter verwendet haben, sicherstellen, dass jeder in der OpenClaw-Konfiguration aktiv ist:

   openclaw config list-providers

   Fehlende Anbieter hinzufügen:

   openclaw config add-provider cerebras --api-key $CEREBRAS_API_KEY

4. Memory-Wiki-Inhalt neu einpflegen. Hermes-Speicherinhalt muss in OpenClaws Memory-Wiki neu eingepflegt werden. Für kleine Wissensbasen (weniger als 50 Dokumente) /learn-Befehl interaktiv verwenden. Für größere Basen Batch-Ingest-API verwenden:

   openclaw memory ingest --dir /pfad/zu/hermes/wissen/ --format markdown

Migrationsumfang: Automatisch vs. manuelle Einrichtung erforderlich

Elementkategorie	Automatische Migration?	Erforderliche manuelle Arbeit
MCP-Server-Endpunkte und Authentifizierung	✓ Ja	Keine, wenn Verbindung erfolgreich; bei abgelaufenem Token neu authentifizieren
Benutzerdefinierte Werkzeug/Skill-Definitionen	✓ Ja	Nach Schema-Konvertierung jedes Werkzeug manuell ausführen und Funktion prüfen
API-Schlüssel-Umgebungsvariablen-Aliase	✓ Ja (nur Aliase)	Prüfen, dass echte Schlüssel in ~/.openclaw/.env oder Systemumgebung vorhanden sind
System-Prompt-Operator-IDs	⚠ Partiell	Gemäß OpenClaw-Operatorformat prüfen und neu schreiben
Modellanbieter-Konfiguration	⚠ Partiell	Bei Claude Code-Migration nicht-Anthropic-Anbieter manuell hinzufügen
Hermes-Workflow-Bedingungen	⚠ Partiell	Bedingte Verzweigung manuell in TaskFlow-Schema konvertieren
Speicher/Wissensdatenbank-Inhalt	✗ Keine	Alle Dokumente via /learn oder Batch-Ingest neu einpflegen
Konversationsverlauf	✗ Keine	Nicht erforderlich — Verlauf ist tool-spezifisch und nicht portierbar
Matrix E2EE-Konfiguration (neu in v2026.4.26)	✗ k.A. (neue Funktion)	Von Grund auf konfigurieren: openclaw security matrix --setup

Post-Migrations-Fehlerbehebung: 6 häufige Fehler und Korrekturen

Fehler 1: MCP-Server zeigen nach Migration „getrennt" an. Die häufigste Ursache ist der Ablauf von Authentifizierungs-Tokens. MCP-Server speichern Token-Referenzen, aber nicht die tatsächlichen Token-Werte — die ablaufen. Lösung: MCP-Server-Authentifizierungseinstellungen im OpenClaw-Kontrollpanel öffnen und neu authentifizieren.

Fehler 2: openclaw migrate: source directory not found. Claude Code kann an einem nicht-standardmäßigen Ort installiert sein. Mit find ~ -name ".claude" -type d 2>/dev/null finden und mit --source explizit angeben.

Fehler 3: schema validation error bei Aufrufen benutzerdefinierter Werkzeuge. Das Migrationstool bettet Werkzeuge im OpenClaw-Skill-Schema ein, aber einige Werkzeug-Parametertypen haben keine genauen Äquivalente. Werkzeug-Parameterdefinitionen in ~/.openclaw/skills/ prüfen und Typdeklarationen an OpenClaws Schema anpassen (string, number, boolean, array, object).

Fehler 4: Hänger beim Start nach Migration (bekannter Bug v2026.4.26). Einige Nutzer berichten von Startverzögerungen nach dem Update auf v2026.4.26 bei vielen konfigurierten MCP-Servern. Bekannter Bug durch synchrone Verbindungsinitialisierung. Umgehung: Nicht wesentliche MCP-Server temporär in openclaw.config.js deaktivieren und nach erfolgreichem Start schrittweise reaktivieren.

Fehler 5: ENOENT: no such file or directory, open '~/.openclaw/.env'. Das Migrationstool setzt voraus, dass .env existiert. Manuell erstellen und echte Schlüssel eintragen:

touch ~/.openclaw/.env echo "ANTHROPIC_API_KEY=ihr-schlüssel-hier" >> ~/.openclaw/.env echo "OPENAI_API_KEY=ihr-schlüssel-hier" >> ~/.openclaw/.env

Fehler 6: Ollama-Verbindung schlägt nach Migration fehl. OpenClaw v2026.4.26 hat die Ollama-Zuverlässigkeit für Qwen- und Gemma 4-Modelle speziell verbessert. Falls eine in Hermes funktionierende Ollama-Verbindung in OpenClaw fehlschlägt, prüfen, ob Ollama 0.22.0 oder neuer läuft:

ollama --version # muss ≥ 0.22.0 sein ollama serve # sicherstellen, dass Ollama vor OpenClaw-Start läuft

Migrierte OpenClaw-Konfiguration auf Mac mini M4 optimieren

Sobald die Migration stabil ist und alle MCP-Server verbunden sind, gibt es vier Optimierungen, die besonders vorteilhaft für ein Mac mini M4-Deployment sind:

• maxContextTokens gemäß tatsächlich genutzten Modellen setzen. Die migrierte Konfiguration erbt eine generische Kontextfenstergröße. Auf einem Mac mini M4 mit 16 GB Unified Memory ist Claude 3.7 Sonnets 200K-Kontextfenster speicherintensiv. Für typische Coding-Aufgaben reduziert maxContextTokens: 32768 in openclaw.config.js den Speicherdruck erheblich und deckt fast alle realen Coding-Sitzungen ab.
• Neues JSON5-Ausstehende-Änderungen-Diff-Panel aktivieren. Neue Funktion von v2026.4.26, die ein strukturiertes Diff anzeigt, bevor der Agent Dateiänderungen committet. Besonders nützlich, wenn Sie das Arbeitsverzeichnis aus einer Remote-Mac mini M4-Sitzung nicht in Echtzeit überwachen können:

  // In openclaw.config.js ui: { pendingChangesDiff: true, diffFormat: 'json5' }

• Cerebras-Anbieter für geschwindigkeitspriorisierte Aufgaben konfigurieren. Cerebras wurde in v2026.4.26 gebündelter Anbieter. Bei Aufgaben, wo Antwortgeschwindigkeit Ausgabelänge überwiegt — schnelle Code-Erklärungen, Typannotations-Vorschläge, Testfall-Generierung — bieten Cerebras-Modelle erheblich niedrigere Zeit-bis-erstem-Token als Anthropic oder OpenAI bei ähnlichem Qualitätsniveau.
• Matrix E2EE für sichere Remote-Sitzungen konfigurieren. Neue Funktion, die weder Claude Code noch Hermes hat. Wenn Sie OpenClaw auf einem VpsGona-Knoten ausführen, werden alle Daten bereits via SSH übertragen, aber das Hinzufügen von Matrix E2EE fügt Ende-zu-Ende-Verschlüsselung auf Anwendungsebene hinzu:

  openclaw security matrix --setup

Warum VpsGonas Mac mini M4 die ideale Zielumgebung für die OpenClaw-Migration ist

Die Migration zu OpenClaw ist eine Konfigurationsänderung; wo Sie OpenClaw ausführen, bestimmt, ob die Migration ihren vollen Wert entfaltet. Für Entwickler, die Claude Code oder Hermes auf einem persönlichen Laptop oder Desktop betrieben haben, verändert die Migration zu OpenClaw auf einem VpsGona Mac mini M4-Knoten die Situation konkret in mehreren Punkten.

Erstens ist die Apple Silicon-Architektur des Mac mini M4 nativ kompatibel mit allen macOS-only-MCP-Servern und Werkzeugen, die Claude Code-Nutzer aufgebaut haben. Dateisystemzugriff, Xcode-Integration, macOS-Automatisierung via AppleScript oder Kurzbefehle, lokale Modell-Inferenz via CoreML — alles funktioniert wie vorgesehen auf dem M4-Chip. Die Migration Ihrer MCP-Server-Konfiguration bringt Sie in eine Umgebung mit exakt demselben OS und Chip-Architektur, für die sie entworfen wurde.

Zweitens entspricht VpsGonas Mietmodell ohne Mindestlaufzeit natürlich OpenClaws Nutzungsmustern. OpenClaws leistungsstärkste Funktionen — Multi-Agent-Orchestrierung via ClawHub, OTEL-Observability, unbemannte nächtliche Agents — haben den größten Wert, wenn sie kontinuierlich auf einem dedizierten Knoten laufen, nicht intermittierend auf einer persönlichen Maschine. Einen Mac mini M4-Knoten für OpenClaw-Workloads pro Projektzyklus zu mieten, liefert native Apple Silicon-Leistung für einen Bruchteil der Kosten dedizierter Server-Alternativen. Aktuelle Knotenpreise und Verfügbarkeit auf der VpsGona-Preisseite, Einrichtung der OpenClaw-Umgebung in der Deployment-Dokumentation.