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

Maintenance

Guida alla migrazione

OpenClaw supporta tre percorsi di migrazione: l'importazione da un altro sistema di agenti, il trasferimento di un'installazione esistente su un nuovo computer e l'aggiornamento di un plugin sul posto.

Importazione da un altro sistema di agenti

I provider di migrazione inclusi importano in OpenClaw istruzioni, server MCP, Skills, configurazione dei modelli e, facoltativamente, chiavi API. I piani vengono visualizzati in anteprima prima di qualsiasi modifica, i segreti vengono oscurati nei rapporti e l'applicazione è supportata da un backup verificato.

Migrazione da Claude

Importa lo stato di Claude Code e Claude Desktop, inclusi CLAUDE.md, server MCP, Skills e comandi di progetto.
Migrazione da Hermes

Importa configurazione, provider, server MCP, memoria, Skills e chiavi .env supportate di Hermes.

Il punto di ingresso della CLI è openclaw migrate. Anche la configurazione iniziale può proporre la migrazione quando rileva un'origine nota (openclaw onboard --flow import).

Trasferire OpenClaw su un nuovo computer

Copia la directory di stato (~/.openclaw/ per impostazione predefinita) e il tuo spazio di lavoro per conservare:

  • Configurazione — openclaw.json e tutte le impostazioni del Gateway.
  • Autenticazione — il file auth-profiles.json di ciascun agente (chiavi API e OAuth), oltre a qualsiasi stato dei canali o dei provider in credentials/.
  • Sessioni — cronologia delle conversazioni e stato degli agenti.
  • Stato dei canali — accesso a WhatsApp, sessione di Telegram e dati simili.
  • File dello spazio di lavoro — MEMORY.md, USER.md, Skills e prompt.

Passaggi della migrazione

  • Arrestare il Gateway ed eseguire il backup

    Sul vecchio computer, arresta il Gateway affinché i file non vengano modificati durante la copia, quindi crea l'archivio:

    bash
    openclaw gateway stopcd ~tar -czf openclaw-state.tgz .openclaw

    Se utilizzi più profili (ad esempio ~/.openclaw-work), archivia ciascuno separatamente.

  • Installare OpenClaw sul nuovo computer

    Installa la CLI (e Node, se necessario) sul nuovo computer. Non è un problema se la configurazione iniziale crea una nuova directory ~/.openclaw/: la sovrascriverai nel passaggio successivo.

  • Copiare la directory di stato e lo spazio di lavoro

    Trasferisci l'archivio tramite scp, rsync -a o un'unità esterna, quindi estrailo:

    bash
    cd ~tar -xzf openclaw-state.tgz

    Verifica che siano state incluse le directory nascoste e che la proprietà dei file corrisponda all'utente che eseguirà il Gateway.

  • Eseguire Doctor e verificare

    Sul nuovo computer, esegui Doctor per applicare le migrazioni della configurazione e riparare i servizi:

    bash
    openclaw doctoropenclaw gateway restartopenclaw status

    • Se Telegram o Discord utilizza la variabile d'ambiente di ripiego predefinita (TELEGRAM_BOT_TOKEN o DISCORD_BOT_TOKEN), verifica che il file .env nella directory di stato migrata contenga tali chiavi senza stampare i valori segreti:

    bash
    awk -F= '/^(TELEGRAM_BOT_TOKEN|DISCORD_BOT_TOKEN)=/ { print $1 "=present" }' ~/.openclaw/.env

    openclaw doctor avvisa inoltre quando un account predefinito di Telegram o Discord è abilitato ma non dispone di un token configurato e la variabile d'ambiente corrispondente non è disponibile per il processo Doctor.

    Problemi comuni

    Profilo o directory di stato non corrispondenti

    Se il vecchio Gateway utilizzava --profile o OPENCLAW_STATE_DIR e quello nuovo non li utilizza, i canali risulteranno disconnessi e le sessioni saranno vuote. Avvia il Gateway con lo stesso profilo o la stessa directory di stato che hai migrato, quindi esegui nuovamente openclaw doctor.

    Copia del solo file openclaw.json

    Il solo file di configurazione non è sufficiente. I profili di autenticazione dei modelli si trovano in agents/<agentId>/agent/auth-profiles.json, mentre lo stato dei canali e dei provider si trova in credentials/. Migra sempre l'intera directory di stato.

    Permessi e proprietà

    Se hai eseguito la copia come utente root o hai cambiato utente, il Gateway potrebbe non riuscire a leggere le credenziali. Assicurati che la directory di stato e lo spazio di lavoro appartengano all'utente che esegue il Gateway.

    Modalità remota

    Se la tua interfaccia utente è connessa a un Gateway remoto, l'host remoto contiene le sessioni e lo spazio di lavoro. Migra l'host del Gateway, non il tuo portatile locale. Consulta le domande frequenti.

    Segreti nei backup

    La directory di stato contiene profili di autenticazione, credenziali dei canali e altri dati di stato dei provider. Conserva i backup in forma crittografata, evita canali di trasferimento non sicuri e ruota le chiavi se sospetti un'esposizione.

    Elenco di verifica

    Sul nuovo computer, verifica quanto segue:

    • [ ] openclaw status mostra che il Gateway è in esecuzione.
    • [ ] I canali sono ancora connessi e non richiedono un nuovo abbinamento.
    • [ ] La dashboard si apre e mostra le sessioni esistenti.
    • [ ] I file dello spazio di lavoro (memoria e configurazioni) sono presenti.

    Aggiornare un plugin sul posto

    Gli aggiornamenti sul posto dei plugin mantengono lo stesso ID del plugin e le stesse chiavi di configurazione, ma possono spostare lo stato su disco nella struttura corrente. Le guide di aggiornamento specifiche dei plugin si trovano accanto ai relativi canali:

    • Migrazione di Matrix: limiti del ripristino dello stato crittografato, comportamento delle istantanee automatiche e comandi di ripristino manuale.

    Contenuti correlati

    Was this useful?
    On this page

    On this page