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

Maintenance

Migrazione da Hermes

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.

Due modi per importare

Procedura guidata di onboarding

Rileva Hermes in ~/.hermes e mostra un'anteprima prima di applicare le modifiche.

bash
openclaw onboard --flow import

In alternativa, indica un'origine specifica:

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

CLI

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

bash
openclaw migrate hermes --dry-run    # solo anteprimaopenclaw migrate apply hermes --yes  # applica senza richiedere conferma

Aggiungi --from <path> quando Hermes si trova al di fuori di ~/.hermes.

Elementi importati

Configurazione del modello
  • 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.
Server MCP

Definizioni dei server MCP da mcp_servers o mcp.servers.

File dell'area di lavoro
  • 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.
Configurazione della memoria

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.

Skills

Le Skills con un file SKILL.md in skills/<name>/ vengono copiate insieme ai valori di configurazione specifici di ciascuna Skill da skills.config.

Credenziali di autenticazione

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

  • Visualizza l'anteprima del piano

    bash
    openclaw migrate hermes --dry-run

    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.

  • Applica con backup

    bash
    openclaw migrate apply hermes --yes

    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.

  • Esegui doctor

    bash
    openclaw doctor

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

  • Riavvia e verifica

    bash
    openclaw gateway restartopenclaw status

    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.

    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

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

    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

    L'applicazione viene rifiutata a causa di conflitti

    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.

    Hermes si trova al di fuori di ~/.hermes

    Specifica --from /actual/path per la CLI oppure --import-source /actual/path per l'onboarding.

    L'onboarding rifiuta l'importazione in una configurazione esistente

    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.

    Le chiavi API non sono state importate

    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.
    Was this useful?
    On this page

    On this page