Qué clave de proveedor de IA usar con Hermes Agent

Respuesta corta. Hermes Agent no incluye ningún modelo: necesita una cuenta con un proveedor de IA. En PlayNHost pegas una clave API de OpenAI, Anthropic, Google Gemini, xAI u OpenRouter, y con una clave basta. Hermes Agent elige el proveedor según la clave, y tú eliges el modelo desde el chat con /model. Si quieres muchos modelos con una sola clave y una sola factura, usa OpenRouter. Tu proveedor te factura directamente el uso del modelo; el plan del servidor no lo incluye.

Comprobado el 7 de noviembre de 2026, correcto para Hermes Agent v0.23.0.

Esta guía usa la documentación de proveedores y de configuración de Hermes Agent, su código fuente de v0.23.0 donde la documentación no dice nada, y el panel de PlayNHost tal como funciona hoy.

Las cinco claves que acepta el panel

Una clave API se factura por uso. Una suscripción de consumidor no es lo mismo: la documentación de Hermes Agent dice que un plan Claude Pro no se puede usar con su inicio de sesión, y que la alternativa admitida es una clave API de Anthropic, facturada por token.

Cuál elegir

• Ya pagas a un proveedor: usa esa clave.
• Quieres probar varios modelos: OpenRouter reúne a muchos proveedores tras una sola clave y una sola factura. La propia documentación de Hermes Agent lo describe como “recommended for flexibility” (recomendado por su flexibilidad).
• Estás pensando en un plan gratuito: la documentación de Hermes Agent advierte de que una clave gratuita de Google Gemini puede agotarse tras un puñado de turnos del agente, porque un mensaje tuyo puede requerir varias llamadas al modelo. Otras cuotas gratuitas pequeñas se agotan por la misma razón.
• El modelo necesita un contexto grande. Hermes Agent exige al menos 64.000 tokens de contexto y rechaza ventanas más pequeñas al arrancar. Mira la ventana de contexto del modelo que elijas, sobre todo si es pequeño.
• No disponible en PlayNHost: Nous Portal y otros inicios de sesión (con una cuenta de ChatGPT, Claude Max o SuperGrok) necesitan hermes model o hermes setup en una línea de comandos, y los modelos locales (Ollama, LM Studio) necesitan un servidor de modelos que el plan no incluye. El panel acepta claves API.

Añade la clave en PlayNHost

1. Abre tu servidor en panel.playnhost.com y luego la pestaña Agente.
2. En Proveedor de IA (“Con una clave basta. Cada proveedor factura a tu propia cuenta lo que use tu agente.”), pulsa Definir en la fila de tu proveedor, pega la clave y pulsa Guardar. La fila muestra entonces solo los últimos cuatro caracteres. La clave se guarda cifrada y no se vuelve a mostrar; Reemplazar y Quitar la cambian más adelante.
3. Añade un token de bot de Telegram o de Discord si aún no lo has hecho (Telegram, Discord) y luego inicia o reinicia el agente: “Los cambios se aplican la próxima vez que se inicie tu agente.”

La clave llega a Hermes Agent por su entorno, con el nombre de la tabla. Hermes Agent guarda en auth.json una huella de la clave, no la clave en sí (lo comprobamos en un servidor de prueba).

Elige el modelo desde el chat

PlayNHost no tiene un campo de modelo para Hermes Agent: lo eliges en el chat, con el propio comando de Hermes Agent.

• Envía /model a tu bot. En Telegram abre un selector: primero los proveedores de los que tienes clave y luego sus modelos. El modelo actual aparece arriba.
• Si conoces el nombre del modelo, envía /model <name>. Añade --global para conservarlo también en las conversaciones nuevas.
• /model solo cambia entre proveedores de los que tienes clave. Para otro proveedor, añade su clave en la página Agente y reinicia.

La documentación de Hermes Agent añade una nota de coste: cambiar de modelo en mitad de una conversación larga hace que el siguiente mensaje relea toda la conversación a precio completo, porque la caché de prompts del proveedor pertenece al modelo anterior. Cambia al principio, o después de /new.

Varias claves a la vez

Puedes definir más de una. Cuando no se ha elegido ningún proveedor en los ajustes de Hermes Agent, el código de su v0.23.0 toma primero una clave de OpenRouter; si no hay, toma el primer proveedor con clave de su lista integrada. Para evitar sorpresas, quédate con una sola clave, o elige el proveedor con /model.

Cómo controlar la factura

• Te factura tu proveedor, no nosotros. PlayNHost no revende el uso de modelos ni lo suma a tu factura; el plan paga el servidor.
• Pon un límite de gasto o una alerta de presupuesto en tu proveedor. Hermes Agent puede ejecutar tareas programadas por sí solo, y cada ejecución usa tu clave mientras no miras.
• Las tareas secundarias usan tu modelo principal. Por defecto, Hermes Agent envía sus tareas secundarias (compresión de contexto, lectura de imágenes, títulos de sesión, valorar si un comando es arriesgado) a tu modelo principal. Su documentación señala que con un modelo caro estas tareas suponen un coste notable.
• Solo tú puedes escribirle. Las listas de IDs de usuario de la página Agente evitan que desconocidos gasten tus créditos.

En tu propia máquina

Ejecuta hermes model para elegir proveedor y modelo (te pide la clave o lanza el inicio de sesión del proveedor), o pon la clave en ~/.hermes/.env:

OPENROUTER_API_KEY=sk-or-...

Después reinicia el gateway. Mira cómo ejecutar Hermes Agent 24/7, o crea un servidor Hermes Agent y pega tu clave en el panel.

PlayNHost no está afiliada a Nous Research. Hermes Agent es software de código abierto con licencia MIT.