Assistente Hermes AI – Installazione, configurazione, workflow e risoluzione dei problemi

L’agente Hermes è un assistente AI self-hosted, agnostico rispetto al modello, che opera su un computer locale o su un VPS a basso costo, funziona attraverso interfacce terminali e di messaggistica e migliora nel tempo trasformando le attività ripetitive in abilità riutilizzabili.

È molto simile per funzionalità a OpenClaw, un altro stack di assistente self-hosted costruito attorno a strumenti, memoria e controllo locale. Molti sviluppatori hanno trovato la strada verso Hermes dopo che Anthropic ha bloccato l’accesso alla sottoscrizione di Claude per OpenClaw nell’aprile 2026 — la cronologia dell’ascesa e del crollo di OpenClaw spiega perché Hermes è emersa come destinazione naturale per gli utenti che volevano automazione persistente e self-hosted senza dipendenza dal provider.

Se desideri una visione più ampia degli assistenti self-hosted, del retrieval e delle infrastrutture locali attorno a Hermes, questa panoramica dei sistemi AI collega quegli argomenti agli stessi problemi che Hermes sta cercando di risolvere. Per il modello di assistente a cinque livelli — LLM, memoria, strumenti, routing e osservabilità — con Hermes e OpenClaw come implementazioni di riferimento, consulta Architettura degli Assistenti AI. Per dati concreti sull’adozione — stelle su GitHub, volume giornaliero di token su OpenRouter, conteggi dei download su PyPI, storico CVE e sentiment della comunità su Reddit — OpenClaw vs Hermes Agent: Stelle, Download e Utilizzo 2026 traccia come Hermes si confronta con 19 alternative su ogni segnale misurabile.

Per i compromessi di deployment e le scelte di runtime, Ospitalità LLM nel 2026: Infrastrutture Locali, Self-Hosted e Cloud Confrontate fornisce la mappa dell’ospitalità, mentre [Prestazioni LLM nel 2026: Benchmark, Colli di Bottiglia e Ottimizzazione](https://www.glukhov.org/it/llm-performance/ “Ingegneria delle prestazioni LLM pratica: throughput vs latenza, limiti VRAM, richieste parallele, allocazione della memoria e benchmark tra runtime e hardware.” copre il lato throughput e latenza una volta che Hermes è in esecuzione. Se indirizzi regolarmente Hermes su Qwen o Gemma su runtime locali come Ollama, consolida i preset di temperatura e penalità per l’uso di strumenti multi-step con Parametri di inferenza LLM agentici per Qwen e Gemma. Per una mappa compatta dei comandi shell (hermes gateway, hermes memory, hermes doctor, scorciatoie con slash e altro), usa la scheda rapida CLI per Hermes Agent. Se il tuo punto di accesso principale è la messaggistica su mobile, usa Controllo Voice di Hermes dal Tuo Telefono per lo stack vocale e la configurazione specifica per piattaforma.

Il mio parere di parte: Hermes è più interessante quando viene trattata come infrastruttura, non come una scheda che apri occasionalmente. Una volta che funziona come servizio e ha una directory home stabile, i tuoi prompt iniziano a somigliare meno alla “chat” e più alle “operazioni”.

Cos’è Hermes Agent e perché è importante

Hermes Agent è un agente AI open source creato da Nous Research. È progettato per funzionare in modo persistente, utilizzare strumenti (terminale, file, web e altro) e migliorare il suo stesso comportamento nel tempo con un sistema di abilità e memoria.

Due scelte di progettazione meritano di essere esplicitate perché plasmano tutto il resto in questa guida.

Primo, Hermes non è legata a un singolo provider di modelli. Il flusso di configurazione ufficiale supporta più provider e qualsiasi endpoint compatibile con OpenAI, e il passaggio viene effettuato tramite il comando hermes model piuttosto che tramite modifiche al codice.

Secondo, Hermes traccia una linea dura tra “conversazione” ed “esecuzione”. L’agente può parlare tutto il giorno, ma quando ha bisogno di agire, lo fa attraverso strumenti espliciti e un backend di esecuzione configurabile. È lì che risiedono sicurezza, riproducibilità e risoluzione dei problemi.

Costi e licenza sono piacevolmente noiosi. Hermes Agent stessa è software gratuito sotto licenza MIT. Se usi modelli ospitati, il costo continuativo è quello che il tuo provider addebita. Se esegui modelli locali, puoi evitare del tutto le tariffe API.

Se la tua configurazione di Hermes usa Claude tramite layer di strumenti esterni, questa modifica alla sottoscrizione Anthropic è un riferimento utile sul perché la fatturazione basata su API è ora il percorso previsto.

Installazione di Hermes Agent

Hermes ha un percorso di installazione rapido per Linux, macOS e WSL2. I documenti ufficiali lo mantengono intenzionalmente semplice.

Installazione Hermes su Linux

sudo apt-get update
sudo apt-get upgrade
sudo apt-get curl git
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Dopo l’installazione, ricarica il tuo shell e avvia la CLI.

source ~/.bashrc   # oppure source ~/.zshrc
hermes

L’installer non è solo un sottile wrapper. Secondo la guida di installazione, configura le dipendenze, il repository, un ambiente virtuale e il comando hermes, portandoti a uno stato iniziale pronto per la chat.

Se arrivi da un deployment esistente di OpenClaw invece di iniziare da zero, installa e valida prima un Hermes vuoto, poi segui il passaggio graduale in Come Migrazare da OpenClaw a Hermes Agent in Sicurezza — hermes claw migrate mappa persona, memoria, abilità, provider e server MCP, ma i job cron, i plugin e il routing multi-agente devono essere ricostruiti a mano.

Note per Windows e Android

Windows nativo non è supportato. I documenti raccomandano WSL2 e l’esecuzione di Hermes al suo interno.

Per Android, Hermes supporta un percorso di installazione Termux. È progettato per rilevare Termux e adattare di conseguenza la configurazione delle dipendenze e dell’ambiente.

Avvio rapido

L’esecuzione iniziale più rapida è letteralmente solo hermes, ma un avvio rapido significativo comporta due decisioni extra: quale provider di modello usare e quali strumenti dovrebbero essere abilitati.

Scegli un provider e un modello

Hermes espone tre punti di ingresso complementari:

• hermes model per scegliere un provider e un modello predefinito
• hermes tools per abilitare o disabilitare set di strumenti
• hermes setup per eseguire un assistente interattivo tra le aree principali di configurazione

Un flusso minimo è questo:

hermes model
hermes tools
hermes

In termini di ciò che è effettivamente supportato, l’Avvio Rapido ufficiale elenca un’ampia gamma di provider e sottolinea anche che Hermes funziona con API compatibili con OpenAI. Questo è importante perché include sia servizi ospitati che endpoint self-hosted.

Dimostra l’esecuzione degli strumenti presto

Prima di creare abitudini attorno a Hermes, è utile verificare che l’uso degli strumenti funzioni nel tuo ambiente. L’Avvio Rapido suggerisce esplicitamente l’uso del terminale come prima funzionalità da provare.

In pratica, un piccolo prompt di “smoke test” svolge due compiti: verifica lo strumento terminale e valida i prompt di autorizzazione.

Esempio di prompt:

Mostra il mio utilizzo del disco e le cinque directory più grandi.

Se Hermes non riesce a eseguire lo strumento terminale, salta alla sezione Risoluzione dei Problemi. La configurazione errata del backend terminale è una delle cause più comuni e la correzione è di solito ovvia una volta che si guarda la configurazione.

Configurazione che scala

Hermes premia chi capisce dove memorizza lo stato e come risolve la configurazione. È anche qui che nascono molti problemi del tipo “funzionava ieri”.

Dove vivono configurazione e stato

Hermes memorizza le sue impostazioni e lo stato sotto ~/.hermes. La guida di configurazione ufficiale documenta il layout, incluso config.yaml per le impostazioni, .env per i segreti, auth.json per le credenziali OAuth, SOUL.md per l’identità, e cartelle per memorie, abilità, cron, sessioni e log.

Questo è importante per due motivi.

• Il debug diventa meccanico perché sai esattamente dove guardare.
• I backup diventano diretti perché un’unica directory cattura la maggior parte dello stato dell’agente a cui ti interessi.

Precedenza della configurazione e mantenimento dei segreti fuori da config.yaml

Hermes risolve la configurazione con un ordine di precedenza. In cima ci sono le override CLI, poi config.yaml, poi .env, con i valori predefiniti integrati in fondo.

Il dettaglio gradevole è che hermes config set instrada i valori nel file giusto: le chiavi API in .env e le impostazioni non segrete in config.yaml.

hermes config set model openrouter/meta-llama/llama-3.1-70b-instruct
hermes config set terminal.backend docker
hermes config set OPENROUTER_API_KEY sk-or-v1-xxxxxxxx

Hermes supporta anche la sostituzione di variabili d’ambiente dentro config.yaml tramite la sintassi ${VAR_NAME}. Questo è utile quando vuoi mantenere certi valori nell’ambiente pur riferendoli nella configurazione strutturata.

Sandbox e backend di esecuzione

Hermes supporta più backend terminali che definiscono dove i comandi shell vengono effettivamente eseguiti. La guida di configurazione elenca local, docker, ssh, modal, daytona e singularity.

Il modo opinato ma non evangelico per pensare a questo è:

• local è il più rapido e semplice, ma non è isolato
• docker è un layer di sicurezza e riproducibilità pragmatico
• ssh è un modo pulito per separare il dispositivo di chat dalla tua macchina di calcolo
• modal e daytona si adattano a flussi di lavoro “serverless ma sufficientemente persistenti”
• singularity è l’opzione amichevole per l’HPC

Un esempio minimo di backend Docker:

# ~/.hermes/config.yaml
terminal:
  backend: docker
  docker_image: "nikolaik/python-nodejs:python3.11-nodejs20"
  docker_volumes:
    - "/home/user/projects:/workspace/projects"
  docker_forward_env:
    - "GITHUB_TOKEN"

I documenti descrivono anche il rafforzamento della sicurezza per il backend Docker, come il rilascio delle capacità e la disabilitazione dell’escalation dei privilegi.

Abilità, memoria e profili

Hermes ha due meccanismi correlati per accumulare valore.

Le abilità sono memoria procedurale. Hermes può creare, aggiornare ed eliminare le proprie abilità e può offrire di salvare un approccio come abilità dopo aver completato un compito complesso.

La memoria integrata è memorizzata come file come MEMORY.md e USER.md sotto ~/.hermes, e Hermes può anche usare provider di memoria esterni per un richiamo più profondo. I documenti sulla memoria elencano più plugin di provider, e la guida sui provider di memoria documenta un flusso di configurazione interattivo. Per una spiegazione tecnica completa di come funziona l’architettura della memoria — snapshot congelati, limiti di caratteri, i provider esterni e la filosofia dietro la memoria limitata — consulta Sistema di Memoria di Hermes Agent: Come Funziona Actually la Memoria AI Persistente. Se vuoi un provider locale e self-hosted con un controllo insolitamente granulare su cosa viene scritto automaticamente, consulta Mnemosyne per Hermes Agent: Avvio Rapido della Memoria Locale — e Loop di Memoria Auto-Rinforzanti negli Agenti AI per capire perché i valori predefiniti di scrittura conservativi sono importanti in primo luogo.

Se vuoi più agenti indipendenti sulla stessa macchina, i profili di Hermes forniscono isolamento. Ogni profilo ottiene la propria directory con le proprie configurazioni, segreti, memorie, sessioni, abilità, job cron e stato del gateway.

Per uno sguardo più approfondito su quali abilità funzionano bene in produzione per ruolo — ingegneri, ricercatori, operatori e flussi di lavoro dirigenziali — consulta Abilità di Hermes AI Assistant per Configurazioni di Produzione Reali. Quando sei pronto per creare o fare debug dei file SKILL.md stessi — metadati YAML, livelli di disclosure progressiva, visibilità condizionale e installazioni hub — usa Creazione di Abilità Hermes Agent — Struttura e Migliori Pratiche di SKILL.md.

Flusso di lavoro tipico

Se tratti Hermes come un agente che manterrai, il flusso di lavoro inizia a somigliare all’ingegneria dei servizi.

Una base stabile

Una base che tende a non deteriorarsi è:

1. Installa ed esegui una prima chat nella CLI.
2. Scegli un provider e un modello con hermes model, poi conferma i costi.
3. Configura i set di strumenti e decidi se l’esecuzione del terminale è locale o in sandbox.
4. Fai una piccola modifica a SOUL.md solo dopo aver usato il predefinito per un po’. I cambiamenti di identità contano più di quanto le persone si aspettino perché è la “slot 1” nel system prompt.

Uso quotidiano che si accumula

Hermes ha un’interfaccia a terminale invece di un’interfaccia web, ed è progettata per sessioni lunghe con comandi slash, sessioni riprendibili e output di strumenti in streaming.

In pratica, una cadenza utile è:

• eseguire il lavoro in una sessione nominata per un progetto
• comprimere il contesto quando diventa troppo grande
• lasciare che Hermes trasformi le routine ripetitive in abilità
• mantenere un confine mentale tra “chiedere” e “agire” in modo che l’esecuzione degli strumenti resti auditabile

Gateway di messaggistica per accesso 24/7

Il gateway di messaggistica è la parte che fa sentire Hermes un assistente piuttosto che un’applicazione a terminale. I documenti lo descrivono come un processo singolo che si connette a più piattaforme, gestisce le sessioni, esegue i job cron e consegna i messaggi.

La configurazione viene invocata tramite hermes gateway setup, e il gateway può eseguire in primo piano o come servizio utente. Il riferimento CLI documenta i sottocomandi del gateway come run, install, start, stop, status e restart. Se vuoi questo modello di gateway che funziona su un server dedicato mentre ti connetti da un client desktop separato, usa Configurazione di Server Headless e Desktop Remoto per Hermes Agent.

Per backlog multi-agente e pianificazione controllata, consulta Kanban in Hermes Agent per Flussi di Lavoro LLM Self Hosted, che copre i limiti del dispatcher, le catene di dipendenza e il batching basato su cron.

La sicurezza per un bot che usa strumenti è importante. I documenti del gateway descrivono le whitelist per piattaforme specifiche e un flusso di pairing DM che emette codici di pairing una tantum e richiede l’approvazione tramite hermes pairing approve.

Aggiornamenti senza drammi

Gli aggiornamenti di Hermes sono un comando di prima classe. La guida agli aggiornamenti documenta hermes update, le verifiche di migrazione della configurazione e una piccola routine di validazione post-aggiornamento inclusa hermes doctor e hermes gateway status.

hermes update
hermes doctor
hermes gateway status

Risoluzione dei problemi e diagnostica

La maggior parte dei fallimenti di Hermes non è misteriosa. Sembra misteriosa perché le persone controllano solo il layer del modello e ignorano il layer di runtime.

Comandi di triage rapida

Il riferimento CLI posiziona esplicitamente tre comandi come il ciclo core:

• hermes doctor per la diagnostica interattiva
• hermes status per una rapida panoramica
• hermes dump per un riepilogo della configurazione condivisibile e censurato

Per i log, hermes logs segue i file memorizzati sotto ~/.hermes/logs.

hermes doctor --fix
hermes status
hermes dump --show-keys
hermes logs errors -f

Fallimenti comuni di installazione

La FAQ e la guida di risoluzione dei problemi elencano diversi problemi ricorrenti e le loro correzioni, inclusi problemi di versione Python, uv non trovato e problemi di permessi causati dalla miscela di installazioni sudo con installazioni utente.

Se ti imbatti in questi errori, i documenti forniscono passaggi di rimedio specifici come l’aggiornamento di Python, l’installazione di uv e la reinstallazione di Hermes senza sudo.

Problemi di provider e modello

Quando le chiavi API non funzionano, la FAQ raccomanda di controllare la configurazione, ri-eseguire hermes model o impostare una chiave direttamente tramite hermes config set. Sottolinea anche un errore comune: le chiavi sono specifiche del provider.

Per problemi di “modello non trovato”, la FAQ rimanda all’uso di hermes model per scegliere un identificatore valido e mostra sia le override di configurazione che quelle per sessione.

I problemi di limitazione della velocità e della lunghezza del contesto sono anche coperti. La FAQ suggerisce di aspettare per errori 429, cambiare provider o modelli, e ridurre la pressione del contesto tramite compressione o una sessione nuova.

Problemi di backend terminale e gateway

Se i comandi terminali falliscono immediatamente, la guida di configurazione include una sezione “problemi comuni del backend terminale” e indica le cause tipiche per backend, inclusa Docker non in esecuzione e variabili SSH mancanti. Nota anche che il fallback su local è una mossa di validazione valida quando la configurazione della sandbox è in discussione.

Per problemi di gateway, la guida alla messaggistica evidenzia le whitelist e il pairing come valori predefiniti sicuri, il che significa che molti incidenti del tipo “il bot è silenzioso” sono in realtà l’autorizzazione che fa il suo lavoro.

Riferimenti

• Homepage di Hermes Agent
• Sistema di Memoria di Hermes Agent: Come Funziona Actually la Memoria AI Persistente
• Abilità di Hermes AI Assistant per Configurazioni di Produzione Reali