openclaw migrate

Importeer status uit een ander agentsysteem via een migratieprovider die eigendom is van een plugin. Gebundelde providers dekken Codex CLI-status, Claude en Hermes; plugins van derden kunnen extra providers registreren.

Opdrachten

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

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ijxwcm92aWRlcg " type="string"> Naam van een geregistreerde migratieprovider, bijvoorbeeld hermes. Voer openclaw migrate list uit om geïnstalleerde providers te zien.

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ii0tZnJvbSA8cGF0aA " type="string"> Overschrijf de bronstatusmap. Hermes gebruikt standaard ~/.hermes.

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ii0tcGx1Z2luIDxuYW1l " type="string"> Selecteer één Codex-plugininstallatie-item op pluginnaam of item-id. Herhaal de vlag om meerdere Codex-plugins te migreren. Indien weggelaten tonen interactieve Codex-migraties een native Codex-pluginselectievakjeskiezer en behouden niet-interactieve migraties alle geplande plugins. Dit geldt alleen voor brongeïnstalleerde openai-curated Codex-plugins die door de Codex app-server-inventaris zijn ontdekt.

Veiligheidsmodel

openclaw migrate werkt met eerst een voorbeeldweergave.

Claude-provider

De gebundelde Claude-provider detecteert standaard Claude Code-status op ~/.claude. Gebruik --from <path> om een specifieke Claude Code-home of projectroot te importeren.

Wat Claude importeert

• Project-CLAUDE.md en .claude/CLAUDE.md naar de OpenClaw-agentwerkruimte.
• Gebruikers-~/.claude/CLAUDE.md toegevoegd aan werkruimte-USER.md.
• MCP-serverdefinities uit project-.mcp.json, Claude Code ~/.claude.json en Claude Desktop claude_desktop_config.json.
• Claude-skillmappen die SKILL.md bevatten.
• Claude-opdracht-Markdownbestanden geconverteerd naar OpenClaw-skills met alleen handmatige aanroep.

Archief- en handmatige-beoordelingsstatus

Claude-hooks, machtigingen, omgevingsstandaarden, lokaal geheugen, padgebonden regels, subagents, caches, plannen en projectgeschiedenis worden bewaard in het migratierapport of gerapporteerd als items voor handmatige beoordeling. OpenClaw voert geen hooks uit, kopieert geen brede allowlists en importeert OAuth/Desktop-referentiestatus niet automatisch.

Codex-provider

De gebundelde Codex-provider detecteert standaard Codex CLI-status op ~/.codex, of op CODEX_HOME wanneer die omgevingsvariabele is ingesteld. Gebruik --from <path> om een specifieke Codex-home te inventariseren.

Gebruik deze provider wanneer je overstapt naar de OpenClaw Codex-harness en je nuttige persoonlijke Codex CLI-assets bewust wilt promoveren. Lokale Codex app-server- starts gebruiken een per-agent CODEX_HOME, dus ze lezen standaard niet je persoonlijke ~/.codex. Het normale proces-HOME wordt nog steeds geërfd, zodat Codex gedeelde $HOME/.agents/* skills/plugin-marktplaatsvermeldingen kan zien en subprocessen gebruikers-homeconfiguratie en tokens kunnen vinden.

Het uitvoeren van openclaw migrate codex in een interactieve terminal toont eerst het volledige plan en opent daarna selectievakjeskiezers vóór de definitieve toepasbevestiging. Skill- kopie-items worden eerst gevraagd. Gebruik Toggle all on of Toggle all off voor bulk- selectie. Druk op Spatie om rijen om te schakelen, of druk op Enter om de gemarkeerde rij te activeren en door te gaan. Geplande skills beginnen aangevinkt, skills met conflict beginnen uitgevinkt, en Skip for now slaat skillkopieën voor deze uitvoering over terwijl de plugin- selectie nog steeds doorgaat. Wanneer brongeïnstalleerde gecureerde Codex-plugins migreerbaar zijn en --plugin niet is opgegeven, vraagt de migratie daarna om native Codex-plugin- activatie op pluginnaam. Plugin-items beginnen aangevinkt tenzij de doel-OpenClaw Codex-pluginconfiguratie die plugin al heeft. Bestaande doelplugins beginnen uitgevinkt en tonen een conflicthint zoals conflict: plugin exists; kies Toggle all off om in die uitvoering geen native Codex- plugins te migreren, of Skip for now om te stoppen vóór toepassen. Voor gescripte of exacte uitvoeringen geef je --skill <name> één keer per skill mee, bijvoorbeeld:

openclaw migrate codex --dry-run --skill gog-vault77-google-workspaceopenclaw migrate apply codex --yes --skill gog-vault77-google-workspace

Gebruik --plugin <name> om native Codex-pluginmigratie niet-interactief te beperken tot één of meer brongeïnstalleerde gecureerde plugins:

openclaw migrate codex --dry-run --plugin google-calendaropenclaw migrate apply codex --yes --plugin google-calendar

Wat Codex importeert

• Codex CLI-skillmappen onder $CODEX_HOME/skills, met uitzondering van Codex' .system-cache.
• Persoonlijke AgentSkills onder $HOME/.agents/skills, gekopieerd naar de huidige OpenClaw-agentwerkruimte wanneer je eigendom per agent wilt.
• Brongeïnstalleerde openai-curated Codex-plugins ontdekt via Codex app-server plugin/list. Planning leest plugin/read voor elke ingeschakelde geïnstalleerde plugin. App-ondersteunde plugins vereisen dat de accountreactie van de bron-Codex app-server een ChatGPT-abonnementsaccount is; niet-ChatGPT- of ontbrekende accountreacties worden overgeslagen met codex_subscription_required. Standaard roept migratie geen bron-app/list aan, dus app-ondersteunde plugins die de accountpoort passeren, worden gepland zonder verificatie van toegankelijkheid van de bron-app, en transportfouten bij accountopzoeking slaan over met codex_account_unavailable. Geef --verify-plugin-apps mee wanneer je wilt dat migratie een nieuwe bron- app/list-snapshot forceert en vereist dat elke eigen app aanwezig, ingeschakeld en toegankelijk is voordat native activatie wordt gepland. In die modus vallen transportfouten bij accountopzoeking door naar verificatie van de bron-appinventaris. De bron-appinventarissnapshot wordt in het geheugen gehouden voor het huidige proces; hij wordt niet geschreven naar migratie-uitvoer of doelconfiguratie. Uitgeschakelde plugins, onleesbare plugindetails, door abonnement geblokkeerde bronaccounts en, wanneer verificatie is aangevraagd, ontbrekende apps, uitgeschakelde apps, ontoegankelijke apps of bron-appinventarisfouten worden handmatig overgeslagen items met getypte redenen in plaats van doelconfiguratievermeldingen. Toepassen roept app-server plugin/install aan voor elke geselecteerde geschikte plugin, zelfs als de doel-app-server die plugin al als geïnstalleerd en ingeschakeld rapporteert. Gemigreerde Codex-plugins zijn alleen bruikbaar in sessies die de native Codex-harness selecteren; ze worden niet blootgesteld aan OpenClaw-provideruitvoeringen, ACP-gespreksbindingen of andere harnesses.

Codex-status voor handmatige beoordeling

Codex config.toml, native hooks/hooks.json, niet-gecureerde marktplaatsen, gecachte pluginbundels die geen brongeïnstalleerde gecureerde plugins zijn, en brongeïnstalleerde plugins die de bronabonnementspoort niet halen, worden niet automatisch geactiveerd. Wanneer --verify-plugin-apps is ingesteld, worden plugins die de bron-appinventaris- poort niet halen ook overgeslagen. Ze worden gekopieerd of gerapporteerd in het migratierapport voor handmatige beoordeling.

Voor gemigreerde brongeïnstalleerde gecureerde plugins schrijft toepassen:

• plugins.entries.codex.enabled: true
• plugins.entries.codex.config.codexPlugins.enabled: true
• plugins.entries.codex.config.codexPlugins.allow_destructive_actions: true
• één expliciete pluginvermelding met marketplaceName: "openai-curated" en pluginName voor elke geselecteerde plugin

Migratie schrijft nooit plugins["*"] en slaat nooit lokale cachepaden voor de marketplace op. Mislukte abonnementen aan de bronzijde worden gerapporteerd op handmatige items met getypeerde redenen zoals codex_subscription_required, codex_account_unavailable, plugin_disabled of plugin_read_unavailable. Met --verify-plugin-apps kunnen inventarisatiefouten van bronapps ook verschijnen als app_inaccessible, app_disabled, app_missing of app_inventory_unavailable. Overgeslagen plugins worden niet naar de doelconfiguratie geschreven. Installaties aan de doelzijde waarvoor authenticatie vereist is, worden gerapporteerd op het betrokken plugin-item met status: "skipped", reason: "auth_required" en opgeschoonde app-identificaties. Hun expliciete configuratie-items worden uitgeschakeld geschreven totdat u ze opnieuw autoriseert en inschakelt. Andere installatiefouten zijn itemgebonden error-resultaten.

Als de plugin-inventaris van de Codex app-server tijdens de planning niet beschikbaar is, valt migratie terug op gecachte bundeladviesitems in plaats van de hele migratie te laten mislukken.

Hermes-provider

De gebundelde Hermes-provider detecteert standaard status in ~/.hermes. Gebruik --from <path> wanneer Hermes ergens anders staat.

Wat Hermes importeert

• Standaard modelconfiguratie uit config.yaml.
• Geconfigureerde modelproviders en aangepaste OpenAI-compatibele eindpunten uit providers en custom_providers.
• MCP-serverdefinities uit mcp_servers of mcp.servers.
• SOUL.md en AGENTS.md naar de agentwerkruimte van OpenClaw.
• memories/MEMORY.md en memories/USER.md toegevoegd aan werkruimtegeheugenbestanden.
• Standaardwaarden voor geheugenconfiguratie voor OpenClaw-bestandsgeheugen, plus archief- of handmatige-reviewitems voor externe geheugenproviders zoals Honcho.
• Skills die een SKILL.md-bestand bevatten onder skills/<name>/.
• Configuratiewaarden per Skill uit skills.config.
• OpenCode OpenAI OAuth-referenties uit OpenCode auth.json wanneer interactieve referentiemigratie wordt geaccepteerd, of wanneer --include-secrets is ingesteld. Hermes auth.json OAuth-items zijn verouderde status die wordt gerapporteerd voor handmatige OpenAI-herauthenticatie of doctor-reparatie.
• Ondersteunde API-sleutels en tokens uit Hermes .env en OpenCode auth.json wanneer interactieve referentiemigratie wordt geaccepteerd, of wanneer --include-secrets is ingesteld.

Ondersteunde .env-sleutels

• 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

Alleen-archiefstatus

Hermes-status die OpenClaw niet veilig kan interpreteren, wordt naar het migratierapport gekopieerd voor handmatige review, maar wordt niet geladen in live OpenClaw-configuratie of -referenties. Dit bewaart ondoorzichtige of onveilige status zonder te doen alsof OpenClaw die automatisch kan uitvoeren of vertrouwen:

• plugins/
• sessions/
• logs/
• cron/
• mcp-tokens/
• state.db

Na toepassen

openclaw doctor

Plugin-contract

Migratiebronnen zijn plugins. Een plugin declareert zijn provider-id's in openclaw.plugin.json:

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

Tijdens runtime roept de plugin api.registerMigrationProvider(...) aan. De provider implementeert detect, plan en apply. Core is eigenaar van CLI-orkestratie, back-upbeleid, prompts, JSON-uitvoer en conflictpreflight. Core geeft het beoordeelde plan door aan apply(ctx, plan), en providers mogen het plan alleen opnieuw opbouwen wanneer dat argument afwezig is voor compatibiliteit.

Providerplugins kunnen openclaw/plugin-sdk/migration gebruiken voor itemconstructie en samenvattingstellingen, plus openclaw/plugin-sdk/migration-runtime voor conflictbewuste bestandskopieën, alleen-archief rapportkopieën, gecachte config-runtime wrappers en migratierapporten.

Onboarding-integratie

Onboarding kan migratie aanbieden wanneer een provider een bekende bron detecteert. Zowel openclaw onboard --flow import als openclaw setup --wizard --import-from hermes gebruiken dezelfde pluginmigratieprovider en tonen nog steeds een voorbeeld voordat ze toepassen.

Gerelateerd

• Migreren vanaf Hermes: gebruikersgerichte walkthrough.
• Migreren vanaf Claude: gebruikersgerichte walkthrough.
• Migreren: verplaats OpenClaw naar een nieuwe machine.
• Doctor: gezondheidscontrole na het toepassen van een migratie.
• Plugins: plugininstallatie en registratie.