Vertra Cloud no aloja un modelo. Tú traes la clave de un proveedor, y el uso del modelo te lo factura ese proveedor. Esta plantilla es un empaquetado de Vertra Cloud y no está afiliada al proyecto Hermes Agent (licencia MIT).
Requisitos y plan
1. Consigue la clave del proveedor
Hermes funciona con OpenRouter (predeterminado), Anthropic, OpenAI, Google Gemini o cualquier endpoint compatible con OpenAI.
Copia la clave ahora: la mayoría de los proveedores la muestran solo una vez. Se guarda únicamente en las variables cifradas de la aplicación.
2. Crea el agente
1
Abre la plantilla
En el panel abre Plantillas, elige Hermes Agent y haz clic en Usar plantilla.
2
Elige proveedor y modelo
Elige el proveedor del modelo y pega la clave de API. Con un endpoint compatible, introduce también la URL base y el modelo, que es obligatorio. Con los demás, deja el modelo vacío para usar el predeterminado del proveedor, o escribe el que prefieras.
3
Chat en el navegador (opcional)
Activa Browser chat (Hermes WebUI) si quieres una página de chat con sesiones, archivos y ajustes. Cuesta unos 150 MB más de memoria. Sin él, el agente sigue funcionando en el panel y en tus canales.
4
Conecta canales (opcional)
Cada canal pide credenciales y la lista de personas autorizadas a hablar con el agente, que es obligatoria. Consulta el paso 4; también puedes hacerlo más tarde en el panel.
5
Crea
Ponle nombre a la aplicación y haz clic en Crear. Las salidas muestran la dirección del panel, el usuario
admin y una contraseña generada, mostrada una sola vez. Cópiala.3. Inicia sesión en el panel y conversa
Abre<address>/admin/. El navegador pide un usuario y una contraseña: usa admin y la contraseña de las salidas. Este único inicio de sesión protege el panel y el chat.
- Chat en el panel:
/admin/chates el chat de terminal de Hermes. Salúdalo ahí primero para comprobar que la clave funciona. - Chat en el navegador: si lo activaste, vive en
<address>/con el mismo inicio de sesión. Sin él,/te lleva al panel. - ¿Perdiste la contraseña? Cambia la variable
HERMES_ADMIN_PASSWORDen la aplicación y reinicia.
4. Conecta un canal
Cada canal necesita dos cosas: la credencial del bot y quién puede hablar con el agente. Hermes ignora a todo el que no esté en esa lista, así que el agente nunca responde a desconocidos. Puedes rellenarlo en el asistente o más tarde en Channels (/admin/channels).
- Telegram
- Discord
- Slack
- WhatsApp
- Email
- En Telegram, habla con @BotFather, envía
/newboty sigue las preguntas. Copia el token del bot. - Averigua tu id numérico hablando con @userinfobot.
- Introduce el token y tu id como usuario autorizado.
- Abre un chat con tu bot y envía un mensaje.
/admin/channels o en las variables de la aplicación. Signal necesita un daemon externo signal-cli y no se ejecuta en este contenedor.
5. Cambia el modelo más tarde
El proveedor y el modelo se aplican en cada arranque desde las variables de la aplicación, así que las variables son la fuente de verdad. Para cambiarlos, edita estas variables en la aplicación y reinicia:Skills, memoria y programaciones
- Skills. Hermes sincroniza sus skills en el primer arranque; las gestionas en el panel.
- Memoria. Las memorias, sesiones, skills y la configuración se guardan en
/app/.hermesen el disco de la aplicación, así que sobreviven a reinicios, actualizaciones y rollbacks. - Programaciones. En Cron creas tareas recurrentes. El agente las ejecuta y te habla por el canal que elijas.
El coste de la IA corre por tu cuenta
La plataforma cobra el plan por la memoria que usa la aplicación. Las llamadas al modelo las factura tu proveedor, y un agente que ejecuta tareas programadas o lee archivos largos puede consumir muchos tokens. Define un límite de gasto en la cuenta de tu proveedor y vigila el uso mientras pruebas.Actualiza y revierte
Las nuevas versiones llegan como nuevas versiones de la plantilla. Se toma un snapshot antes de la actualización, y un rollback devuelve el estado (/app/.hermes). Consulta Actualizar y revertir. El despliegue sin caída está desactivado: una segunda copia en el mismo disco termina con un error.
Límites que debes conocer
- Caddy es la única puerta, sin límite de intentos. La contraseña generada es larga; para más protección añade una regla de límite de tasa en tu propio dominio.
- La contraseña generada y la clave del proveedor están en las variables de la aplicación: no compartas capturas de pantalla de ellas.
- El canal de correo y los modelos predeterminados de cada proveedor no se probaron con una cuenta o clave reales, así que pruébalos antes de depender de ellos.
Problemas comunes
401 en todo
401 en todo
Es el inicio de sesión. Usa
admin y la contraseña de las salidas, o cambia HERMES_ADMIN_PASSWORD y reinicia.La aplicación muere nada más arrancar
La aplicación muere nada más arrancar
Comprueba la memoria (1,5 GB como mínimo) y el log de la aplicación.
HERMES_ADMIN_PASSWORD is required significa que falta la variable de la contraseña.Un canal no responde
Un canal no responde
Abre el log de la aplicación. Un token no válido aparece ahí (“token … was rejected”) y la aplicación sigue en pie con ese canal aparcado. No compartas este log. Después comprueba que tu propio id está en la lista de autorizados.
Edité config.yaml y volvió a como estaba
Edité config.yaml y volvió a como estaba
El proveedor y el modelo se reaplican desde las variables en cada arranque. Cambia las variables y reinicia.
El código QR de WhatsApp no aparece o caducó
El código QR de WhatsApp no aparece o caducó
Recarga Channels > WhatsApp y escanea enseguida. La primera vez tarda más porque se descarga el bridge.
Relacionado
Hermes Agent en el catálogo
Qué crea la plantilla y sus variables.
Actualizar y revertir
El snapshot de seguridad y el rollback.
Página pública
La plantilla en la galería pública.
Usar una plantilla
La galería, el asistente y las salidas.