Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw importiert den Hermes-Zustand über einen gebündelten Migrations-Provider. Der Provider zeigt vor jeder Zustandsänderung eine Vorschau an, redigiert Geheimnisse in Plänen und Berichten und erstellt vor der Anwendung ein verifiziertes Backup.
Importe erfordern eine frische OpenClaw-Einrichtung. Wenn bereits lokaler OpenClaw-Zustand vorhanden ist, 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 Möglichkeiten für den 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

  • Standard-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.
Standardwerte der Speicherkonfiguration für den OpenClaw-Dateispeicher. Externe Speicher-Provider wie Honcho werden als Archiv- oder manuell zu prüfende Einträge erfasst, damit Sie sie bewusst migrieren können.
Skills mit einer SKILL.md-Datei unter skills/<name>/ werden zusammen mit Skill-spezifischen Konfigurationswerten aus skills.config kopiert.
Setzen Sie --include-secrets, um unterstützte .env-Schlüssel zu importieren: OPENAI_API_KEY, ANTHROPIC_API_KEY, OPENROUTER_API_KEY, GOOGLE_API_KEY, GEMINI_API_KEY, GROQ_API_KEY, XAI_API_KEY, MISTRAL_API_KEY, DEEPSEEK_API_KEY. Ohne das Flag werden Geheimnisse nie kopiert.

​
Was nur im Archiv bleibt

Der Provider kopiert diese Einträge zur manuellen Prüfung in das Migrationsberichtsverzeichnis, lädt sie aber nicht in die aktive OpenClaw-Konfiguration oder die Anmeldedaten:
  • plugins/
  • sessions/
  • logs/
  • cron/
  • mcp-tokens/
  • auth.json
  • state.db
OpenClaw weigert sich, diesen Zustand automatisch auszuführen oder ihm zu vertrauen, weil Formate und Vertrauensannahmen zwischen Systemen abweichen können. Verschieben Sie benötigte Inhalte nach der Prüfung des Archivs manuell.

​
Empfohlener Ablauf

1

Plan in der Vorschau anzeigen

openclaw migrate hermes --dry-run
Der Plan listet alles auf, was geändert wird, einschließlich Konflikten, übersprungener Einträge und sensibler Einträge. Die Planausgabe redigiert 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. Wenn API-Schlüssel importiert werden sollen, fügen Sie --include-secrets hinzu.
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 prüfen

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 verweigert, wenn der Plan Konflikte meldet (eine Datei oder ein Konfigurationswert existiert bereits am Ziel).
Führen Sie den Befehl nur dann mit --overwrite erneut aus, wenn das Ersetzen des vorhandenen Ziels beabsichtigt ist. Provider können weiterhin Backups auf Eintragsebene für überschriebene Dateien im Migrationsberichtsverzeichnis 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 während der Anwendung ein Konflikt auftritt (zum Beispiel ein unerwarteter Wettlauf um eine Konfigurationsdatei), markiert Hermes verbleibende abhängige Konfigurationseinträge als skipped mit dem Grund blocked by earlier apply conflict, statt sie teilweise zu schreiben. Der Migrationsbericht erfasst jeden blockierten Eintrag, damit Sie den ursprünglichen Konflikt beheben und den Import erneut ausführen können.

​
Geheimnisse

Geheimnisse werden standardmäßig nie importiert.
  • Führen Sie zuerst openclaw migrate apply hermes --yes aus, um Zustand ohne Geheimnisse zu importieren.
  • Wenn Sie auch unterstützte .env-Schlüssel kopieren möchten, führen Sie den Befehl erneut mit --include-secrets aus.
  • Konfigurieren Sie für SecretRef-verwaltete 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 apply den Plan aus und verändert keinen Zustand. 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 Eintrag, ob Sie ihn überspringen, das Ziel bearbeiten oder den Befehl mit --overwrite erneut 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.
--include-secrets ist erforderlich, und nur die oben aufgeführten Schlüssel werden erkannt. Andere Variablen in .env werden ignoriert.

​
Verwandte Themen

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