Zum Hauptinhalt springen
OpenClaw importiert den Hermes-Zustand über einen gebündelten Migrations-Provider. Der Provider zeigt vor jeder Zustandsänderung eine Vorschau an, schwärzt Geheimnisse in Plänen und Berichten und erstellt vor der Anwendung ein verifiziertes Backup.
Importe erfordern eine frische OpenClaw-Einrichtung. Wenn Sie bereits lokalen OpenClaw-Zustand haben, setzen Sie zuerst Konfiguration, Anmeldedaten, Sitzungen und den Arbeitsbereich zurück, oder verwenden Sie openclaw migrate direkt mit --overwrite, nachdem Sie den Plan geprüft haben.

​
Zwei Wege zum Import

Der schnellste Weg. Der Assistent erkennt Hermes unter ~/.hermes und zeigt vor der Anwendung eine Vorschau an.
openclaw onboard --flow import
Oder geben Sie eine bestimmte Quelle an:
openclaw onboard --import-from hermes --import-source ~/.hermes

​
Was importiert wird

  • Standardmäßige Modellauswahl aus Hermes config.yaml.
  • Konfigurierte Modell-Provider und benutzerdefinierte OpenAI-kompatible Endpunkte aus providers und custom_providers.
MCP-Serverdefinitionen aus mcp_servers oder mcp.servers.
  • SOUL.md und AGENTS.md werden in den OpenClaw-Agent-Arbeitsbereich kopiert.
  • memories/MEMORY.md und memories/USER.md werden an die passenden OpenClaw-Speicherdateien angehängt, statt sie zu überschreiben.
Standards für die Speicherkonfiguration für OpenClaw-Dateispeicher. Externe Speicher-Provider wie Honcho werden als Archiv- oder Elemente für die manuelle Prüfung erfasst, damit Sie sie bewusst verschieben können.
Skills mit einer SKILL.md-Datei unter skills/<name>/ werden zusammen mit den Skill-spezifischen Konfigurationswerten aus skills.config kopiert.
Das interaktive openclaw migrate fragt vor dem Import von Auth-Anmeldedaten, wobei Ja standardmäßig ausgewählt ist. Akzeptierte Importe umfassen OpenCode-OpenAI-OAuth-Anmeldedaten aus OpenCode auth.json, OpenCode- und GitHub-Copilot-Einträge aus OpenCode auth.json sowie die unterstützten .env-Schlüssel. Hermes-auth.json-OAuth-Einträge sind Legacy-Zustand und werden als manuelle Reauthentifizierung oder Doctor-Arbeit angezeigt, statt in die Live-Authentifizierung importiert zu werden. Verwenden Sie --include-secrets für den nicht interaktiven Import von Anmeldedaten mit openclaw migrate, --no-auth-credentials, um ihn zu überspringen, oder beim Import über den Onboarding-Assistenten --import-secrets.

​
Was nur archiviert bleibt

Der Provider kopiert diese Elemente zur manuellen Prüfung in das Verzeichnis des Migrationsberichts, lädt sie aber nicht in die Live-Konfiguration oder Anmeldedaten von OpenClaw:
  • plugins/
  • sessions/
  • logs/
  • cron/
  • mcp-tokens/
  • state.db
OpenClaw weigert sich, diesen Zustand automatisch auszuführen oder ihm zu vertrauen, weil sich Formate und Vertrauensannahmen zwischen Systemen unterscheiden können. Verschieben Sie nach der Prüfung des Archivs von Hand, was Sie benötigen.

​
Empfohlener Ablauf

1

Plan in der Vorschau prüfen

openclaw migrate hermes --dry-run
Der Plan listet alles auf, was geändert wird, einschließlich Konflikten, übersprungenen Elementen und sensiblen Elementen. Die Planausgabe schwärzt verschachtelte Schlüssel, die wie Geheimnisse aussehen.
2

Mit Backup anwenden

openclaw migrate apply hermes --yes
OpenClaw erstellt und verifiziert vor der Anwendung ein Backup. Dieses nicht interaktive Beispiel importiert nicht geheime Zustände. Führen Sie den Befehl ohne --yes aus, um die Abfrage zu Anmeldedaten zu beantworten, oder fügen Sie --include-secrets hinzu, um unterstützte Anmeldedaten in unbeaufsichtigten Läufen einzuschließen.
3

Doctor ausführen

openclaw doctor
Doctor wendet ausstehende Konfigurationsmigrationen erneut an und prüft auf Probleme, die während des Imports eingeführt wurden.
4

Neu starten und verifizieren

openclaw gateway restart
openclaw status
Bestätigen Sie, dass der Gateway fehlerfrei ist und Ihr importiertes Modell, Ihr Speicher und Ihre Skills geladen sind.

​
Konfliktbehandlung

Die Anwendung wird nicht fortgesetzt, wenn der Plan Konflikte meldet, also wenn eine Datei oder ein Konfigurationswert am Ziel bereits vorhanden ist.
Führen Sie den Vorgang nur dann erneut mit --overwrite aus, wenn das Ersetzen des vorhandenen Ziels beabsichtigt ist. Provider können weiterhin Backups auf Elementebene für überschriebene Dateien im Verzeichnis des Migrationsberichts schreiben.
Bei einer frischen OpenClaw-Installation sind Konflikte ungewöhnlich. Sie treten typischerweise auf, wenn Sie den Import auf einer Einrichtung erneut ausführen, die bereits Benutzeränderungen enthält. Wenn mitten in der Anwendung ein Konflikt auftritt, zum Beispiel ein unerwartetes Race bei einer Konfigurationsdatei, markiert Hermes die verbleibenden abhängigen Konfigurationselemente als skipped mit dem Grund blocked by earlier apply conflict, statt sie teilweise zu schreiben. Der Migrationsbericht erfasst jedes blockierte Element, damit Sie den ursprünglichen Konflikt beheben und den Import erneut ausführen können.

​
Geheimnisse

Das interaktive openclaw migrate fragt, ob erkannte Auth-Anmeldedaten importiert werden sollen, wobei Ja standardmäßig ausgewählt ist.
  • Wenn Sie die Abfrage akzeptieren, werden OpenCode-OpenAI-OAuth-Anmeldedaten aus OpenCode auth.json, OpenCode- und GitHub-Copilot-Einträge aus OpenCode auth.json sowie die unterstützten .env-Schlüssel importiert. Hermes-auth.json-OAuth-Einträge werden für manuelle OpenAI-Reauthentifizierung oder Doctor-Reparatur gemeldet.
  • Verwenden Sie --no-auth-credentials oder wählen Sie in der Abfrage Nein, um nur nicht geheimen Zustand zu importieren.
  • Verwenden Sie --include-secrets, wenn Sie unbeaufsichtigt mit --yes ausführen.
  • Verwenden Sie beim Import von Anmeldedaten über den Onboarding-Assistenten --import-secrets.
  • Konfigurieren Sie bei SecretRef-verwalteten Anmeldedaten die SecretRef-Quelle, nachdem der Import abgeschlossen ist.

​
JSON-Ausgabe für Automatisierung

openclaw migrate hermes --dry-run --json
openclaw migrate apply hermes --json --yes
Mit --json und ohne --yes gibt die Anwendung den Plan aus und verändert den Zustand nicht. Dies ist der sicherste Modus für CI und gemeinsam genutzte Skripte.

​
Fehlerbehebung

Prüfen Sie die Planausgabe. Jeder Konflikt identifiziert den Quellpfad und das vorhandene Ziel. Entscheiden Sie pro Element, ob Sie es überspringen, das Ziel bearbeiten oder erneut mit --overwrite ausführen.
Übergeben Sie --from /actual/path (CLI) oder --import-source /actual/path (Onboarding).
Onboarding-Importe erfordern eine frische Einrichtung. Setzen Sie entweder den Zustand zurück und führen Sie das Onboarding erneut aus, oder verwenden Sie direkt openclaw migrate apply hermes, das --overwrite und explizite Backup-Steuerung unterstützt.
Das interaktive openclaw migrate importiert API-Schlüssel nur, wenn Sie die Abfrage zu Anmeldedaten akzeptieren. Nicht interaktive Läufe mit --yes erfordern --include-secrets; Onboarding-Importe erfordern --import-secrets. Nur die unterstützten .env-Schlüssel werden erkannt; andere Variablen in .env werden ignoriert.

​
Verwandte Themen

  • openclaw migrate: vollständige CLI-Referenz, Plugin-Vertrag und JSON-Formen.
  • Onboarding: Assistentenablauf und nicht interaktive Flags.
  • Migration: eine OpenClaw-Installation zwischen Maschinen verschieben.
  • Doctor: Integritätsprüfung nach der Migration.
  • Agent-Arbeitsbereich: wo SOUL.md, AGENTS.md und Speicherdateien liegen.