Quale chiave di un provider IA usare con Hermes Agent

In breve. Hermes Agent non include un modello: ha bisogno di un account presso un provider IA. Su PlayNHost incolli una chiave API di OpenAI, Anthropic, Google Gemini, xAI o OpenRouter, e una sola chiave basta. Hermes Agent sceglie il provider in base alla chiave, e tu scegli il modello dalla chat con /model. Se vuoi molti modelli dietro una sola chiave e una sola fattura, usa OpenRouter. Il tuo provider ti addebita direttamente l'uso del modello; il piano del server non lo include.

Verificato il 7 novembre 2026, valido per Hermes Agent v0.23.0.

Questa guida usa la documentazione di Hermes Agent su provider e configurazione, il suo codice sorgente della v0.23.0 dove la documentazione tace, e il pannello PlayNHost così come funziona oggi.

Le cinque chiavi che accetta il pannello

Una chiave API si paga a consumo. Un abbonamento per privati non è la stessa cosa: la documentazione di Hermes Agent dice che un piano Claude Pro non può essere usato tramite il suo accesso, e che l'alternativa supportata è una chiave API Anthropic, addebitata per token.

Quale scegliere

• Paghi già un provider: usa quella chiave.
• Vuoi provare più modelli: OpenRouter mette molti provider dietro una sola chiave e una sola fattura. La documentazione di Hermes Agent lo elenca come "recommended for flexibility" (consigliato per la flessibilità).
• Stai pensando a un piano gratuito: la documentazione di Hermes Agent avverte che una chiave Google Gemini gratuita può esaurirsi dopo una manciata di turni dell'agente, perché un tuo messaggio può richiedere diverse chiamate al modello. Altre piccole quote gratuite si esauriscono per lo stesso motivo.
• Il modello ha bisogno di un contesto ampio. Hermes Agent richiede almeno 64.000 token di contesto e rifiuta all'avvio le finestre più piccole. Controlla la finestra di contesto del modello che scegli, soprattutto se è piccolo.
• Non su PlayNHost: Nous Portal e altri accessi (un login ChatGPT, Claude Max o SuperGrok) richiedono hermes model o hermes setup da riga di comando, e i modelli locali (Ollama, LM Studio) richiedono un server di modelli che il piano non include. Il pannello accetta chiavi API.

Aggiungi la chiave su PlayNHost

1. Apri il tuo server su panel.playnhost.com, poi la scheda Agente.
2. Sotto Provider IA ("Basta una chiave. Ogni provider addebita sul tuo account ciò che usa il tuo agente."), premi Imposta sulla riga del tuo provider, incolla la chiave e premi Salva. La riga mostra poi solo gli ultimi quattro caratteri. La chiave è conservata cifrata e non viene più mostrata; Sostituisci e Rimuovi la modificano più avanti.
3. Aggiungi un token del bot Telegram o Discord se non l'hai ancora fatto (Telegram, Discord), poi avvia o riavvia l'agente: "Le modifiche si applicano al prossimo avvio del tuo agente."

La chiave arriva a Hermes Agent tramite il suo ambiente, con il nome indicato nella tabella. Hermes Agent ne conserva un'impronta in auth.json, non la chiave stessa (lo abbiamo verificato su un server di prova).

Scegli il modello dalla chat

PlayNHost non ha un campo per il modello di Hermes Agent: lo scegli in chat, con il comando di Hermes Agent.

• Invia /model al tuo bot. Su Telegram si apre un selettore: prima i provider per cui hai una chiave, poi i loro modelli. Il modello attuale è mostrato in cima.
• Se conosci il nome del modello, invia /model <name>. Aggiungi --global per mantenerlo anche per le nuove conversazioni.
• /model passa solo tra i provider per cui hai una chiave. Per un altro provider, aggiungi la sua chiave nella pagina Agente e riavvia.

La documentazione di Hermes Agent aggiunge una nota sui costi: cambiare modello nel mezzo di una conversazione lunga fa rileggere tutta la conversazione a prezzo pieno al messaggio successivo, perché la cache dei prompt del provider appartiene al vecchio modello. Cambia presto, o dopo /new.

Più chiavi insieme

Puoi impostarne più di una. Quando nelle impostazioni di Hermes Agent non è stato scelto alcun provider, il suo codice v0.23.0 prende per prima una chiave OpenRouter; se manca, prende il primo provider con una chiave nel suo elenco interno. Per evitare sorprese, tieni una sola chiave, oppure scegli il provider con /model.

Tieni sotto controllo la spesa

• Ti fattura il tuo provider, non noi. PlayNHost non rivende l'uso dei modelli e non lo aggiunge alla tua fattura; il piano paga il server.
• Imposta un limite di spesa o un avviso di budget presso il tuo provider. Hermes Agent può eseguire lavori programmati da solo, e ogni esecuzione usa la tua chiave mentre non guardi.
• I compiti secondari usano il tuo modello principale. Per impostazione predefinita Hermes Agent manda i suoi compiti secondari (compressione del contesto, lettura di immagini, titoli delle sessioni, valutazione del rischio di un comando) al tuo modello principale. La sua documentazione nota che con un modello costoso questi aggiungono un costo significativo.
• Solo tu puoi scrivergli. Le liste di ID utente nella pagina Agente impediscono agli sconosciuti di consumare i tuoi crediti.

Sulla tua macchina

Lancia hermes model per scegliere un provider e un modello (chiede la chiave o avvia l'accesso del provider), oppure metti la chiave in ~/.hermes/.env:

OPENROUTER_API_KEY=sk-or-...

Poi riavvia il gateway. Vedi come eseguire Hermes Agent 24/7, oppure crea un server Hermes Agent e incolla la tua chiave nel pannello.

PlayNHost non è affiliato a Nous Research. Hermes Agent è un software open source con licenza MIT.