Skip to main content
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.
Le importazioni durante l’onboarding richiedono una nuova configurazione di OpenClaw. Se disponi già di uno stato locale di OpenClaw, reimposta prima la configurazione, le credenziali, le sessioni e lo spazio di lavoro, oppure usa direttamente openclaw migrate con --overwrite dopo aver esaminato il piano.

​
Due modi per importare

La procedura guidata propone Claude quando rileva uno stato locale di Claude.
In alternativa, indica una sorgente specifica:

​
Elementi importati

  • Il contenuto di CLAUDE.md e .claude/CLAUDE.md del progetto viene copiato o aggiunto al file AGENTS.md nello spazio di lavoro dell’agente OpenClaw.
  • Il contenuto di ~/.claude/CLAUDE.md dell’utente viene aggiunto al file USER.md dello spazio di lavoro.
Le definizioni dei server MCP vengono importate, quando presenti, da .mcp.json del progetto, da ~/.claude.json di Claude Code e da claude_desktop_config.json di Claude Desktop.
  • Le Skills di Claude che contengono un file SKILL.md vengono copiate nella directory delle Skills dello spazio di lavoro OpenClaw.
  • I file Markdown dei comandi Claude in .claude/commands/ o ~/.claude/commands/ vengono convertiti in Skills di OpenClaw con disable-model-invocation: true.

​
Elementi conservati solo nell’archivio

Il provider copia i seguenti elementi nel report di migrazione per consentirne la revisione manuale, ma non li carica nella configurazione attiva di OpenClaw:
  • Hook di Claude
  • Autorizzazioni di Claude ed elenchi estesi di strumenti consentiti
  • Valori predefiniti dell’ambiente Claude
  • CLAUDE.local.md
  • .claude/rules/
  • Sottoagenti Claude in .claude/agents/ o ~/.claude/agents/
  • Cache, piani e directory della cronologia dei progetti di Claude Code
  • Estensioni di Claude Desktop e credenziali archiviate nel sistema operativo
OpenClaw si rifiuta di eseguire gli hook, considerare attendibili gli elenchi di autorizzazioni consentite o decodificare automaticamente lo stato opaco delle credenziali OAuth e Desktop. Dopo aver esaminato l’archivio, trasferisci manualmente ciò che ti serve.

​
Selezione della sorgente

Senza --from, OpenClaw esamina la directory home predefinita di Claude Code in ~/.claude, il file di stato campionato ~/.claude.json di Claude Code e la configurazione MCP di Claude Desktop su macOS. Quando --from indica la 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. Durante l’importazione dalla radice di un progetto, non legge la directory home globale di Claude.

​
Flusso consigliato

1

Visualizza l'anteprima del piano

Il piano elenca tutto ciò che verrà modificato, inclusi i conflitti, gli elementi ignorati e i valori sensibili oscurati nei campi MCP env o headers annidati.
2

Applica con backup

OpenClaw crea e verifica un backup prima dell’applicazione.
3

Esegui doctor

Doctor verifica la presenza di problemi di configurazione o di stato dopo l’importazione.
4

Riavvia e verifica

Verifica che il Gateway funzioni correttamente e che le istruzioni, i server MCP e le Skills importati siano caricati.

​
Gestione dei conflitti

L’applicazione si rifiuta di continuare quando il piano segnala conflitti, ossia quando un file o un valore di configurazione esiste già nella destinazione.
Esegui nuovamente il comando con --overwrite solo quando intendi sostituire la destinazione esistente. I provider possono comunque creare backup a livello di singolo elemento per i file sovrascritti nella directory del report di migrazione.
In una nuova installazione di OpenClaw, i conflitti sono insoliti. In genere si verificano quando esegui nuovamente l’importazione in una configurazione che contiene già modifiche dell’utente.

​
Output JSON per l’automazione

--yes è obbligatorio per migrate apply al di fuori di un terminale interattivo; senza questa opzione, OpenClaw restituisce un errore anziché applicare le modifiche, quindi gli script e la CI devono specificare esplicitamente --yes. Visualizza prima l’anteprima con --dry-run --json, quindi applica le modifiche con --json --yes quando il piano è corretto.

​
Risoluzione dei problemi

Specifica --from /actual/path (CLI) o --import-source /actual/path (onboarding).
Le importazioni durante l’onboarding richiedono una nuova configurazione. Reimposta lo stato ed esegui nuovamente l’onboarding oppure usa direttamente openclaw migrate apply claude, che supporta --overwrite e il controllo esplicito del backup.
Claude Desktop legge claude_desktop_config.json da un percorso specifico della piattaforma. Se OpenClaw non lo ha rilevato automaticamente, indica con --from la directory contenente tale file.
È il comportamento previsto. I comandi Claude vengono attivati dall’utente, quindi OpenClaw li importa come Skills con disable-model-invocation: true. Modifica il frontmatter di ciascuna Skill se vuoi che l’agente le invochi automaticamente.

​
Contenuti correlati