Vai al contenuto principale

​
Migrazione di OpenClaw su una nuova macchina

Questa guida sposta un gateway OpenClaw su una nuova macchina senza rifare l’onboarding.

​
Cosa viene migrato

Quando copi la directory di stato (~/.openclaw/ per impostazione predefinita) e il tuo workspace, preservi:
  • Configurazione — openclaw.json e tutte le impostazioni del gateway
  • Autenticazione — auth-profiles.json per agente (chiavi API + OAuth), oltre a qualsiasi stato di canale/provider sotto credentials/
  • Sessioni — cronologia delle conversazioni e stato dell’agente
  • Stato dei canali — accesso WhatsApp, sessione Telegram, ecc.
  • File del workspace — MEMORY.md, USER.md, Skills e prompt
Esegui openclaw status sulla vecchia macchina per confermare il percorso della directory di stato. I profili personalizzati usano ~/.openclaw-<profile>/ o un percorso impostato tramite OPENCLAW_STATE_DIR.

​
Passaggi della migrazione

1

Arresta il gateway ed esegui un backup

Sulla macchina vecchia, arresta il gateway in modo che i file non cambino durante la copia, quindi crea un archivio:
openclaw gateway stop
cd ~
tar -czf openclaw-state.tgz .openclaw
Se usi più profili (ad esempio ~/.openclaw-work), archivia ciascuno separatamente.
2

Installa OpenClaw sulla nuova macchina

Installa la CLI (e Node, se necessario) sulla nuova macchina. Va bene se l’onboarding crea un nuovo ~/.openclaw/ — lo sovrascriverai nel passaggio successivo.
3

Copia la directory di stato e il workspace

Trasferisci l’archivio tramite scp, rsync -a o un’unità esterna, quindi estrailo:
cd ~
tar -xzf openclaw-state.tgz
Assicurati che le directory nascoste siano state incluse e che la proprietà dei file corrisponda all’utente che eseguirà il gateway.
4

Esegui doctor e verifica

Sulla nuova macchina, esegui Doctor per applicare le migrazioni di configurazione e riparare i servizi:
openclaw doctor
openclaw gateway restart
openclaw status

​
Problemi comuni

Se il vecchio gateway usava --profile o OPENCLAW_STATE_DIR e quello nuovo no, 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 riesegui openclaw doctor.
Il solo file di configurazione non basta. I profili di autenticazione dei modelli si trovano in agents/<agentId>/agent/auth-profiles.json, e lo stato di canali/provider si trova ancora sotto credentials/. Migra sempre l’intera directory di stato.
Se hai copiato come root o hai cambiato utente, il gateway potrebbe non riuscire a leggere le credenziali. Assicurati che la directory di stato e il workspace appartengano all’utente che esegue il gateway.
Se la tua UI punta a un gateway remoto, l’host remoto possiede sessioni e workspace. Migra l’host del gateway stesso, non il tuo laptop locale. Vedi FAQ.
La directory di stato contiene profili di autenticazione, credenziali dei canali e altro stato dei provider. Conserva i backup in forma cifrata, evita canali di trasferimento non sicuri e ruota le chiavi se sospetti un’esposizione.

​
Checklist di verifica

Sulla nuova macchina, conferma:
  • openclaw status mostra il gateway in esecuzione
  • I canali sono ancora connessi (non è necessario ripetere il pairing)
  • La dashboard si apre e mostra le sessioni esistenti
  • I file del workspace (memoria, configurazioni) sono presenti