---
read_when:
    - Je komt van Claude Code of Claude Desktop en wilt instructies, MCP-servers en Skills behouden
    - U moet begrijpen wat OpenClaw automatisch importeert en wat alleen in het archief blijft
summary: Verplaats de lokale staat van Claude Code en Claude Desktop naar OpenClaw met een vooraf bekeken import
title: Migreren van Claude
x-i18n:
    generated_at: "2026-04-29T22:55:05Z"
    model: gpt-5.5
    provider: openai
    source_hash: 1b44eda85f3a3714d7d360d04fdd2c99a692fa6491f12e73847c5f08d702a62c
    source_path: install/migrating-claude.md
    workflow: 16
---

OpenClaw importeert lokale Claude-status via de gebundelde Claude-migratieprovider. De provider toont elk item vooraf voordat de status wordt gewijzigd, redigeert geheimen in plannen en rapporten, en maakt een geverifieerde back-up vóór het toepassen.

<Note>
Onboarding-imports vereisen een nieuwe OpenClaw-installatie. Als je al lokale OpenClaw-status hebt, reset dan eerst configuratie, referenties, sessies en de werkruimte, of gebruik `openclaw migrate` rechtstreeks met `--overwrite` nadat je het plan hebt beoordeeld.
</Note>

## Twee manieren om te importeren

<Tabs>
  <Tab title="Onboardingwizard">
    De wizard biedt Claude aan wanneer lokale Claude-status wordt gedetecteerd.

    ```bash
    openclaw onboard --flow import
    ```

    Of verwijs naar een specifieke bron:

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

  </Tab>
  <Tab title="CLI">
    Gebruik `openclaw migrate` voor gescripte of herhaalbare runs. Zie [`openclaw migrate`](/nl/cli/migrate) voor de volledige referentie.

    ```bash
    openclaw migrate claude --dry-run
    openclaw migrate apply claude --yes
    ```

    Voeg `--from <path>` toe om een specifieke Claude Code-home of projectroot te importeren.

  </Tab>
</Tabs>

## Wat wordt geïmporteerd

<AccordionGroup>
  <Accordion title="Instructies en geheugen">
    - Projectinhoud van `CLAUDE.md` en `.claude/CLAUDE.md` wordt gekopieerd of toegevoegd aan de OpenClaw-agentwerkruimte `AGENTS.md`.
    - Gebruikersinhoud van `~/.claude/CLAUDE.md` wordt toegevoegd aan werkruimte `USER.md`.

  </Accordion>
  <Accordion title="MCP-servers">
    MCP-serverdefinities worden geïmporteerd uit project `.mcp.json`, Claude Code `~/.claude.json` en Claude Desktop `claude_desktop_config.json` wanneer aanwezig.
  </Accordion>
  <Accordion title="Skills en commando's">
    - Claude Skills met een `SKILL.md`-bestand worden gekopieerd naar de OpenClaw-werkruimte-Skills-directory.
    - Claude Markdown-commandobestanden onder `.claude/commands/` of `~/.claude/commands/` worden omgezet naar OpenClaw Skills met `disable-model-invocation: true`.

  </Accordion>
</AccordionGroup>

## Wat alleen archief blijft

De provider kopieert deze naar het migratierapport voor handmatige beoordeling, maar laadt ze **niet** in live OpenClaw-configuratie:

- Claude-hooks
- Claude-machtigingen en brede allowlists voor tools
- Claude-omgevingsstandaarden
- `CLAUDE.local.md`
- `.claude/rules/`
- Claude-subagents onder `.claude/agents/` of `~/.claude/agents/`
- Claude Code-caches, plannen en projectgeschiedenisdirectory's
- Claude Desktop-extensies en door het besturingssysteem opgeslagen referenties

OpenClaw weigert hooks uit te voeren, allowlists met machtigingen te vertrouwen, of ondoorzichtige OAuth- en Desktop-referentiestatus automatisch te decoderen. Verplaats wat je nodig hebt handmatig nadat je het archief hebt beoordeeld.

## Bronselectie

Zonder `--from` inspecteert OpenClaw de standaard Claude Code-home op `~/.claude`, het bemonsterde Claude Code-statusbestand `~/.claude.json` en de Claude Desktop MCP-configuratie op macOS.

Wanneer `--from` naar een projectroot verwijst, importeert OpenClaw alleen de Claude-bestanden van dat project, zoals `CLAUDE.md`, `.claude/settings.json`, `.claude/commands/`, `.claude/skills/` en `.mcp.json`. Het leest je globale Claude-home niet tijdens een projectrootimport.

## Aanbevolen flow

<Steps>
  <Step title="Bekijk het plan vooraf">
    ```bash
    openclaw migrate claude --dry-run
    ```

    Het plan vermeldt alles wat zal veranderen, inclusief conflicten, overgeslagen items en gevoelige waarden die zijn geredigeerd uit geneste MCP-velden `env` of `headers`.

  </Step>
  <Step title="Toepassen met back-up">
    ```bash
    openclaw migrate apply claude --yes
    ```

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

  </Step>
  <Step title="Voer doctor uit">
    ```bash
    openclaw doctor
    ```

    [Doctor](/nl/gateway/doctor) controleert na de import op configuratie- of statusproblemen.

  </Step>
  <Step title="Herstart en verifieer">
    ```bash
    openclaw gateway restart
    openclaw status
    ```

    Bevestig dat de Gateway gezond is en dat je geïmporteerde instructies, MCP-servers en Skills zijn geladen.

  </Step>
</Steps>

## Conflictafhandeling

Toepassen weigert door te gaan wanneer het plan conflicten meldt (een bestand of configuratiewaarde bestaat al op het doel).

<Warning>
Voer opnieuw uit met `--overwrite` alleen wanneer het vervangen van het bestaande doel opzettelijk is. Providers kunnen nog steeds back-ups op itemniveau schrijven voor overschreven bestanden in de directory van het migratierapport.
</Warning>

Voor een nieuwe OpenClaw-installatie zijn conflicten ongebruikelijk. Ze verschijnen meestal wanneer je de import opnieuw uitvoert op een installatie die al gebruikersbewerkingen bevat.

## JSON-uitvoer voor automatisering

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

Met `--json` en zonder `--yes` drukt apply het plan af en wijzigt het geen status. Dit is de veiligste modus voor CI en gedeelde scripts.

## Problemen oplossen

<AccordionGroup>
  <Accordion title="Claude-status staat buiten ~/.claude">
    Geef `--from /actual/path` (CLI) of `--import-source /actual/path` (onboarding) door.
  </Accordion>
  <Accordion title="Onboarding weigert te importeren op een bestaande installatie">
    Onboarding-imports vereisen een nieuwe installatie. Reset de status en doorloop onboarding opnieuw, of gebruik `openclaw migrate apply claude` rechtstreeks, dat `--overwrite` en expliciete back-upcontrole ondersteunt.
  </Accordion>
  <Accordion title="MCP-servers uit Claude Desktop zijn niet geïmporteerd">
    Claude Desktop leest `claude_desktop_config.json` uit een platformspecifiek pad. Verwijs `--from` naar de directory van dat bestand als OpenClaw het niet automatisch heeft gedetecteerd.
  </Accordion>
  <Accordion title="Claude-commando's werden Skills met modelaanroep uitgeschakeld">
    Dit is zo ontworpen. Claude-commando's worden door de gebruiker 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.
  </Accordion>
</AccordionGroup>

## Gerelateerd

- [`openclaw migrate`](/nl/cli/migrate): volledige CLI-referentie, Plugin-contract en JSON-vormen.
- [Migratiehandleiding](/nl/install/migrating): alle migratiepaden.
- [Migreren vanaf Hermes](/nl/install/migrating-hermes): het andere importsysteem tussen systemen.
- [Onboarding](/nl/cli/onboard): wizardflow en niet-interactieve flags.
- [Doctor](/nl/gateway/doctor): gezondheidscontrole na migratie.
- [Agentwerkruimte](/nl/concepts/agent-workspace): waar `AGENTS.md`, `USER.md` en Skills staan.