Se hai OpenClaw che gira da un po', Hermes Agent ne è il successore. Stessa stirpe del progetto, gli stessi maintainer, un rebranding e un redesign sopra. L'installer di Hermes è stato fatto apposta per riconoscerlo — v0.14.0 si porta dietro un comando di prima classe, hermes claw migrate, che importa il tuo stato OpenClaw esistente in un colpo solo, con supporto al dry-run e preset espliciti.
Qui sotto la guida pratica di migrazione: cosa viene portato, quali flag hai, e il flusso "prima il dry-run" che ti risparmia brutte sorprese.
1. Installare Hermes Agent
La procedura guidata di setup di Hermes riconosce ~/.openclaw da sola e ti propone la migrazione prima di iniziare la configurazione. La strada più veloce:
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.bashrc
hermes setup
Quando la procedura vede la tua home OpenClaw, ti chiede se vuoi migrare. Dici sì — ma se vuoi vedere esattamente cosa verrebbe migrato prima, esci dalla procedura e lanci direttamente il comando migrate.
2. Anteprima con --dry-run
Questo passo prima di tutto. Elenca tutto quello che il migratore importerebbe senza scrivere niente su disco:
hermes claw migrate --dry-run
L'output è raggruppato per categoria — SOUL.md, memory, skill, allowlist, config di messaggistica, API key, asset TTS. Te lo leggi. Se c'è qualcosa che non torna (un'API key vecchia che non vuoi portarti dietro, un file di personalità che hai superato), salti quella sezione con un preset.
3. Scegliere un preset
Due preset arrivano di default:
- •
full(default) — migra tutto, segreti inclusi - •
user-data— migra tutto tranne le API key ; i segreti li reinserisci a mano
Passi su una macchina pulita e vuoi tagliare netto sui segreti? Usa user-data:
hermes claw migrate --preset user-data
Aggiorni la stessa macchina e vuoi continuità?
hermes claw migrate
4. Cosa viene importato
In base al README:
| OpenClaw | Destinazione Hermes |
|---|---|
SOUL.md (persona) | importato così com'è |
Voci di MEMORY.md e USER.md | importate nella memory di Hermes |
| Skill creati da te | copiati in ~/.hermes/skills/openclaw-imports/ |
| Allowlist dei comandi (pattern di approvazione) | importata |
| Impostazioni di messaggistica (config di piattaforma, utenti consentiti, working directory) | importate |
| API key (Telegram, OpenRouter, OpenAI, Anthropic, ElevenLabs) | importate sotto il preset full |
| Asset TTS (file audio del workspace) | importati |
AGENTS.md del workspace | importato con --workspace-target |
Gli skill da agentskills.io non vengono reinstallati in automatico — Hermes presume che tu ridia un giro all'hub e ti scegli quello che vuoi tramite hermes skills. È voluto: il cambio di nome OpenClaw → Hermes ha rimesso mano anche allo skill hub (v0.14.0 ha messo huggingface/skills come tap di default fidato), e una nuova scelta è più pulita di un travaso all'ingrosso.
5. Gestire i conflitti
Se Hermes ha già impostazioni su questa macchina (per esempio hai lanciato hermes setup prima di ricordarti che c'era OpenClaw), il comando migrate si rifiuta di sovrascrivere di default. Due opzioni:
- •
--overwrite— sovrascrive i settings di Hermes con i valori di OpenClaw - •Salti la categoria in conflitto con
--preset user-datase il conflitto è sui segreti
Usa --overwrite solo dopo un --dry-run che conferma che i valori OpenClaw sono quelli che vuoi.
6. Verificare
hermes doctor
Lancia il check post-installazione. Se memory, skill, allowlist o config di piattaforma non sono dove devono essere, fa emergere errori precisi. Aggiusti, rilanci, vai avanti.
Alternativa: migrazione guidata dall'agente
Se non hai voglia di toccare i flag della CLI, Hermes porta uno skill openclaw-migration:
hermes
> /openclaw-migration
Lo skill ti porta nella stessa migrazione in modo interattivo, con anteprime --dry-run a ogni passaggio.
Domande comuni
Perdo i miei dati OpenClaw? No. Il migratore copia — non sposta. La tua cartella ~/.openclaw resta intatta. Se qualcosa va storto, puoi tornare indietro rimuovendo ~/.hermes e continuare a usare OpenClaw.
Posso farli girare tutti e due? Per poco tempo sì. Condividono ipotesi su HOME e non si aspettano di possedere entrambi la stessa memory contemporaneamente. Per un funzionamento doppio prolungato, il bridge della community HermesClaw gestisce far girare OpenClaw e Hermes sullo stesso account WeChat.
I miei skill si romperanno? Gli skill creati da te vengono copiati in ~/.hermes/skills/openclaw-imports/, quindi sopravvivono al trasloco. Gli skill presi da agentskills.io sono legati all'hub, non alla tua installazione locale — li reinstalli con hermes skills.
Dove chiedo aiuto se qualcosa si rompe? Prima hermes doctor. Poi il Discord di Nous Research o le GitHub Issues — entrambi sono linkati dal README.