Migrare OpenClaw a Hermes: cosa viene trasferito e cosa viene archiviato

Migrare OpenClaw a Hermes richiede un solo comando ufficiale: hermes claw migrate. Legge ~/.openclaw/, mostra un'anteprima completa prima di scrivere qualsiasi cosa e, per impostazione predefinita, scrive prima uno zip con il punto di ripristino — ma non importa i job cron, ed è proprio questa omissione che fa iniziare silenziosamente a pagare due volte una configurazione migrata. L'ordine sicuro è eseguire il backup, fare una simulazione, applicare, verificare in una sessione nuova, arrestare il vecchio pianificatore e infine eseguire la pulizia.

Fissa prima di tutto le entità, perché questa query entra in conflitto con tre prodotti non correlati. Questa pagina riguarda Hermes Agent di Nous Research — il CLI e il gateway, ultima release v0.21.3 (tag v2026.9.14, pubblicata il 14 settembre 2026) — e OpenClaw di OpenClaw Foundation, ultima release v2026.9.5, pubblicata il 19 settembre 2026. Entrambi i repository erano attivi e non archiviati quando i relativi metadati sono stati ricontrollati il 21 settembre 2026. Non si tratta di Hermes 4, la distinta famiglia di modelli open-weight di Nous Research; né del motore JavaScript Hermes di Meta; né della casa di lusso. Se utilizzi ancora ~/.clawdbot/ o ~/.moltbot/, si tratta dello stesso prodotto con nomi precedenti, e l'importatore rileva entrambe le directory e i nomi dei file di configurazione clawdbot.json / moltbot.json.

Perché le persone si spostano e chi non dovrebbe farlo

Il prezzo non è il motivo. Entrambi i progetti sono software libero: il README di OpenClaw afferma che "non ha un livello a pagamento, un servizio hosted o un token", e il suo file LICENSE è un MIT semplice, anche se l'API GitHub riporta il campo della licenza del repository come NOASSERTION: cita il file, non il campo. Hermes Agent è indicato come MIT dall'API GitHub. In entrambi i casi paghi i token dei modelli e l'host su cui esegui il gateway.

Una correzione da tenere presente, perché le pagine comparative più vecchie non sono aggiornate: la direzione inversa non è più limitata alla memoria. OpenClaw ora documenta una migrazione completa con anteprima — openclaw migrate hermes --dry-run, quindi openclaw migrate apply hermes --yes — che importa configurazione dei modelli, provider ed endpoint personalizzati, server MCP, SOUL.md e AGENTS.md, file di memoria (accodati), configurazione della memoria, skill con la relativa configurazione e credenziali di autenticazione previo consenso. Ciò che la documentazione descrive ancora come copia di sola memoria sono le importazioni della memoria durante l'onboarding e nella Control UI, che collocano MEMORY.md e USER.md in memory/imports/hermes/ senza modificare la memoria esistente del workspace. È quindi una porta a due vie, con un avvertimento sul viaggio di ritorno: non lasciare che Hermes e OpenClaw condividano lo stesso refresh grant.

Cosa viene migrato e cosa viene invece archiviato

Leggi questa tabella come elenco di accettazione. Qualsiasi elemento nella colonna di destra è un'attività da svolgere manualmente, secondo una pianificazione scelta da te, e non indica un errore dello strumento: Hermes lo archivia deliberatamente in ~/.hermes/migration/openclaw/<timestamp>/archive/.

Due mappature sono lossy in un modo che una checklist nasconde. agents.defaults.timeoutSeconds non diventa un timeout Hermes: diventa agent.max_turns, calcolato come timeoutSeconds / 10 e limitato a 200. Inoltre, il vocabolario OpenClaw di dieci valori per lo sforzo di ragionamento collassa in tre: always, high e xhigh diventano tutti high; auto, medium e adaptive diventano medium; off, low, none e minimal diventano low. Entrambi sono calcoli, non copie, quindi controlla i valori risultanti invece di presumere che la precedente regolazione sia sopravvissuta. I timer di inattività della sessione e di reset giornaliero non vengono importati affatto: le conversazioni Hermes persistono fino a un /new o /reset esplicito. Tutto ciò proviene dalla guida ufficiale migrate-from-OpenClaw, letta il 19 settembre 2026.

Il comando, flag per flag

Un ordine operativo che segue la checklist ufficiale post-migrazione senza inventare passaggi. Primo, arresta la pianificazione di OpenClaw: openclaw cron list, quindi openclaw cron disable <job-id> per qualsiasi elemento che potrebbe duplicarsi (openclaw automations è un alias documentato per entrambi). Secondo, esegui la simulazione. Terzo, applica lasciando che venga scritto lo zip predefinito del punto di ripristino. Quarto, leggi il rapporto di migrazione e tutto ciò che si trova nella directory dell'archivio. Quinto — questo coglie molti alla sprovvista — avvia una nuova sessione; le skill importate e le voci di memoria non diventano effettive nella sessione già aperta, e /skills conferma cosa è stato caricato. Sesto, hermes status per l'autenticazione dei provider, riavvia il gateway se hai spostato token della piattaforma e ripeti l'abbinamento di WhatsApp se lo utilizzavi. Solo dopo che tutto questo è riuscito, esegui hermes claw cleanup, che rinomina le directory OpenClaw residue in .pre-migration/ affinché due agenti non possano leggere lo stesso stato. È un sottocomando separato, non un flag di migrate; la guida non documenta flag propri per esso.

L'avvertenza sull'ordine è onesta, anche se poco rassicurante: la documentazione di Hermes colloca la pulizia al passaggio 8 e non specifica cosa accada se un servizio gateway OpenClaw è ancora installato quando la sua directory viene rinominata. Arrestare prima il pianificatore e il gateway OpenClaw è difendibile sulla base della documentazione di entrambi i progetti; non è però una sequenza esplicitata da nessuno dei due.

Il costo della pianificazione duplicata, calcolato

I job cron vengono archiviati, non importati. Quindi il guasto naturale è questo: ricrei quattro job in Hermes, il gateway OpenClaw è ancora installato e ogni prompt pianificato viene ora eseguito due volte sul tuo provider. Ecco quanto costa in termini di calcolo dei token, non costo misurato di un job e non limite massimo della fattura. Supponi che ogni esecuzione pianificata invii 25.000 token di input non memorizzati nella cache e restituisca 1.500 token di output, e che quattro job eseguiti ogni due ore producano 48 esecuzioni duplicate al giorno. Le tariffe sono i prezzi attuali del catalogo Kunavo per milione di token.

Sostituisci la forma e la cadenza delle tue esecuzioni; il punto è il moltiplicatore, non la riga. Se il lavoro duplicato è già in esecuzione, Hermes documenta una sola leva: hermes pause è un arresto globale di emergenza — non vengono avviate nuove esecuzioni cron, nessuna attività kanban viene dispatchata e nessun turno del gateway inizia fino a hermes resume, mentre il lavoro in corso non viene terminato. Usalo per arrestare l'emorragia, quindi disabilita il lato corretto. Nota il limite di autorizzazione sul lato OpenClaw: il suo riferimento alle automazioni afferma che add/create, edit, remove e run richiedono operator.admin. Non specifica se disable rientri in quell'insieme, quindi prevedi la necessità di quel ruolo.

Vale la pena indicare altre due fonti di costo post-migrazione meno evidenti. La pagina di configurazione dei modelli di Hermes avverte che le cache dei prompt sono associate al modello che serve la richiesta, quindi un cambio di /model durante una conversazione fa rileggere al messaggio successivo l'intera conversazione al prezzo pieno dei token di input; la pagina fallback-providers afferma lo stesso per un fallback automatico, mentre la pagina credential-pools specifica che le cache lato provider sono associate all'account o alla chiave che ha effettuato la richiesta, quindi una rotazione del pool costa anch'essa un passaggio a prezzo pieno. Su Claude Sonnet 4.6 alle tariffe di catalogo, rileggere una conversazione di 200.000 token costa circa $0,420 alla tariffa di input $2,10, contro circa $0,042 alla tariffa di lettura dalla cache $0,21: ancora una volta, calcolo illustrativo basato sulle ipotesi dichiarate. Hermes offre model.switch_context_confirm_tokens come protezione. Separatamente, la stessa pagina afferma che gli slot ausiliari — visione, riepilogo web, compressione e altro — usano per impostazione predefinita provider: auto con un model vuoto, cosa che interpreta come utilizzo del modello principale per quell'attività; quindi una configurazione appena migrata può fatturare tariffe da modello flagship per le attività in background finché non le sovrascrivi.

Puntare Hermes migrato al proprio endpoint

La documentazione dei provider di Hermes afferma che funziona con qualsiasi endpoint API compatibile con OpenAI. La trappola specifica della migrazione riguarda dove finisce il provider importato: una voce OpenClaw models.providers.* viene scritta in custom_providers e diventa una voce nel dizionario canonico providers: solo durante la successiva migrazione della configurazione con hermes update. Una guida che ti dice di cercare in providers: subito dopo la migrazione ti sta indirizzando a una chiave vuota.

# What `hermes claw migrate` writes FIRST. An OpenClaw
# `models.providers.*` entry lands under `custom_providers`,
# not under `providers:` — so check here right after migrating.
custom_providers:
  - name: kunavo
    base_url: https://api.kunavo.com/v1
    api_key: sk-your-kunavo-key
    model: claude-sonnet-4-6

# The providers doc says the legacy list is auto-migrated to the
# canonical `providers:` dict on `hermes update` (config v12). The
# documented keys of that dict are `api`, `key_env`, `transport`
# and `default_model` (`base_url`/`url` are accepted aliases of `api`).
providers:
  kunavo:
    api: https://api.kunavo.com/v1
    key_env: KUNAVO_API_KEY
    transport: chat_completions
    default_model: claude-sonnet-4-6

Tre note su quel blocco. L'importatore mappa sia i valori API brevi (openai, anthropic) sia quelli con trattini (openai-completions, anthropic-messages, google-generative-ai) da OpenClaw. La documentazione di Hermes non è coerente sul nome del trasporto: il riferimento dei provider elenca chat_completions, anthropic_messages e codex_responses, mentre la pagina di configurazione dei modelli scrive transport: openai_chat; usa chat_completions, che è il valore indicato dal riferimento dedicato dei provider, e considera openai_chat non confermato. Gli endpoint personalizzati compatibili con OpenAI non ricevono in Hermes alcun limite automatico dell'output delle dimensioni del catalogo, quindi imposta tu context_length oppure fornisci un elenco esplicito models: con discover_models: false se il rilevamento sul tuo endpoint non funziona come previsto.

Per essere espliciti sui limiti di questa pagina: Kunavo pubblica riferimenti di configurazione per diversi client, ma Hermes Agent non è stato testato in runtime qui, per questo articolo non è stato eseguito alcun hermes claw migrate e non è stato verificato se il trasporto anthropic_messages di Hermes o il rilevamento dei suoi modelli funzionino con l'endpoint Kunavo. Mantieni disponibile un percorso funzionante mentre lo provi. Alle tariffe di catalogo, Claude Sonnet 4.6 indica $2,10 per milione di token di input e $10,50 per milione di token di output; l'importo del catalogo Kunavo è un minimo di fatturazione, non un limite, poiché quando l'upstream comunica il proprio addebito la fattura è il maggiore tra il costo di catalogo e il costo upstream moltiplicato per il markup applicabile. La ricarica minima è di $10 in credito prepagato: un minimo di finanziamento, non un costo per attività né un abbonamento. Consulta i dettagli sulla fatturazione e crea un account Kunavo quando sei pronto a finanziare una chiave.

Dopo il primo giorno, fai una verifica. Hermes include hermes insights, che il riferimento CLI descrive solo come "mostra analisi di token/costi/attività" e documenta senza flag; quindi leggi hermes insights --help per sapere cosa accetta effettivamente la tua build e confrontalo con l'utilizzo registrato dal tuo account provider. Se i due dati non coincidono, cerca una pianificazione duplicata prima di cercare un errore di prezzo. Per informazioni di contesto su questo metodo, consulta ottimizzazione dei costi dell'IA; per il quadro dei piani di ciascun lato, prezzi di Hermes Agent e prezzi di OpenClaw, e Hermes vs OpenClaw se non hai ancora deciso di effettuare il passaggio.

Domande frequenti

Documentazione, riferimenti CLI e metadati dei repository di Hermes Agent e OpenClaw verificati il 19 settembre 2026, rispettivamente con Hermes v0.21.3 (v2026.9.14) e OpenClaw v2026.9.5; metadati dei repository ricontrollati il 21 settembre 2026. Ogni comando, flag e percorso di questa pagina è stato letto dalle fonti ufficiali; non è stata eseguita alcuna migrazione e nessuna chiave Kunavo è stata puntata su uno dei due agenti, quindi nulla di ciò costituisce un test di compatibilità. Le tariffe dei token Kunavo provengono dal catalogo in tempo reale e ogni cifra in dollari è un calcolo illustrativo dei token, non un costo misurato.