Come Distribuire Hermes Agent su Telegram

Perché Telegram è la Migliore Interfaccia per Hermes

La maggior parte degli strumenti AI vive in una scheda del browser. Ci navighi, scrivi qualcosa, leggi la risposta e chiudi la scheda. Nel momento in cui la chiudi, il contesto è perso.

Telegram cambia tutto questo. Se Hermes gira come bot Telegram, interagisci con il tuo agente dal telefono, da qualsiasi dispositivo, in qualsiasi momento, senza aprire un browser o ricordare un URL. I messaggi arrivano come in qualsiasi altra conversazione. L'agente risponde con il suo contesto persistente completo.

Questo è ciò che significa "agente AI sempre attivo" nella pratica: non un processo in background che controlli quando ti ricordi che esiste, ma un contatto nella tua app di messaggistica che rimane pronto e ricorda tutto.

Cosa Richiede Davvero una Distribuzione su Telegram

Portare Hermes su Telegram richiede più di un singolo comando. Una distribuzione vera ha cinque componenti distinte:

1. Crea il bot in BotFather

Apri Telegram e cerca @BotFather. Invia /newbot, scegli un nome visualizzato e un username che termini con bot, e copia il token API che restituisce. Questo token ha un aspetto simile a 7123456789:ABCDef..., salva la stringa completa.

2. Scegli un provider di modelli

Hermes ha bisogno di un LLM per generare le risposte. OpenRouter è la scelta più semplice: una sola chiave API ti dà accesso a Claude, GPT-4, Llama e altri senza gestire account separati. La guida alla configurazione di OpenRouter copre questo argomento in dettaglio.

3. Configura il runtime

In config.yaml, collega la chiave del tuo provider, la scelta del modello e le impostazioni di Telegram:

provider: openrouter
model: anthropic/claude-3-5-sonnet
openrouter_api_key: sk-or-your-key-here
telegram_bot_token: 7123456789:ABCDef...
telegram_allowed_users: "YOUR_NUMERIC_USER_ID"

Il campo telegram_allowed_users è fondamentale. Hermes risponderà solo agli ID utente Telegram elencati qui. Ottieni il tuo ID numerico da @userinfobot su Telegram: non accetta username.

4. Avvia il gateway di messaggistica

hermes gateway start --detach

Il gateway gira come processo in background che fa long-polling all'API di Telegram e instrada i messaggi verso il runtime di Hermes. Senza di esso, il bot accetterà i messaggi ma non risponderà mai.

5. Tienilo attivo

Qui è dove la maggior parte delle distribuzioni self-hosted si inceppa. Il bot funziona finché il processo è in esecuzione, e smette di funzionare quando il processo si ferma. Su un laptop con WSL2, il processo muore quando si chiude il terminale. Su un VPS economico, può venire terminato durante un riciclo del container. Una distribuzione in produzione vera richiede un server persistente con gestione dei processi (systemd, Docker con una restart policy, o hosting gestito).

I Problemi più Comuni

Bot silenzioso: il bot è registrato su Telegram, ma non risponde quando gli scrivi. Il gateway non è in esecuzione (hermes gateway status) oppure il tuo ID utente non è in telegram_allowed_users.

Errore di autorizzazione nei log: il token del bot è stato revocato o è errato. Rigeneralo tramite BotFather (/mybots → seleziona il bot → API Token → Revoke) e aggiorna la configurazione.

Funziona una volta, poi si ferma: il processo di Hermes è andato in crash oppure il gateway si è disconnesso. Controlla i log per trovare un errore prima del silenzio. Un errore dell'API del modello (rate limit, esaurimento quota) può causare l'uscita della sessione invece del recupero automatico.

Funziona in locale, non funziona dopo la distribuzione: la causa più comune è che la configurazione del server è diversa da quella locale, in particolare il token o la lista degli utenti autorizzati. Controlla il config.yaml lato server direttamente, non quello locale.

La guida alla risoluzione dei problemi di Telegram copre ciascuno di questi casi in dettaglio con le istruzioni precise per risolverli.

Il Costo in Tempo che Nessuno Calcola

Il comando di installazione richiede cinque minuti. Il costo reale è quello del percorso operativo.

Quando Hermes gira su Telegram con successo, è genuinamente utile. Il problema è il tempo tra "lo voglio" e "funziona in modo affidabile":

• Configurare il VPS o l'ambiente server
• Archiviare le credenziali in modo sicuro
• Fare il debug la prima volta che il gateway smette di rispondere
• Gestire il riavvio del processo dopo un aggiornamento di sistema
• Monitorare l'uptime per accorgerti quando il bot va in silenzio

Nessuno di questi passaggi è difficile di per sé. Insieme, rappresentano una responsabilità operativa continuativa. Se il tuo obiettivo è usare Hermes piuttosto che gestire l'infrastruttura attorno a esso, questo è il punto di attrito.

Il Percorso Gestito: Hermify

Hermify è stato progettato specificamente attorno al problema della distribuzione su Telegram. Invece di costruire l'ambiente server da zero, puoi:

1. Creare un account e scegliere un piano
2. Inserire il token del tuo bot Telegram e gli ID utente autorizzati nel modulo di onboarding
3. Aggiungere la chiave del tuo provider di modelli (o usare un piano con accesso al modello incluso)
4. Cliccare su distribuisci

Il runtime viene distribuito su un server persistente, il gateway si avvia automaticamente e il bot è attivo su Telegram. La dashboard mostra lo stato del runtime, permette di aggiornare le credenziali e consente di avviare riavvii senza accesso SSH.

Quando il bot va in silenzio su una distribuzione self-hosted, devi fare il debug del gateway. Quando va in silenzio su Hermify, controlli la card di stato e riavvii dalla dashboard.

Questa è la differenza pratica: non se la distribuzione su Telegram sia possibile (chiaramente lo è), ma chi si assume la responsabilità di mantenerla in salute dopo che è attiva.

Scegliere tra Self-Hosting e Gestito

Entrambi i percorsi funzionano. La scelta dipende da cosa vuoi gestire tu:

Scegli il self-hosted se: hai dimestichezza con l'amministrazione di server Linux, gestisci già questo tipo di infrastruttura e vuoi il controllo completo su ambiente, storage e configurazione.

Scegli l'hosting gestito se: vuoi Hermes disponibile su Telegram in modo affidabile, non vuoi gestire un server e sei principalmente interessato a usare l'agente piuttosto che a mantenere lo stack attorno a esso.

Il confronto tra hosting e self-hosting approfondisce questa decisione, inclusa l'analisi dei costi e le aspettative di manutenzione dopo la prima distribuzione.

Se sei pronto per iniziare, la pagina distribuisci Hermes Agent illustra l'intera configurazione gestita dalla creazione dell'account al primo messaggio.