Skip to main content
Il provider di migrazione Hermes incluso rileva lo stato in ~/.hermes, mostra un’anteprima di ogni modifica prima di applicarla, oscura i segreti nei piani e nei report e crea un backup OpenClaw verificato prima di intervenire.
Le importazioni richiedono una nuova configurazione di OpenClaw. Se disponi già di uno stato OpenClaw locale, reimposta prima la configurazione, le credenziali, le sessioni e l’area di lavoro oppure usa direttamente openclaw migrate apply hermes con --overwrite dopo aver esaminato il piano.

​
Due modi per importare

Rileva Hermes in ~/.hermes e mostra un’anteprima prima di applicare le modifiche.
In alternativa, indica un’origine specifica:

​
Elementi importati

  • Selezione del modello predefinito dal file config.yaml di Hermes.
  • Provider di modelli configurati ed endpoint personalizzati compatibili con OpenAI da providers e custom_providers.
Definizioni dei server MCP da mcp_servers o mcp.servers.
  • SOUL.md e AGENTS.md vengono copiati nell’area di lavoro dell’agente OpenClaw.
  • memories/MEMORY.md e memories/USER.md vengono aggiunti ai file di memoria OpenClaw corrispondenti anziché sovrascriverli.
Impostazioni predefinite della configurazione della memoria per la memoria su file di OpenClaw. I provider di memoria esterni, come Honcho, vengono registrati come elementi di archivio o da esaminare manualmente, per consentirti di trasferirli in modo consapevole.
Le Skills con un file SKILL.md in skills/<name>/ vengono copiate insieme ai valori di configurazione specifici di ciascuna Skill da skills.config.
La modalità interattiva di openclaw migrate chiede conferma prima di importare le credenziali di autenticazione, con sì selezionato per impostazione predefinita. Accettando, vengono importate le voci OAuth di OpenAI e GitHub Copilot di OpenCode dal file auth.json di OpenCode, insieme alle chiavi .env di Hermes supportate. Le voci OAuth presenti nel file auth.json di Hermes sono considerate stato legacy: vengono segnalate come elementi che richiedono una nuova autenticazione manuale o un intervento di doctor, anziché essere importate nell’autenticazione attiva. Usa --include-secrets per importare le credenziali in un’esecuzione non interattiva, --no-auth-credentials per ignorarne completamente l’importazione oppure il flag --import-secrets della procedura guidata di onboarding.

​
Elementi mantenuti solo nell’archivio

Il provider copia gli elementi seguenti nella directory del report di migrazione affinché vengano esaminati manualmente, ma non li carica nella configurazione o nelle credenziali attive di OpenClaw:
  • plugins/
  • sessions/
  • logs/
  • cron/
  • mcp-tokens/
  • state.db
OpenClaw rifiuta di eseguire o considerare attendibile questo stato automaticamente, perché i formati e i presupposti di attendibilità possono divergere tra i sistemi. Dopo aver esaminato l’archivio, trasferisci manualmente ciò che ti occorre.

​
Procedura consigliata

1

Visualizza l'anteprima del piano

Il piano elenca tutto ciò che verrà modificato, inclusi conflitti, elementi ignorati ed elementi sensibili. Nell’output vengono oscurate le chiavi annidate che sembrano contenere segreti.
2

Applica con backup

OpenClaw crea e verifica un backup prima di applicare le modifiche. Questo esempio non interattivo importa solo lo stato privo di segreti. Esegui il comando senza --yes per rispondere interattivamente alla richiesta relativa alle credenziali oppure aggiungi --include-secrets per includere le credenziali supportate in un’esecuzione automatica.
3

Esegui doctor

Doctor riapplica le eventuali migrazioni della configurazione in sospeso e verifica la presenza di problemi introdotti durante l’importazione.
4

Riavvia e verifica

Verifica che il Gateway funzioni correttamente e che il modello, la memoria e le Skills importati siano caricati.

​
Gestione dei conflitti

L’applicazione 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 dei singoli elementi per i file sovrascritti nella directory del report di migrazione.
I conflitti sono insoliti in una nuova installazione. In genere si verificano quando ripeti l’importazione in una configurazione che contiene già modifiche dell’utente. Se durante l’applicazione emerge un conflitto, ad esempio a causa di una condizione di concorrenza imprevista su un file di configurazione, Hermes contrassegna gli elementi di configurazione dipendenti rimanenti come skipped con il motivo blocked by earlier apply conflict, anziché scriverli parzialmente. Il report di migrazione registra ogni elemento bloccato, consentendoti di risolvere il conflitto originario e ripetere l’importazione.

​
Segreti

La modalità interattiva di openclaw migrate chiede se importare le credenziali di autenticazione rilevate, con sì selezionato per impostazione predefinita.
  • Accettando, vengono importate le voci OAuth di OpenAI e GitHub Copilot di OpenCode dal file auth.json di OpenCode, insieme alle chiavi .env supportate. Le voci OAuth presenti nel file auth.json di Hermes vengono invece segnalate affinché si esegua manualmente una nuova autenticazione OpenAI o una riparazione tramite doctor.
  • Usa --no-auth-credentials, oppure rispondi no alla richiesta, per importare solo lo stato privo di segreti.
  • Usa --include-secrets per importare le credenziali durante un’esecuzione automatica con --yes.
  • Usa il flag --import-secrets della procedura guidata di onboarding per importare le credenziali dalla procedura guidata.

​
Output JSON per l’automazione

Con --json e senza --yes, l’applicazione stampa il piano e non modifica lo stato: è la modalità più sicura per la CI e gli script condivisi.

​
Risoluzione dei problemi

Esamina l’output del piano. Ogni conflitto identifica il percorso di origine e la destinazione esistente. Per ciascun elemento, decidi se ignorarlo, modificare la destinazione o eseguire nuovamente il comando con --overwrite.
Specifica --from /actual/path per la CLI oppure --import-source /actual/path per l’onboarding.
Le importazioni tramite onboarding richiedono una nuova configurazione. Reimposta lo stato ed esegui nuovamente l’onboarding oppure usa direttamente openclaw migrate apply hermes, che supporta --overwrite e il controllo esplicito del backup.
La modalità interattiva di openclaw migrate importa le chiavi API solo quando accetti la richiesta relativa alle credenziali. Le esecuzioni non interattive con --yes richiedono --include-secrets; le importazioni tramite onboarding richiedono --import-secrets. Vengono riconosciute solo le chiavi .env supportate; le altre variabili .env vengono ignorate.

​
Argomenti correlati

  • openclaw migrate: documentazione di riferimento completa della CLI, contratto del Plugin e strutture JSON.
  • Onboarding: procedura guidata e flag per la modalità non interattiva.
  • Migrazione: trasferimento di un’installazione OpenClaw tra computer.
  • Doctor: controllo dello stato dopo la migrazione.
  • Area di lavoro dell’agente: posizione dei file SOUL.md, AGENTS.md e dei file di memoria.