Zum Hauptinhalt springen
OpenClaw importiert lokalen Claude-Zustand über den gebündelten Claude-Migrations-Provider. Der Provider zeigt jedes Element vor einer Zustandsänderung in einer Vorschau an, schwärzt Geheimnisse in Plänen und Berichten und erstellt vor der Anwendung ein verifiziertes Backup.
Onboarding-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 nach Prüfung des Plans direkt mit --overwrite.

​
Zwei Wege zum Importieren

Der Assistent bietet Claude an, wenn er lokalen Claude-Zustand erkennt.
openclaw onboard --flow import
Oder geben Sie eine bestimmte Quelle an:
openclaw onboard --import-from claude --import-source ~/.claude

​
Was importiert wird

  • Inhalte aus Projekt-CLAUDE.md und .claude/CLAUDE.md werden in den OpenClaw-Agentenarbeitsbereich AGENTS.md kopiert oder dort angehängt.
  • Inhalte aus Benutzer-~/.claude/CLAUDE.md werden an Arbeitsbereich-USER.md angehängt.
MCP-Serverdefinitionen werden aus Projekt-.mcp.json, Claude Code-~/.claude.json und Claude Desktop-claude_desktop_config.json importiert, wenn sie vorhanden sind.
  • Claude-Skills mit einer SKILL.md-Datei werden in das Skills-Verzeichnis des OpenClaw-Arbeitsbereichs kopiert.
  • Claude-Befehls-Markdown-Dateien unter .claude/commands/ oder ~/.claude/commands/ werden in OpenClaw-Skills mit disable-model-invocation: true umgewandelt.

​
Was nur archiviert bleibt

Der Provider kopiert diese Elemente zur manuellen Prüfung in den Migrationsbericht, lädt sie aber nicht in die aktive OpenClaw-Konfiguration:
  • Claude-Hooks
  • Claude-Berechtigungen und umfassende Tool-Zulassungslisten
  • Claude-Umgebungsstandards
  • CLAUDE.local.md
  • .claude/rules/
  • Claude-Subagents unter .claude/agents/ oder ~/.claude/agents/
  • Claude Code-Caches, Pläne und Projektverlaufsverzeichnisse
  • Claude Desktop-Erweiterungen und vom Betriebssystem gespeicherte Anmeldedaten
OpenClaw verweigert es, Hooks auszuführen, Berechtigungs-Zulassungslisten zu vertrauen oder undurchsichtigen OAuth- und Desktop-Anmeldedatenzustand automatisch zu dekodieren. Verschieben Sie das, was Sie benötigen, nach Prüfung des Archivs manuell.

​
Quellenauswahl

Ohne --from untersucht OpenClaw das standardmäßige Claude Code-Home unter ~/.claude, die stichprobenartige Claude Code-Zustandsdatei ~/.claude.json und die Claude Desktop-MCP-Konfiguration unter macOS. Wenn --from auf ein Projektstammverzeichnis zeigt, importiert OpenClaw nur die Claude-Dateien dieses Projekts, etwa CLAUDE.md, .claude/settings.json, .claude/commands/, .claude/skills/ und .mcp.json. Ihr globales Claude-Home wird während eines Imports aus einem Projektstammverzeichnis nicht gelesen.

​
Empfohlener Ablauf

1

Planvorschau anzeigen

openclaw migrate claude --dry-run
Der Plan listet alles auf, was geändert wird, einschließlich Konflikten, übersprungenen Elementen und sensiblen Werten, die aus verschachtelten MCP-env- oder headers-Feldern geschwärzt wurden.
2

Mit Backup anwenden

openclaw migrate apply claude --yes
OpenClaw erstellt und verifiziert vor der Anwendung ein Backup.
3

Doctor ausführen

openclaw doctor
Doctor prüft nach dem Import auf Konfigurations- oder Zustandsprobleme.
4

Neu starten und überprüfen

openclaw gateway restart
openclaw status
Bestätigen Sie, dass der Gateway fehlerfrei ist und Ihre importierten Anweisungen, MCP-Server und Skills geladen sind.

​
Konfliktbehandlung

Die Anwendung verweigert die Fortsetzung, wenn der Plan Konflikte meldet (eine Datei oder ein Konfigurationswert existiert bereits am Ziel).
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.

​
JSON-Ausgabe für Automatisierung

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

​
Fehlerbehebung

Ü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 durch, oder verwenden Sie direkt openclaw migrate apply claude, das --overwrite und explizite Backup-Steuerung unterstützt.
Claude Desktop liest claude_desktop_config.json aus einem plattformspezifischen Pfad. Richten Sie --from auf das Verzeichnis dieser Datei, wenn OpenClaw sie nicht automatisch erkannt hat.
Dies ist beabsichtigt. Claude-Befehle werden vom Benutzer ausgelöst, daher importiert OpenClaw sie als Skills mit disable-model-invocation: true. Bearbeiten Sie das Frontmatter jedes Skills, wenn der Agent sie automatisch aufrufen soll.

​
Verwandte Themen