Skip to main content
Der gebündelte Hermes-Migrations-Provider folgt HERMES_HOME und dem aktiven Hermes-Profil und greift unter macOS/Linux auf ~/.hermes beziehungsweise unter Windows auf %LOCALAPPDATA%\hermes zurück. Er zeigt jede Änderung vor der Anwendung in einer Vorschau an und schwärzt Secrets in Plänen und Berichten. Das eigenständige openclaw migrate schreibt ein verifiziertes Backup; beim neuen Onboarding-Pfad werden Konfiguration, Anmeldedaten und Dateien zunächst bereitgestellt und erst veröffentlicht, nachdem die importierte Inferenz erfolgreich verifiziert wurde. Ein expliziter --from-Pfad hat immer Vorrang.
Importe erfordern eine neue OpenClaw-Einrichtung. Wenn bereits ein lokaler OpenClaw-Zustand vorhanden ist, setzen Sie zunächst Konfiguration, Anmeldedaten, Sitzungen und den Workspace zurück oder verwenden Sie openclaw migrate apply hermes nach Prüfung des Plans direkt mit --overwrite.

​
Zwei Importmöglichkeiten

Erkennt das aktive Hermes-Home/-Profil und zeigt vor der Anwendung eine Vorschau an.
Oder geben Sie eine bestimmte Quelle an:

​
Was importiert wird

  • Standardmodellauswahl aus Hermes config.yaml.
  • Konfigurierte Modell-Provider und benutzerdefinierte Endpunkte aus model, providers und custom_providers, einschließlich der aktuellen Hermes-Transporte Chat Completions, Codex Responses und Anthropic Messages.
MCP-Serverdefinitionen aus mcp_servers oder mcp.servers, einschließlich Deaktivierungsstatus, Zeitüberschreitungen, Unterstützung paralleler Tools, OAuth-Geltungsbereich, kompatibler TLS-Felder und Richtlinien für native Tools, Ressourcen-Tools und Prompt-Tools. Literale Umgebungsvariablen und Header erfordern die Zustimmung zum Import von Anmeldedaten. Nur in Hermes vorhandene Einstellungen für Lebenszyklus, Sampling, Elicitation, Preflight, Keepalive, CA-Bundles, passwortgeschützte Client-Schlüssel und vorab registrierte OAuth-Clients werden anstelle einer ungültigen OpenClaw-Konfiguration zu Elementen für die manuelle Prüfung.
  • SOUL.md und AGENTS.md werden in den OpenClaw-Agent-Workspace kopiert.
  • memories/MEMORY.md und memories/USER.md werden an die entsprechenden OpenClaw-Speicherdateien angehängt, anstatt sie zu überschreiben.
  • Reine Speicheroberflächen verhalten sich anders: Die Speicherseite des Onboardings und die Seite für Speicherimporte in der Control UI kopieren diese beiden Dateien zur indizierten Erinnerung unter memory/imports/hermes/ und lassen den vorhandenen Workspace-Speicher unverändert.
Standardwerte der Speicherkonfiguration für den OpenClaw-Dateispeicher. Externe Speicher-Provider wie Honcho werden als Archiv- oder manuell zu prüfende Elemente erfasst, damit Sie sie gezielt verschieben können.
Skills mit einer SKILL.md-Datei an einer beliebigen Stelle unter skills/ werden rekursiv erkannt, in das Skill-Verzeichnis des OpenClaw-Workspace überführt und zusammen mit ihren unterstützenden Dateien kopiert. Skill-spezifische Konfigurationswerte aus skills.config bleiben erhalten.
Das interaktive openclaw migrate fragt vor dem Import von Authentifizierungsdaten nach, wobei „Ja“ standardmäßig ausgewählt ist. Akzeptierte Importe umfassen aktuelle OAuth-Einträge für Hermes OpenAI Codex, OpenAI-OAuth- und GitHub-Copilot-Einträge aus OpenCode sowie die unterstützten Hermes-Schlüssel .env. Verwenden Sie --include-secrets für einen nicht interaktiven Import, --no-auth-credentials, um Anmeldedaten zu überspringen, oder das Onboarding-Flag --import-secrets. Lassen Sie Hermes und OpenClaw nach dem Import von Hermes-OAuth nicht denselben Refresh Grant verwenden; authentifizieren Sie eine Seite erneut, bevor beide gleichzeitig ausgeführt werden.

​
Was ausschließlich archiviert wird

Der Provider kopiert Folgendes zur manuellen Prüfung in das Verzeichnis des Migrationsberichts, lädt es jedoch nicht in die aktive OpenClaw-Konfiguration oder die Anmeldedaten:
  • plugins/
  • sessions/
  • logs/
  • cron/
  • mcp-tokens/
  • plans/, workspace/, skins/ und kanban/
  • pairing/- und platforms/-Speicher sowie Gateway-Routing- und Prozesszustand
  • state.db, hermes_state.db, projects.db, response_store.db, memory_store.db, verification_evidence.db, kanban.db und retaindb_queue.db
OpenClaw weigert sich, diesen Zustand automatisch auszuführen oder ihm zu vertrauen, da Formate und Vertrauensannahmen zwischen Systemen voneinander abweichen können. Verschieben Sie die benötigten Elemente nach Prüfung des Archivs manuell.

​
Empfohlener Ablauf

1

Planvorschau anzeigen

Der Plan führt alle Änderungen auf, einschließlich Konflikten, übersprungenen Elementen und sensiblen Elementen. Verschachtelte Schlüssel, die wie Secrets aussehen, werden in der Ausgabe geschwärzt.
2

Mit Backup anwenden

OpenClaw erstellt und verifiziert vor der Anwendung ein Backup. Dieses nicht interaktive Beispiel importiert ausschließlich nicht geheimen Zustand. Führen Sie den Befehl ohne --yes aus, um die Abfrage zu Anmeldedaten interaktiv zu beantworten, oder fügen Sie --include-secrets hinzu, um unterstützte Anmeldedaten in eine unbeaufsichtigte Ausführung einzubeziehen.
3

Doctor ausführen

Doctor wendet ausstehende Konfigurationsmigrationen erneut an und prüft auf Probleme, die während des Imports entstanden sind.
4

Neu starten und überprüfen

Vergewissern Sie sich, dass das Gateway fehlerfrei funktioniert und Ihr importiertes Modell, Ihr Speicher und Ihre Skills geladen sind.

​
Konfliktbehandlung

Die Anwendung wird nicht fortgesetzt, wenn der Plan Konflikte meldet (eine Datei oder ein Konfigurationswert ist am Ziel bereits vorhanden).
Führen Sie den Vorgang nur dann erneut mit --overwrite aus, wenn das vorhandene Ziel absichtlich ersetzt werden soll. Provider können für überschriebene Dateien dennoch Backups auf Elementebene in das Verzeichnis des Migrationsberichts schreiben.
Bei einer neuen Installation sind Konflikte ungewöhnlich. Sie treten üblicherweise auf, wenn Sie den Import für eine Einrichtung erneut ausführen, die bereits Benutzeränderungen enthält. Wenn während der Anwendung ein Konflikt auftritt (beispielsweise durch einen unerwarteten Wettlauf bei einer Konfigurationsdatei), wird das betreffende Element als Konflikt gemeldet, während unabhängige Dateien, Skills, Anmeldedaten, Archive und Konfigurationseinträge weiterverarbeitet werden. Beheben Sie das in Konflikt stehende Element und führen Sie den Import erneut aus; identische Speicherimporte sind idempotent.

​
Secrets

Das interaktive openclaw migrate fragt, ob erkannte Authentifizierungsdaten importiert werden sollen, wobei „Ja“ standardmäßig ausgewählt ist.
  • Bei Zustimmung werden aktuelle OAuth-Einträge für Hermes OpenAI Codex, OpenAI-OAuth- und GitHub-Copilot-Einträge aus OpenCode sowie die unterstützten Schlüssel .env importiert.
  • Verwenden Sie --no-auth-credentials oder antworten Sie bei der Abfrage mit „Nein“, um ausschließlich nicht geheimen Zustand zu importieren.
  • Verwenden Sie --include-secrets, um Anmeldedaten bei einer unbeaufsichtigten Ausführung von --yes zu importieren.
  • Verwenden Sie das Flag --import-secrets des Onboarding-Assistenten, um Anmeldedaten über den Assistenten zu importieren.

​
JSON-Ausgabe für die Automatisierung

Mit --json und ohne --yes gibt die Anwendung den Plan aus und verändert keinen Zustand – der sicherste Modus für CI und gemeinsam genutzte Skripte.

​
Fehlerbehebung

Prüfen Sie die Planausgabe. Jeder Konflikt gibt den Quellpfad und das vorhandene Ziel an. Entscheiden Sie für jedes Element, ob es übersprungen, das Ziel bearbeitet oder der Vorgang mit --overwrite erneut ausgeführt werden soll.
Übergeben Sie --from /actual/path (CLI) oder --import-source /actual/path (Onboarding).
Onboarding-Importe erfordern eine neue Einrichtung. Setzen Sie entweder den Zustand zurück und führen Sie das Onboarding erneut durch oder verwenden Sie openclaw migrate apply hermes direkt. Dies unterstützt --overwrite und eine explizite Backup-Steuerung.
Das interaktive openclaw migrate importiert API-Schlüssel nur, wenn Sie der Abfrage zu Anmeldedaten zustimmen. Nicht interaktive Ausführungen von --yes benötigen --include-secrets; Onboarding-Importe benötigen --import-secrets. Nur die unterstützten Schlüssel .env werden erkannt – andere Variablen von .env werden ignoriert.

​
Verwandte Themen

  • openclaw migrate: vollständige CLI-Referenz, Plugin-Vertrag und JSON-Strukturen.
  • Onboarding: Ablauf des Assistenten und nicht interaktive Flags.
  • Migration: Verschieben einer OpenClaw-Installation zwischen Computern.
  • Doctor: Zustandsprüfung nach der Migration.
  • Agent-Workspace: Speicherort von SOUL.md, AGENTS.md und Speicherdateien.