> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Migrazione da Claude

OpenClaw importa lo stato locale di Claude tramite il provider di migrazione Claude incluso. Il provider mostra un'anteprima di ogni elemento prima di modificare lo stato, oscura i segreti nei piani e nei report e crea un backup verificato prima dell'applicazione.

<Note>
  Le importazioni durante l'onboarding richiedono una configurazione OpenClaw nuova. Se hai già uno stato OpenClaw locale, reimposta prima configurazione, credenziali, sessioni e workspace, oppure usa direttamente `openclaw migrate` con `--overwrite` dopo aver esaminato il piano.
</Note>

## Due modi per importare

<Tabs>
  <Tab title="Procedura guidata di onboarding">
    La procedura guidata propone Claude quando rileva uno stato Claude locale.

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw onboard --flow import
    ```

    Oppure punta a una sorgente specifica:

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw onboard --import-from claude --import-source ~/.claude
    ```
  </Tab>

  <Tab title="CLI">
    Usa `openclaw migrate` per esecuzioni tramite script o ripetibili. Vedi [`openclaw migrate`](/it/cli/migrate) per il riferimento completo.

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw migrate claude --dry-run
    openclaw migrate apply claude --yes
    ```

    Aggiungi `--from <path>` per importare una home Claude Code o una radice di progetto specifica.
  </Tab>
</Tabs>

## Cosa viene importato

<AccordionGroup>
  <Accordion title="Istruzioni e memoria">
    * Il contenuto di progetto `CLAUDE.md` e `.claude/CLAUDE.md` viene copiato o aggiunto al file `AGENTS.md` del workspace dell'agente OpenClaw.
    * Il contenuto utente `~/.claude/CLAUDE.md` viene aggiunto a `USER.md` del workspace.
  </Accordion>

  <Accordion title="Server MCP">
    Le definizioni dei server MCP vengono importate da `.mcp.json` del progetto, da Claude Code `~/.claude.json` e da Claude Desktop `claude_desktop_config.json` quando presenti.
  </Accordion>

  <Accordion title="Skills e comandi">
    * Le Skills di Claude con un file `SKILL.md` vengono copiate nella directory Skills del workspace OpenClaw.
    * I file Markdown dei comandi Claude in `.claude/commands/` o `~/.claude/commands/` vengono convertiti in Skills OpenClaw con `disable-model-invocation: true`.
  </Accordion>
</AccordionGroup>

## Cosa resta solo in archivio

Il provider copia questi elementi nel report di migrazione per la revisione manuale, ma **non** li carica nella configurazione OpenClaw attiva:

* Hook Claude
* Autorizzazioni Claude e allowlist ampie degli strumenti
* Valori predefiniti dell'ambiente Claude
* `CLAUDE.local.md`
* `.claude/rules/`
* Subagenti Claude in `.claude/agents/` o `~/.claude/agents/`
* Cache, piani e directory della cronologia dei progetti di Claude Code
* Estensioni Claude Desktop e credenziali archiviate dal sistema operativo

OpenClaw rifiuta di eseguire hook, considerare attendibili le allowlist delle autorizzazioni o decodificare automaticamente lo stato opaco delle credenziali OAuth e Desktop. Sposta manualmente ciò che ti serve dopo aver esaminato l'archivio.

## Selezione della sorgente

Senza `--from`, OpenClaw ispeziona la home predefinita di Claude Code in `~/.claude`, il file di stato campionato di Claude Code `~/.claude.json` e la configurazione MCP di Claude Desktop su macOS.

Quando `--from` punta alla radice di un progetto, OpenClaw importa solo i file Claude di quel progetto, come `CLAUDE.md`, `.claude/settings.json`, `.claude/commands/`, `.claude/skills/` e `.mcp.json`. Non legge la tua home Claude globale durante un'importazione dalla radice del progetto.

## Flusso consigliato

<Steps>
  <Step title="Visualizza l'anteprima del piano">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw migrate claude --dry-run
    ```

    Il piano elenca tutto ciò che cambierà, inclusi conflitti, elementi saltati e valori sensibili oscurati dai campi MCP annidati `env` o `headers`.
  </Step>

  <Step title="Applica con backup">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw migrate apply claude --yes
    ```

    OpenClaw crea e verifica un backup prima di applicare le modifiche.
  </Step>

  <Step title="Esegui doctor">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw doctor
    ```

    [Doctor](/it/gateway/doctor) verifica eventuali problemi di configurazione o stato dopo l'importazione.
  </Step>

  <Step title="Riavvia e verifica">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw gateway restart
    openclaw status
    ```

    Conferma che il Gateway sia integro e che le istruzioni, i server MCP e le Skills importati siano caricati.
  </Step>
</Steps>

## Gestione dei conflitti

L'applicazione rifiuta di continuare quando il piano segnala conflitti (un file o valore di configurazione esiste già nella destinazione).

<Warning>
  Esegui di nuovo con `--overwrite` solo quando la sostituzione della destinazione esistente è intenzionale. I provider possono comunque scrivere backup a livello di elemento per i file sovrascritti nella directory dei report di migrazione.
</Warning>

Per una nuova installazione OpenClaw, i conflitti sono insoliti. In genere compaiono quando riesegui l'importazione su una configurazione che contiene già modifiche utente.

## Output JSON per automazione

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw migrate claude --dry-run --json
openclaw migrate apply claude --json --yes
```

Con `--json` e senza `--yes`, apply stampa il piano e non modifica lo stato. Questa è la modalità più sicura per CI e script condivisi.

## Risoluzione dei problemi

<AccordionGroup>
  <Accordion title="Lo stato Claude si trova fuori da ~/.claude">
    Passa `--from /actual/path` (CLI) o `--import-source /actual/path` (onboarding).
  </Accordion>

  <Accordion title="L'onboarding rifiuta l'importazione su una configurazione esistente">
    Le importazioni durante l'onboarding richiedono una configurazione nuova. Reimposta lo stato e ripeti l'onboarding, oppure usa direttamente `openclaw migrate apply claude`, che supporta `--overwrite` e il controllo esplicito dei backup.
  </Accordion>

  <Accordion title="I server MCP da Claude Desktop non sono stati importati">
    Claude Desktop legge `claude_desktop_config.json` da un percorso specifico della piattaforma. Punta `--from` alla directory di quel file se OpenClaw non lo ha rilevato automaticamente.
  </Accordion>

  <Accordion title="I comandi Claude sono diventati Skills con invocazione del modello disabilitata">
    È intenzionale. I comandi Claude vengono attivati dall'utente, quindi OpenClaw li importa come Skills con `disable-model-invocation: true`. Modifica il frontmatter di ogni skill se vuoi che l'agente le invochi automaticamente.
  </Accordion>
</AccordionGroup>

## Correlati

* [`openclaw migrate`](/it/cli/migrate): riferimento CLI completo, contratto del Plugin e forme JSON.
* [Guida alla migrazione](/it/install/migrating): tutti i percorsi di migrazione.
* [Migrazione da Hermes](/it/install/migrating-hermes): l'altro percorso di importazione tra sistemi.
* [Onboarding](/it/cli/onboard): flusso della procedura guidata e flag non interattivi.
* [Doctor](/it/gateway/doctor): controllo di integrità post-migrazione.
* [Workspace dell'agente](/it/concepts/agent-workspace): dove si trovano `AGENTS.md`, `USER.md` e le Skills.