# openclaw migrate

Importeer status vanuit een ander agentsysteem via een door een plugin beheerde migratieprovider. Gebundelde providers ondersteunen status van Codex CLI, Claude en Hermes; plugins van derden kunnen extra providers registreren.

# Opdrachten

openclaw migrate list
openclaw migrate claude --dry-run
openclaw migrate codex --dry-run
openclaw migrate codex --skill gog-vault77-google-workspace
openclaw migrate hermes --dry-run
openclaw migrate hermes
openclaw migrate apply codex --yes --skill gog-vault77-google-workspace
openclaw migrate apply codex --yes
openclaw migrate apply claude --yes
openclaw migrate apply hermes --yes
openclaw migrate apply hermes --include-secrets --yes
openclaw onboard --flow import
openclaw onboard --import-from claude --import-source ~/.claude
openclaw 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 geinstalleerde providers te bekijken.

--dry-runboolean

Bouw het plan en sluit af zonder status te wijzigen.

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

--include-secretsboolean

Importeer ondersteunde referenties. Standaard uitgeschakeld.

--overwriteboolean

Sta toe dat apply bestaande doelen vervangt wanneer het plan conflicten meldt.

--yesboolean

Sla de bevestigingsprompt over. Vereist in niet-interactieve modus.

"--skill

--no-backupboolean

Sla de pre-apply-back-up over. Vereist --force wanneer lokale OpenClaw-status bestaat.

--forceboolean

Vereist naast --no-backup wanneer apply anders zou weigeren de back-up over te slaan.

--jsonboolean

Druk het plan of apply-resultaat af als JSON. Met --json en zonder --yes drukt apply het plan af en muteert geen status.

# Veiligheidsmodel

openclaw migrate werkt eerst met een voorbeeldweergave.

# Claude-provider

De gebundelde Claude-provider detecteert standaard Claude Code-status in ~/.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 omgezet 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 gemeld 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 in ~/.codex, of in 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 nuttige persoonlijke Codex CLI-assets doelbewust wilt promoveren. Lokale Codex-app-serverstarts gebruiken per-agent CODEX_HOME- en HOME-mappen, dus ze lezen standaard je persoonlijke Codex CLI-status niet.

Het uitvoeren van openclaw migrate codex in een interactieve terminal toont een voorbeeld van het volledige plan en opent daarna een selectievakjeskiezer voor skill-kopieeritems vóór de uiteindelijke apply-bevestiging. Gebruik Toggle all on of Toggle all off voor bulkselectie; geplande skills beginnen aangevinkt, conflicterende skills beginnen uitgevinkt en Skip for now laat skills ongewijzigd zonder toe te passen. Geef voor gescripte of exacte runs --skill <name> eenmaal per skill door, bijvoorbeeld:

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

# 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.

# Codex-status voor handmatige beoordeling

Native Codex-plugins, config.toml en native hooks/hooks.json worden niet automatisch geactiveerd. Plugins kunnen MCP-servers, apps, hooks of ander uitvoerbaar gedrag blootstellen, dus de provider rapporteert ze ter beoordeling in plaats van ze in OpenClaw te laden. Configuratie- en hookbestanden worden naar het migratierapport gekopieerd voor handmatige beoordeling.

# Hermes-provider

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

# Wat Hermes importeert

• Standaardmodelconfiguratie uit config.yaml.
• Geconfigureerde modelproviders en aangepaste OpenAI-compatibele endpoints uit providers en custom_providers.
• MCP-serverdefinities uit mcp_servers of mcp.servers.
• SOUL.md en AGENTS.md naar de OpenClaw-agentwerkruimte.
• memories/MEMORY.md en memories/USER.md toegevoegd aan geheugensbestanden van de werkruimte.
• Geheugenconfiguratiestandaarden voor OpenClaw-bestandsgeheugen, plus archief- of handmatige-beoordelingsitems voor externe geheugenproviders zoals Honcho.
• Skills die een SKILL.md-bestand bevatten onder skills/<name>/.
• Configuratiewaarden per skill uit skills.config.
• Ondersteunde API-sleutels uit .env, alleen met --include-secrets.

# Ondersteunde .env-sleutels

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.

# Alleen-archiefstatus

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

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

# Na toepassen

openclaw doctor

# Plugincontract

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 beheert CLI-orchestratie, back-upbeleid, prompts, JSON-uitvoer en conflict-preflight. Core geeft het beoordeelde plan door aan apply(ctx, plan), en providers mogen het plan alleen opnieuw bouwen wanneer dat argument ontbreekt voor compatibiliteit.

Providerplugins kunnen openclaw/plugin-sdk/migration gebruiken voor itemconstructie en samenvattingstellingen, plus openclaw/plugin-sdk/migration-runtime voor conflictbewuste bestandskopieen, alleen-archief rapportkopieen, gecachete 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 gebruikt dezelfde pluginmigratieprovider en toont nog steeds een voorbeeld vóór toepassing.

# Gerelateerd

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