OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Maintenance

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.

Due modi per importare

Procedura guidata di onboarding

La procedura guidata propone Claude quando rileva uno stato locale di Claude.

bash
openclaw onboard --flow import

In alternativa, indica una sorgente specifica:

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

CLI

Usa openclaw migrate per esecuzioni tramite script o ripetibili. Consulta openclaw migrate per la documentazione di riferimento completa.

bash
openclaw migrate claude --dry-runopenclaw migrate apply claude --yes

Aggiungi --from <path> per importare una directory home di Claude Code o la radice di un progetto specifico.

Elementi importati

Istruzioni e memoria
  • 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.
Server MCP

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.

Skills e comandi
  • 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

  • Visualizza l'anteprima del piano

    bash
    openclaw migrate claude --dry-run

    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.

  • Applica con backup

    bash
    openclaw migrate apply claude --yes

    OpenClaw crea e verifica un backup prima dell'applicazione.

  • Esegui doctor

    bash
    openclaw doctor

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

  • Riavvia e verifica

    bash
    openclaw gateway restartopenclaw status

    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.

    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

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

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

    Lo stato di Claude si trova fuori da ~/.claude

    Specifica --from /actual/path (CLI) o --import-source /actual/path (onboarding).

    L'onboarding rifiuta l'importazione in una configurazione esistente

    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.

    I server MCP di Claude Desktop non sono stati importati

    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.

    I comandi Claude sono diventati Skills con l'invocazione da parte del modello disabilitata

    È 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

    Was this useful?
    On this page

    On this page