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

CLI commands

Migrieren

openclaw migrate

Importieren Sie den Zustand aus einem anderen Agentensystem über einen migrationsanbietereigenen Provider. Die mitgelieferten Provider unterstützen Claude, Codex CLI und Hermes; Plugins können zusätzliche Provider registrieren.

Befehle

bash
openclaw migrate listopenclaw migrate claude --dry-runopenclaw migrate codex --dry-runopenclaw migrate codex --skill gog-vault77-google-workspaceopenclaw migrate codex --plugin google-calendar --dry-runopenclaw migrate codex --plugin google-calendar --verify-plugin-apps --dry-runopenclaw migrate hermes --dry-runopenclaw migrate hermesopenclaw migrate apply codex --yes --skill gog-vault77-google-workspaceopenclaw migrate apply codex --yes --plugin google-calendaropenclaw migrate apply codex --yesopenclaw migrate apply claude --yesopenclaw migrate apply hermes --yesopenclaw migrate apply hermes --include-secrets --yesopenclaw onboard --flow importopenclaw onboard --import-from claude --import-source ~/.claudeopenclaw onboard --import-from hermes --import-source ~/.hermes

Wenn Sie openclaw migrate <provider> ohne weitere Flags ausführen, wird die Migration geplant und als Vorschau angezeigt; in einer TTY werden Sie vor der Anwendung zur Bestätigung aufgefordert. openclaw migrate plan <provider> und openclaw migrate apply <provider> teilen Vorschau und Anwendung in separate Unterbefehle mit denselben Flags auf.

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ijxwcm92aWRlcg " type="string"> Name eines registrierten Migrations-Providers, beispielsweise hermes. Führen Sie openclaw migrate list aus, um die installierten Provider anzuzeigen.

--dry-runboolean

Erstellt den Plan und beendet den Vorgang, ohne den Zustand zu ändern.

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ii0tZnJvbSA8cGF0aA " type="string"> Überschreibt das Quellverzeichnis des Zustands. Hermes verwendet standardmäßig ~/.hermes, Codex ~/.codex (oder $CODEX_HOME) und Claude ~/.claude.

--include-secretsboolean

Importiert unterstützte Anmeldedaten ohne Rückfrage. Bei der interaktiven Anwendung werden Sie vor dem Import erkannter Authentifizierungsdaten gefragt, wobei „Ja“ standardmäßig ausgewählt ist; bei der nicht interaktiven Verwendung von --yes ist --include-secrets erforderlich, um sie zu importieren.

--no-auth-credentialsboolean

Überspringt den Import von Authentifizierungsdaten einschließlich der interaktiven Abfrage.

--overwriteboolean

Erlaubt bei der Anwendung, bestehende Ziele zu ersetzen, wenn der Plan Konflikte meldet.

--yesboolean

Überspringt die Bestätigungsabfrage. Im nicht interaktiven Modus erforderlich.

"--skill

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ii0tcGx1Z2luIDxuYW1l " type="string"> Wählt anhand des Plugin-Namens oder der Element-ID ein zu installierendes Codex-Plugin-Element aus. Wiederholen Sie das Flag, um mehrere Codex-Plugins zu migrieren. Wenn es weggelassen wird, zeigen interaktive Codex-Migrationen eine native Kontrollkästchenauswahl für Codex-Plugins an, während nicht interaktive Migrationen alle geplanten Plugins beibehalten. Gilt nur für aus der Quelle installierte openai-curated-Codex-Plugins, die über das Inventar des Codex-App-Servers erkannt wurden.

--verify-plugin-appsboolean

Nur für Codex. Erzwingt vor der Planung der nativen Plugin-Aktivierung einen neuen app/list-Durchlauf des Quell-Codex-App-Servers. Standardmäßig deaktiviert, damit die Migrationsplanung schnell bleibt.

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ii0tYmFja3VwLW91dHB1dCA8cGF0aA " type="string"> Pfad oder Verzeichnis für das Sicherungsarchiv vor der Migration. Wird an openclaw backup create weitergegeben.

--no-backupboolean

Überspringt die Sicherung vor der Anwendung. Erfordert --force, wenn ein lokaler OpenClaw-Zustand vorhanden ist.

--forceboolean

Zusammen mit --no-backup erforderlich, wenn die Anwendung andernfalls das Überspringen der Sicherung verweigern würde.

--jsonboolean

Gibt den Plan oder das Anwendungsergebnis als JSON aus. Bei Verwendung von --json ohne --yes gibt die Anwendung den Plan aus und verändert den Zustand nicht.

Sicherheitsmodell

Bei openclaw migrate steht die Vorschau an erster Stelle.

Vorschau vor der Anwendung

Der Provider gibt einen detaillierten Plan zurück, bevor Änderungen vorgenommen werden. Dieser enthält auch Konflikte, übersprungene Elemente und vertrauliche Elemente. JSON-Pläne, Anwendungsausgaben und Migrationsberichte schwärzen verschachtelte Schlüssel, die auf Geheimnisse hindeuten, beispielsweise API-Schlüssel, Tokens, Autorisierungsheader, Cookies und Passwörter.

openclaw migrate apply <provider> zeigt eine Vorschau des Plans an und fragt vor der Änderung des Zustands nach einer Bestätigung, sofern --yes nicht gesetzt ist. Im nicht interaktiven Modus erfordert die Anwendung --yes.

Sicherungen

Vor der Anwendung der Migration wird eine OpenClaw-Sicherung erstellt und überprüft. Wenn noch kein lokaler OpenClaw-Zustand vorhanden ist, wird der Sicherungsschritt übersprungen und die Migration fortgesetzt. Um eine Sicherung bei vorhandenem Zustand zu überspringen, übergeben Sie sowohl --no-backup als auch --force.

Konflikte

Die Anwendung verweigert die Fortsetzung, wenn der Plan Konflikte enthält. Prüfen Sie den Plan und führen Sie den Befehl anschließend erneut mit --overwrite aus, wenn bestehende Ziele absichtlich ersetzt werden sollen. Provider können im Verzeichnis des Migrationsberichts weiterhin Sicherungen auf Elementebene für überschriebene Dateien anlegen.

Geheimnisse

Bei der interaktiven Anwendung werden Sie gefragt, ob erkannte Authentifizierungsdaten importiert werden sollen, wobei „Ja“ standardmäßig ausgewählt ist. Verwenden Sie --no-auth-credentials, um sie zu überspringen, oder --include-secrets zusammen mit --yes, um Anmeldedaten unbeaufsichtigt zu importieren.

Claude-Provider

Der mitgelieferte Claude-Provider erkennt den Claude-Code-Zustand standardmäßig unter ~/.claude. Verwenden Sie --from <path>, um ein bestimmtes Claude-Code-Stammverzeichnis oder Projektstammverzeichnis zu importieren.

Von Claude importierte Inhalte

  • Projektdateien CLAUDE.md und .claude/CLAUDE.md in den OpenClaw-Agentenarbeitsbereich (AGENTS.md).
  • Die Benutzerdatei ~/.claude/CLAUDE.md, angehängt an USER.md im Arbeitsbereich.
  • MCP-Serverdefinitionen aus der Projektdatei .mcp.json, der Claude-Code-Datei ~/.claude.json einschließlich ihrer projektspezifischen Einträge und der Claude-Desktop-Datei claude_desktop_config.json.
  • Claude-Skill-Verzeichnisse, die eine SKILL.md enthalten (~/.claude/skills des Benutzers und .claude/skills des Projekts).
  • Markdown-Dateien mit Claude-Befehlen (~/.claude/commands des Benutzers und .claude/commands des Projekts), die in OpenClaw-Skills umgewandelt werden und nur manuell aufgerufen werden können.

Archivierter und manuell zu prüfender Zustand

Claude-Hooks, Berechtigungen, Standardwerte für die Umgebung, die Projektdatei CLAUDE.local.md, .claude/rules, die Benutzer- und Projektverzeichnisse agents/ sowie der Projektverlauf (projects, cache und plans unter ~/.claude) werden im Migrationsbericht aufbewahrt oder als manuell zu prüfende Elemente gemeldet. OpenClaw führt Hooks nicht aus, kopiert keine weitreichenden Zulassungslisten und importiert den OAuth-/Desktop-Anmeldedatenzustand nicht automatisch.

Codex-Provider

Der mitgelieferte Codex-Provider erkennt den Zustand von Codex CLI standardmäßig unter ~/.codex oder unter CODEX_HOME, wenn diese Umgebungsvariable gesetzt ist. Verwenden Sie --from <path>, um den Bestand eines bestimmten Codex-Stammverzeichnisses zu erfassen.

Verwenden Sie diesen Provider, wenn Sie zum OpenClaw-Codex-Harness wechseln und nützliche persönliche Codex-CLI-Ressourcen gezielt übernehmen möchten. Lokale Starts des Codex-App-Servers verwenden ein agentenspezifisches CODEX_HOME und lesen daher standardmäßig nicht Ihr persönliches ~/.codex. Das normale Prozessverzeichnis HOME wird weiterhin übernommen, sodass Codex gemeinsam genutzte Skills und Plugin-Marktplatzeinträge unter $HOME/.agents/* sehen kann und Unterprozesse Konfigurationen und Tokens im Benutzerverzeichnis finden können.

Wenn Sie openclaw migrate codex in einem interaktiven Terminal ausführen, wird zunächst eine Vorschau des vollständigen Plans angezeigt. Anschließend werden vor der abschließenden Bestätigung der Anwendung Kontrollkästchenauswahlen geöffnet. Zuerst werden die zu kopierenden Skill-Elemente abgefragt. Verwenden Sie Toggle all on oder Toggle all off für eine Sammelauswahl. Drücken Sie die Leertaste, um Zeilen umzuschalten, oder die Eingabetaste, um die hervorgehobene Zeile zu aktivieren und fortzufahren. Geplante Skills sind anfangs ausgewählt, Skills mit Konflikten sind anfangs nicht ausgewählt, und Skip for now überspringt das Kopieren von Skills für diesen Durchlauf, setzt den Vorgang jedoch mit der Plugin-Auswahl fort. Wenn aus der Quelle installierte, kuratierte Codex-Plugins migriert werden können und --plugin nicht angegeben wurde, werden Sie anschließend anhand des Plugin-Namens zur nativen Aktivierung von Codex-Plugins aufgefordert. Plugin-Elemente sind anfangs ausgewählt, sofern die Zielkonfiguration des OpenClaw-Codex-Plugins dieses Plugin nicht bereits enthält. Bestehende Ziel-Plugins sind anfangs nicht ausgewählt und zeigen einen Konflikthinweis wie conflict: plugin exists an. Wählen Sie Toggle all off, um in diesem Durchlauf keine nativen Codex-Plugins zu migrieren, oder Skip for now, um den Vorgang vor der Anwendung zu beenden.

Wählen Sie für skriptgesteuerte oder exakt festgelegte Durchläufe ausdrücklich einen oder mehrere Skills oder Plugins aus:

bash
openclaw migrate codex --dry-run --skill gog-vault77-google-workspaceopenclaw migrate apply codex --yes --skill gog-vault77-google-workspaceopenclaw migrate codex --dry-run --plugin google-calendaropenclaw migrate apply codex --yes --plugin google-calendar

Von Codex importierte Inhalte

  • Codex-CLI-Skill-Verzeichnisse unter $CODEX_HOME/skills, ausgenommen der Codex-Cache .system.
  • Persönliche AgentSkills unter $HOME/.agents/skills, die zur agentenspezifischen Verwaltung in den aktuellen OpenClaw-Agentenarbeitsbereich kopiert werden.
  • Aus der Quelle installierte openai-curated-Codex-Plugins, die über plugin/list des Codex-App-Servers erkannt wurden. Bei der Planung wird für jedes aktivierte installierte Plugin plugin/read gelesen.

Für die Migration App-gestützter Plugins gelten zusätzliche Prüfungen:

  • App-gestützte Plugins setzen voraus, dass das Konto des Quell-Codex-App-Servers ein ChatGPT-Abonnementkonto ist. Antworten für Konten ohne ChatGPT oder fehlende Konten werden mit codex_subscription_required übersprungen.
  • Standardmäßig ruft die Migration app/list der Quelle nicht auf. App-gestützte Plugins, welche die Kontoprüfung bestehen, werden daher ohne Überprüfung der App-Zugänglichkeit in der Quelle eingeplant; Transportfehler bei der Kontoabfrage führen zum Überspringen mit codex_account_unavailable.
  • Übergeben Sie --verify-plugin-apps, um einen neuen app/list-Snapshot der Quelle zu erzwingen und vor der Planung der nativen Aktivierung zu verlangen, dass jede zugehörige App vorhanden, aktiviert und zugänglich ist. In diesem Modus wird bei Transportfehlern der Kontoabfrage mit der Überprüfung des App-Inventars der Quelle fortgefahren. Der Snapshot wird nur für den aktuellen Prozess im Arbeitsspeicher gehalten und niemals in die Migrationsausgabe oder Zielkonfiguration geschrieben.

Deaktivierte Plugins, nicht lesbare Plugin-Details, durch ein Abonnement gesperrte Quellkonten und – wenn --verify-plugin-apps gesetzt ist – fehlende, deaktivierte oder nicht zugängliche Apps werden anstelle von Einträgen in der Zielkonfiguration als manuell zu prüfende übersprungene Elemente mit typisierten Gründen erfasst. Bei der Anwendung wird für jedes ausgewählte geeignete Plugin plugin/install des App-Servers aufgerufen, selbst wenn der Ziel-App-Server dieses Plugin bereits als installiert und aktiviert meldet. Migrierte Codex-Plugins können nur in Sitzungen verwendet werden, die das native Codex-Harness auswählen. Sie stehen weder OpenClaw-Provider-Ausführungen noch ACP-Konversationsbindungen oder anderen Harnesses zur Verfügung.

Manuell zu prüfender Codex-Zustand

Codex-config.toml, native hooks/hooks.json, nicht kuratierte Marktplätze, zwischengespeicherte Plugin-Pakete, die keine aus der Quelle installierten kuratierten Plugins sind, sowie aus der Quelle installierte Plugins, welche die Abonnementprüfung der Quelle nicht bestehen, werden nicht automatisch aktiviert. Wenn --verify-plugin-apps gesetzt ist, werden auch Plugins übersprungen, welche die Prüfung des App-Inventars der Quelle nicht bestehen. Alle diese Elemente werden für die manuelle Prüfung kopiert oder im Migrationsbericht aufgeführt.

Für migrierte, aus der Quelle installierte kuratierte Plugins schreibt die Anwendung:

  • plugins.entries.codex.enabled: true
  • plugins.entries.codex.config.codexPlugins.enabled: true
  • plugins.entries.codex.config.codexPlugins.allow_destructive_actions: true
  • einen ausdrücklichen Plugin-Eintrag mit marketplaceName: "openai-curated" und pluginName für jedes ausgewählte Plugin

Die Migration schreibt niemals plugins["*"] und speichert niemals lokale Cache-Pfade des Marktplatzes.

Übersprungene Plugins werden nicht in die Zielkonfiguration geschrieben. Fehler bei Abonnements auf der Quellseite werden bei manuellen Einträgen mit typisierten Gründen gemeldet: codex_subscription_required, codex_account_unavailable, plugin_disabled oder plugin_read_unavailable. Mit --verify-plugin-apps können Fehler bei der App-Inventarisierung auf der Quellseite außerdem als app_inaccessible, app_disabled, app_missing oder app_inventory_unavailable erscheinen. Installationen auf der Zielseite, die eine Authentifizierung erfordern, werden beim betroffenen Plugin-Eintrag mit status: "skipped", reason: "auth_required" und bereinigten App-Kennungen gemeldet; ihre expliziten Konfigurationseinträge werden deaktiviert geschrieben, bis Sie sie erneut autorisieren und aktivieren. Andere Installationsfehler werden als eintragsbezogene error-Ergebnisse ausgegeben.

Wenn das Plugin-Inventar des Codex-App-Servers während der Planung nicht verfügbar ist, greift die Migration auf zwischengespeicherte Hinweise zu gebündelten Elementen zurück, statt die gesamte Migration fehlschlagen zu lassen.

Hermes-Provider

Der gebündelte Hermes-Provider erkennt den Zustand standardmäßig unter ~/.hermes. Verwenden Sie --from <path>, wenn sich Hermes an einem anderen Ort befindet.

Was Hermes importiert

  • Die Standardmodellkonfiguration aus 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 in den Arbeitsbereich des OpenClaw-Agenten.
  • memories/MEMORY.md und memories/USER.md, die an die Speicherdateien des Arbeitsbereichs angehängt werden.
  • Standardwerte der Speicherkonfiguration für den OpenClaw-Dateispeicher sowie Archiv- oder manuell zu prüfende Einträge für externe Speicher-Provider wie Honcho.
  • Skills, die unter skills/<name>/ eine Datei namens SKILL.md enthalten.
  • Skill-spezifische Konfigurationswerte aus skills.config.
  • OpenAI-OAuth-Anmeldedaten von OpenCode aus der OpenCode-Datei auth.json, wenn die interaktive Migration von Anmeldedaten bestätigt wird oder --include-secrets gesetzt ist. OAuth-Einträge in der Hermes-Datei auth.json sind Legacy-Zustand, der für eine manuelle erneute OpenAI-Authentifizierung oder eine Reparatur durch Doctor gemeldet wird.
  • Unterstützte API-Schlüssel und Token aus der Hermes-Datei .env und der OpenCode-Datei auth.json, wenn die interaktive Migration von Anmeldedaten bestätigt wird oder --include-secrets gesetzt ist.

Unterstützte .env-Schlüssel

AI_GATEWAY_API_KEY, ALIBABA_API_KEY, ANTHROPIC_API_KEY, ARCEEAI_API_KEY, CEREBRAS_API_KEY, CHUTES_API_KEY, CLOUDFLARE_AI_GATEWAY_API_KEY, COPILOT_GITHUB_TOKEN, DASHSCOPE_API_KEY, DEEPINFRA_API_KEY, DEEPSEEK_API_KEY, FIREWORKS_API_KEY, GEMINI_API_KEY, GH_TOKEN, GITHUB_TOKEN, GLM_API_KEY, GOOGLE_API_KEY, GROQ_API_KEY, HF_TOKEN, HUGGINGFACE_HUB_TOKEN, KILOCODE_API_KEY, KIMICODE_API_KEY, KIMI_API_KEY, MINIMAX_API_KEY, MINIMAX_CODING_API_KEY, MISTRAL_API_KEY, MODELSTUDIO_API_KEY, MOONSHOT_API_KEY, NVIDIA_API_KEY, OPENAI_API_KEY, OPENCODE_API_KEY, OPENCODE_GO_API_KEY, OPENCODE_ZEN_API_KEY, OPENROUTER_API_KEY, QIANFAN_API_KEY, QWEN_API_KEY, TOGETHER_API_KEY, VENICE_API_KEY, XAI_API_KEY, XIAOMI_API_KEY, ZAI_API_KEY, Z_AI_API_KEY.

Nur archivierter Zustand

Hermes-Zustand, den OpenClaw nicht sicher interpretieren kann, wird zur manuellen Prüfung in den Migrationsbericht kopiert, aber nicht in die aktive OpenClaw-Konfiguration oder die Anmeldedaten geladen. Dadurch bleibt undurchsichtiger oder unsicherer Zustand erhalten, ohne vorzugeben, OpenClaw könne ihn automatisch ausführen oder ihm vertrauen: plugins/, sessions/, logs/, cron/, mcp-tokens/, state.db.

Nach der Anwendung

bash
openclaw doctor

Plugin-Vertrag

Migrationsquellen sind Plugins. Ein Plugin deklariert seine Provider-IDs in openclaw.plugin.json:

json
{  "contracts": {    "migrationProviders": ["hermes"]  }}

Zur Laufzeit ruft das Plugin api.registerMigrationProvider(...) auf. Der Provider implementiert detect, plan und apply. Der Kern übernimmt die CLI-Orchestrierung, die Sicherungsrichtlinie, Eingabeaufforderungen, die JSON-Ausgabe und die Konfliktvorprüfung. Der Kern übergibt den geprüften Plan an apply(ctx, plan). Provider dürfen den Plan aus Kompatibilitätsgründen nur dann neu erstellen, wenn dieses Argument fehlt.

Provider-Plugins können openclaw/plugin-sdk/migration zur Erstellung von Einträgen und für Zusammenfassungszahlen sowie openclaw/plugin-sdk/migration-runtime für konfliktbewusste Dateikopien, ausschließlich für Berichte bestimmte Archivkopien, zwischengespeicherte Konfigurations-Laufzeit-Wrapper und Migrationsberichte verwenden.

Integration in das Onboarding

Das Onboarding kann eine Migration anbieten, wenn ein Provider eine bekannte Quelle erkennt. Sowohl openclaw onboard --flow import als auch openclaw setup --wizard --import-from hermes verwenden denselben Plugin-Migrations-Provider und zeigen vor der Anwendung weiterhin eine Vorschau an.

Verwandte Themen

Was this useful?
On this page

On this page