OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Maintenance

Migration von Claude

OpenClaw importiert den lokalen Claude-Status über den gebündelten Claude-Migrations-Provider. Der Provider zeigt vor jeder Statusänderung eine Vorschau aller Elemente an, schwärzt Geheimnisse in Plänen und Berichten und erstellt vor der Anwendung eine verifizierte Sicherung.

Zwei Importmöglichkeiten

Onboarding-Assistent

Der Assistent bietet Claude an, wenn er einen lokalen Claude-Status erkennt.

bash
openclaw onboard --flow import

Alternativ können Sie eine bestimmte Quelle angeben:

bash
openclaw onboard --import-from claude --import-source ~/.claude

CLI

Verwenden Sie openclaw migrate für skriptgesteuerte oder wiederholbare Ausführungen. Die vollständige Referenz finden Sie unter openclaw migrate.

bash
openclaw migrate claude --dry-runopenclaw migrate apply claude --yes

Fügen Sie --from <path> hinzu, um ein bestimmtes Claude-Code-Stammverzeichnis oder Projektstammverzeichnis zu importieren.

Was importiert wird

Anweisungen und Speicher
  • Der Inhalt von CLAUDE.md und .claude/CLAUDE.md eines Projekts wird in die Datei AGENTS.md des OpenClaw-Agent-Arbeitsbereichs kopiert oder an sie angehängt.
  • Der Inhalt der Benutzerdatei ~/.claude/CLAUDE.md wird an die Datei USER.md des Arbeitsbereichs angehängt.
MCP-Server

Definitionen von MCP-Servern werden, sofern vorhanden, aus der Projektdatei .mcp.json, der Claude-Code-Datei ~/.claude.json und der Claude-Desktop-Datei claude_desktop_config.json importiert.

Skills und Befehle
  • Claude-Skills mit einer SKILL.md-Datei werden in das Skills-Verzeichnis des OpenClaw-Arbeitsbereichs kopiert.
  • Markdown-Dateien mit Claude-Befehlen unter .claude/commands/ oder ~/.claude/commands/ werden in OpenClaw-Skills mit disable-model-invocation: true umgewandelt.

Was ausschließlich im Archiv verbleibt

Der Provider kopiert die folgenden Elemente zur manuellen Prüfung in den Migrationsbericht, lädt sie jedoch nicht in die aktive OpenClaw-Konfiguration:

  • Claude-Hooks
  • Claude-Berechtigungen und umfassende Werkzeug-Zulassungslisten
  • Claude-Standardwerte für Umgebungsvariablen
  • CLAUDE.local.md
  • .claude/rules/
  • Claude-Unteragenten unter .claude/agents/ oder ~/.claude/agents/
  • Cache-, Plan- und Projektverlaufsverzeichnisse von Claude Code
  • Claude-Desktop-Erweiterungen und im Betriebssystem gespeicherte Anmeldedaten

OpenClaw weigert sich, Hooks auszuführen, Berechtigungs-Zulassungslisten zu vertrauen oder undurchsichtige OAuth- und Desktop-Anmeldedaten automatisch zu entschlüsseln. Übertragen Sie benötigte Inhalte nach Prüfung des Archivs manuell.

Quellenauswahl

Ohne --from untersucht OpenClaw das standardmäßige Claude-Code-Stammverzeichnis unter ~/.claude, die stichprobenartig ausgewertete Claude-Code-Statusdatei ~/.claude.json und unter macOS die MCP-Konfiguration von Claude Desktop.

Wenn --from auf ein Projektstammverzeichnis verweist, importiert OpenClaw ausschließlich die Claude-Dateien dieses Projekts, beispielsweise CLAUDE.md, .claude/settings.json, .claude/commands/, .claude/skills/ und .mcp.json. Bei einem Import aus einem Projektstammverzeichnis wird das globale Claude-Stammverzeichnis nicht gelesen.

Empfohlener Ablauf

  • Plan in der Vorschau anzeigen

    bash
    openclaw migrate claude --dry-run

    Der Plan führt alle bevorstehenden Änderungen auf, einschließlich Konflikten, übersprungenen Elementen und vertraulichen Werten, die in verschachtelten MCP-Feldern namens env oder headers geschwärzt wurden.

  • Mit Sicherung anwenden

    bash
    openclaw migrate apply claude --yes

    OpenClaw erstellt und verifiziert vor der Anwendung eine Sicherung.

  • Doctor ausführen

    bash
    openclaw doctor

    Doctor prüft nach dem Import auf Konfigurations- oder Statusprobleme.

  • Neu starten und überprüfen

    bash
    openclaw gateway restartopenclaw status

    Vergewissern Sie sich, dass das Gateway ordnungsgemäß funktioniert und Ihre importierten Anweisungen, MCP-Server und Skills geladen sind.

    • Konfliktbehandlung

    Die Anwendung wird nicht fortgesetzt, wenn der Plan Konflikte meldet, weil am Ziel bereits eine Datei oder ein Konfigurationswert vorhanden ist.

    Bei einer neuen OpenClaw-Installation sind Konflikte ungewöhnlich. Sie treten normalerweise auf, wenn Sie den Import für eine Einrichtung wiederholen, die bereits Benutzeränderungen enthält.

    JSON-Ausgabe für die Automatisierung

    bash
    openclaw migrate claude --dry-run --jsonopenclaw migrate apply claude --json --yes

    Außerhalb eines interaktiven Terminals ist --yes für migrate apply erforderlich. Ohne dieses Flag gibt OpenClaw einen Fehler aus, statt die Änderungen anzuwenden. Skripte und CI müssen --yes daher ausdrücklich übergeben. Zeigen Sie zunächst mit --dry-run --json eine Vorschau an und wenden Sie die Änderungen anschließend mit --json --yes an, sobald der Plan korrekt aussieht.

    Fehlerbehebung

    Der Claude-Status befindet sich außerhalb von ~/.claude

    Übergeben Sie --from /actual/path über die CLI oder --import-source /actual/path beim Onboarding.

    Das Onboarding verweigert den Import in eine bestehende Einrichtung

    Importe während des Onboardings erfordern eine neue Einrichtung. Setzen Sie entweder den Status zurück und führen Sie das Onboarding erneut aus oder verwenden Sie direkt openclaw migrate apply claude, das --overwrite und eine explizite Sicherungssteuerung unterstützt.

    MCP-Server aus Claude Desktop wurden nicht importiert

    Claude Desktop liest claude_desktop_config.json aus einem plattformspezifischen Pfad. Lassen Sie --from auf das Verzeichnis dieser Datei verweisen, wenn OpenClaw sie nicht automatisch erkannt hat.

    Claude-Befehle wurden zu Skills mit deaktiviertem Modellaufruf

    Dies ist beabsichtigt. Claude-Befehle werden vom Benutzer ausgelöst. Deshalb importiert OpenClaw sie als Skills mit disable-model-invocation: true. Bearbeiten Sie den Frontmatter-Block des jeweiligen Skills, wenn der Agent sie automatisch aufrufen soll.

    Verwandte Themen

    Was this useful?
    On this page

    On this page