Diagnóstico de Hermes y Telegram
Primero identificá qué falla. Puede ser el chat por terminal, el comando /help o la respuesta del modelo por Telegram. Mirá los logs de la sesión CLI o del gateway dentro de lab-agent, en /workspace, y usá el wizard para revisar la configuración privada. No compartas secretos al pedir ayuda.
Si el canal no responde, revisá gateway, token del bot, usuario autorizado, proveedor y logs, en ese orden. Esta tabla te ayuda a distinguir problemas que requieren correcciones diferentes:
| Síntoma | Qué revisar |
|---|---|
| Error 401 del proveedor | Credencial de OpenRouter, no token de Telegram |
| Error 429 o modelo sin endpoint | Cuota y disponibilidad de la entrada gratuita |
| Usuario no autorizado | Tu ID numérico en la allowlist, no @username |
| Dos gateways para el mismo bot | Conservar una sola instancia activa |
| Responde /help pero no el mensaje | Proveedor, modelo y logs del gateway |
| Chat CLI funciona pero bot no responde | Canal Telegram, token, allowlist y proceso gateway |
Si encontrás gateways duplicados, identificá la terminal de la instancia sobrante y detené sólo esa con Ctrl+C. No mates procesos ajenos ni borres el perfil para empezar de cero. Para ajustar la configuración, usá hermes setup para proveedor/modelo o hermes gateway setup para el canal, en la shell del agente, y conservá los otros valores. No arranques otro gateway si ya hay uno activo.
Un error de cuota no autoriza fallback pago. Verificá límites de modelos gratuitos. La guía oficial de Telegram detalla canal y usuarios permitidos.
Después de corregir el problema, comprobá que haya un único gateway activo y que responda tanto al comando del canal como al mensaje del modelo. No sigas si necesitás mostrar tokens para explicar el fallo o la allowlist no está limitada a tu usuario.
Volvé a comprobar el mensaje.
Si falta libatomic.so.1
El Node que instala Hermes necesita esa biblioteca en Linux. La imagen actual del taller la incluye mediante el paquete libatomic1. Si estás usando una imagen anterior, no hace falta borrar el agente ni volver a configurar tus cuentas.
Para reparar una instancia ya creada, abrí otra terminal del host y comprobá que lab-agent sea tu container de la práctica y esté activo. Es el container de Hermes, no lab-app, donde corre el sitio. Desde esa terminal ejecutá:
docker exec --user 0 lab-agent apt-get update
docker exec --user 0 lab-agent apt-get install -y --no-install-recommends libatomic1Esos dos comandos usan root sólo para instalar el paquete dentro de ese container. Cuando terminen, volvé a la shell original de lab-agent como node y retomá la instalación o su comprobación. No ejecutes Hermes como root ni borres el perfil para resolver este error.
La reparación queda en esa instancia. Para las próximas, asegurate de incluir libatomic1 en la lista de paquetes de apt-get install de tu lab/Dockerfile y reconstruí taller con los mismos UID/GID que elegiste. Reconstruir la imagen no actualiza containers existentes. Si necesitás reemplazar uno, seguí la recuperación de la instancia y su perfil conservando lo anterior.
Cuando termine la reparación, retomá la instalación de Hermes. Comprobá el comando desde la shell de node antes de seguir con el proveedor.