Vai al contenuto principale
OpenClaw importa lo stato di Hermes tramite un provider di migrazione incluso. Il provider mostra un’anteprima di tutto prima di modificare lo stato, oscura i segreti nei piani e nei report e crea un backup verificato prima dell’applicazione.
Le importazioni richiedono una configurazione OpenClaw nuova. Se hai già uno stato OpenClaw locale, reimposta prima configurazione, credenziali, sessioni e workspace, oppure usa direttamente openclaw migrate con --overwrite dopo aver esaminato il piano.

​
Due modi per importare

Il percorso più rapido. La procedura guidata rileva Hermes in ~/.hermes e mostra un’anteprima prima di applicare le modifiche.
openclaw onboard --flow import
Oppure indica una sorgente specifica:
openclaw onboard --import-from hermes --import-source ~/.hermes

​
Cosa viene importato

  • Selezione del modello predefinito da 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 nel workspace dell’agente OpenClaw.
  • memories/MEMORY.md e memories/USER.md vengono aggiunti in coda ai file di memoria OpenClaw corrispondenti invece di 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 di revisione manuale, così puoi spostarli in modo deliberato.
Le Skills con un file SKILL.md in skills/<name>/ vengono copiate, insieme ai valori di configurazione per singola skill da skills.config.
openclaw migrate interattivo chiede conferma prima di importare le credenziali di autenticazione, con sì selezionato per impostazione predefinita. Le importazioni accettate includono credenziali OpenAI OAuth di OpenCode da auth.json di OpenCode, voci OpenCode e GitHub Copilot da auth.json di OpenCode e le chiavi .env supportate. Le voci OAuth di auth.json di Hermes sono stato legacy e vengono presentate come lavoro manuale di riautenticazione/doctor invece di essere importate nell’autenticazione live. Usa --include-secrets per l’importazione non interattiva delle credenziali con openclaw migrate, --no-auth-credentials per saltarla, oppure --import-secrets dell’onboarding quando importi dalla procedura guidata di onboarding.

​
Cosa resta solo nell’archivio

Il provider copia questi elementi nella directory del report di migrazione per la revisione manuale, ma non li carica nella configurazione o nelle credenziali OpenClaw live:
  • plugins/
  • sessions/
  • logs/
  • cron/
  • mcp-tokens/
  • state.db
OpenClaw rifiuta di eseguire o considerare attendibile automaticamente questo stato perché i formati e le assunzioni di attendibilità possono divergere tra sistemi. Sposta a mano ciò che ti serve dopo aver esaminato l’archivio.

​
Flusso consigliato

1

Visualizza l'anteprima del piano

openclaw migrate hermes --dry-run
Il piano elenca tutto ciò che cambierà, inclusi conflitti, elementi saltati ed eventuali elementi sensibili. L’output del piano oscura le chiavi annidate che sembrano segreti.
2

Applica con backup

openclaw migrate apply hermes --yes
OpenClaw crea e verifica un backup prima di applicare le modifiche. Questo esempio non interattivo importa stato non segreto. Esegui senza --yes per rispondere alla richiesta sulle credenziali, oppure aggiungi --include-secrets per includere le credenziali supportate nelle esecuzioni non presidiate.
3

Esegui doctor

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

Riavvia e verifica

openclaw gateway restart
openclaw status
Conferma che il gateway sia integro e che il modello, la memoria e le skill importati siano caricati.

​
Gestione dei conflitti

L’applicazione rifiuta di continuare quando il piano segnala conflitti (un file o un valore di configurazione esiste già nella destinazione).
Riesegui con --overwrite solo quando sostituire la destinazione esistente è intenzionale. I provider possono comunque scrivere backup a livello di elemento per i file sovrascritti nella directory del report di migrazione.
Per una nuova installazione di OpenClaw, i conflitti sono insoliti. Di solito compaiono quando riesegui l’importazione su una configurazione che contiene già modifiche dell’utente. Se un conflitto emerge a metà applicazione (ad esempio, una race imprevista su un file di configurazione), Hermes contrassegna gli elementi di configurazione dipendenti rimanenti come skipped con motivo blocked by earlier apply conflict invece di scriverli parzialmente. Il report di migrazione registra ogni elemento bloccato, così puoi risolvere il conflitto originale e rieseguire l’importazione.

​
Segreti

openclaw migrate interattivo chiede se importare le credenziali di autenticazione rilevate, con sì selezionato per impostazione predefinita.
  • Accettando la richiesta, vengono importate credenziali OpenAI OAuth di OpenCode da auth.json di OpenCode, voci OpenCode e GitHub Copilot da auth.json di OpenCode e le chiavi .env supportate. Le voci OAuth di auth.json di Hermes vengono segnalate per la riautenticazione manuale a OpenAI o la riparazione con doctor.
  • Usa --no-auth-credentials o scegli no alla richiesta per importare solo stato non segreto.
  • Usa --include-secrets quando esegui senza supervisione con --yes.
  • Usa --import-secrets dell’onboarding quando importi credenziali dalla procedura guidata di onboarding.
  • Per le credenziali gestite da SecretRef, configura la sorgente SecretRef dopo il completamento dell’importazione.

​
Output JSON per l’automazione

openclaw migrate hermes --dry-run --json
openclaw migrate apply hermes --json --yes
Con --json e senza --yes, l’applicazione stampa il piano e non modifica lo stato. Questa è la modalità più sicura per CI e script condivisi.

​
Risoluzione dei problemi

Ispeziona l’output del piano. Ogni conflitto identifica il percorso sorgente e la destinazione esistente. Decidi per ogni elemento se saltarlo, modificare la destinazione o rieseguire con --overwrite.
Passa --from /actual/path (CLI) o --import-source /actual/path (onboarding).
Le importazioni tramite onboarding richiedono una configurazione nuova. Reimposta lo stato ed esegui di nuovo l’onboarding, oppure usa direttamente openclaw migrate apply hermes, che supporta --overwrite e il controllo esplicito del backup.
openclaw migrate interattivo importa le chiavi API solo quando accetti la richiesta sulle 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 in .env vengono ignorate.

​
Correlati

  • openclaw migrate: riferimento CLI completo, contratto del plugin e forme JSON.
  • Onboarding: flusso della procedura guidata e flag non interattivi.
  • Migrazione: spostare un’installazione OpenClaw tra macchine.
  • Doctor: controllo di integrità post-migrazione.
  • Workspace dell’agente: dove risiedono SOUL.md, AGENTS.md e i file di memoria.