Skip to main content
OpenClaw importeert lokale Claude-status via de gebundelde Claude-migratieprovider. De provider toont een voorbeeld van elk item voordat de status wordt gewijzigd en maskeert geheimen in plannen en rapporten. Zelfstandig openclaw migrate maakt een geverifieerde back-up; het nieuwe onboardingpad bereidt de import voor en publiceert deze pas nadat de verificatie is geslaagd.
Voor onboardingimports is een nieuwe OpenClaw-configuratie vereist. Als je al lokale OpenClaw-status hebt, stel dan eerst de configuratie, referenties, sessies en werkruimte opnieuw in, of gebruik openclaw migrate rechtstreeks met --overwrite nadat je het plan hebt gecontroleerd.

​
Twee manieren om te importeren

De wizard biedt Claude aan wanneer lokale Claude-status wordt gedetecteerd.
Of verwijs naar een specifieke bron:

​
Wat wordt geïmporteerd

  • Inhoud van project-CLAUDE.md en .claude/CLAUDE.md wordt gekopieerd of toegevoegd aan AGENTS.md in de OpenClaw-agentwerkruimte.
  • Inhoud van gebruikers-~/.claude/CLAUDE.md wordt toegevoegd aan USER.md in de werkruimte.
MCP-serverdefinities worden, indien aanwezig, geïmporteerd uit project-.mcp.json, Claude Code-~/.claude.json en Claude Desktop-claude_desktop_config.json.
  • Claude-skills met een SKILL.md-bestand worden gekopieerd naar de map met skills in de OpenClaw-werkruimte.
  • Markdown-bestanden met Claude-opdrachten onder .claude/commands/ of ~/.claude/commands/ worden geconverteerd naar OpenClaw-skills met disable-model-invocation: true.

​
Wat alleen in het archief blijft

De provider kopieert het volgende naar het migratierapport voor handmatige controle, maar laadt het niet in de actieve OpenClaw-configuratie:
  • Claude-hooks
  • Claude-machtigingen en brede lijsten met toegestane tools
  • Standaardwaarden voor de Claude-omgeving
  • CLAUDE.local.md
  • .claude/rules/
  • Claude-subagents onder .claude/agents/ of ~/.claude/agents/
  • Cache-, plan- en projectgeschiedenismappen van Claude Code
  • Claude Desktop-extensies en in het besturingssysteem opgeslagen referenties
OpenClaw weigert hooks uit te voeren, lijsten met vertrouwde machtigingen te vertrouwen of ondoorzichtige OAuth- en Desktop-referentiestatus automatisch te decoderen. Verplaats wat je nodig hebt handmatig nadat je het archief hebt gecontroleerd.

​
Bronselectie

Zonder --from inspecteert OpenClaw de standaardhomemap van Claude Code op ~/.claude, het bemonsterde Claude Code-statusbestand ~/.claude.json en de MCP-configuratie van Claude Desktop op macOS. Wanneer --from naar een projecthoofdmap verwijst, importeert OpenClaw alleen de Claude-bestanden van dat project, zoals CLAUDE.md, .claude/settings.json, .claude/commands/, .claude/skills/ en .mcp.json. Tijdens een import vanuit een projecthoofdmap wordt je globale Claude-homemap niet gelezen.

​
Aanbevolen werkwijze

1

Bekijk een voorbeeld van het plan

Het plan vermeldt alles wat wordt gewijzigd, waaronder conflicten, overgeslagen items en gevoelige waarden die zijn gemaskeerd in geneste MCP-velden env of headers.
2

Pas toe met back-up

OpenClaw maakt en verifieert een back-up voordat de wijzigingen worden toegepast.
3

Voer Doctor uit

Doctor controleert na de import op problemen met de configuratie of status.
4

Start opnieuw en verifieer

Controleer of de Gateway in orde is en je geïmporteerde instructies, MCP-servers en skills zijn geladen.

​
Conflictafhandeling

Het toepassen wordt geweigerd wanneer het plan conflicten meldt (er bestaat al een bestand of configuratiewaarde op het doel).
Voer de opdracht alleen opnieuw uit met --overwrite wanneer je het bestaande doel bewust wilt vervangen. Providers kunnen nog steeds back-ups per item maken voor overschreven bestanden in de map met migratierapporten.
Bij een nieuwe OpenClaw-installatie zijn conflicten ongebruikelijk. Ze treden doorgaans op wanneer je de import opnieuw uitvoert op een configuratie die al gebruikerswijzigingen bevat.

​
JSON-uitvoer voor automatisering

--yes is vereist voor migrate apply buiten een interactieve terminal; zonder deze optie geeft OpenClaw een foutmelding in plaats van de wijzigingen toe te passen. Scripts en CI moeten daarom --yes expliciet doorgeven. Bekijk eerst een voorbeeld met --dry-run --json en pas de wijzigingen vervolgens toe met --json --yes zodra het plan er correct uitziet.

​
Probleemoplossing

Geef --from /actual/path (CLI) of --import-source /actual/path (onboarding) door.
Voor onboardingimports is een nieuwe configuratie vereist. Stel de status opnieuw in en voer de onboarding opnieuw uit, of gebruik openclaw migrate apply claude rechtstreeks, dat --overwrite en expliciet back-upbeheer ondersteunt.
Claude Desktop leest claude_desktop_config.json vanaf een platformspecifiek pad. Laat --from naar de map van dat bestand verwijzen als OpenClaw deze niet automatisch heeft gedetecteerd.
Dit is zo ontworpen. Claude-opdrachten worden door gebruikers geactiveerd, dus OpenClaw importeert ze als skills met disable-model-invocation: true. Bewerk de frontmatter van elke skill als je wilt dat de agent ze automatisch aanroept.

​
Gerelateerd