Comando hermes gateway — Referencia Completa y Ejemplos

Descripción General

hermes gateway gestiona la pasarela de mensajería unificada que conecta Hermes con Telegram, Discord, WhatsApp, Weixin y otras plataformas. Admite un modo interactivo en primer plano y un servicio en segundo plano administrado.

hermes gateway <run|start|stop|restart|status|install|uninstall|list|setup|migrate-legacy|enroll>

Subcomandos

run — Modo primer plano (recomendado para WSL, Docker, Termux)

hermes gateway run
hermes gateway run -v           # Aumentar verbosidad de stderr (-v INFO, -vv DEBUG)
hermes gateway run -q           # Suprimir toda la salida de log en stderr
hermes gateway run --replace    # Reemplazar cualquier instancia existente
hermes gateway run --force      # Iniciar aunque un servicio ya supervise este perfil

start / stop / restart — Control del servicio

hermes gateway start
hermes gateway start --system   # Apuntar al servicio a nivel del sistema Linux
hermes gateway start --all      # Matar procesos residuales de todos los perfiles antes
hermes gateway stop
hermes gateway restart

status — Mostrar estado del gateway

hermes gateway status
hermes gateway status --deep    # Verificación profunda
hermes gateway status -l        # Salida completa sin truncar
hermes gateway status --system  # Apuntar al servicio del sistema Linux

install / uninstall — Instalar como servicio

hermes gateway install --start-now
hermes gateway install --system --start-on-login --run-as-user hermes
hermes gateway uninstall
hermes gateway uninstall --system

Banderas: --force, --system, --run-as-user, --start-now, --no-start-now, --start-on-login, --no-start-on-login.

list — Listar perfiles y estados

hermes gateway list

setup — Configurar plataformas

hermes gateway setup

migrate-legacy — Eliminar unidades de servicio heredadas

hermes gateway migrate-legacy --dry-run
hermes gateway migrate-legacy -y

Detiene, deshabilita y elimina unidades antiguas hermes.service de instalaciones previas, sin tocar las unidades de perfil ni servicios de terceros.

enroll — Inscribirse con un conector relay

hermes gateway enroll --token <TOKEN> --connector-url wss://connector.example.com/relay

Banderas: --token, --connector-url, --gateway-id, --wake-url.

Escenarios Comunes

Ejecutar el gateway interactivamente

hermes gateway run

Instalar e iniciar como servicio

hermes gateway install --start-now --start-on-login
hermes gateway status

Reiniciar tras cambios de configuración

hermes gateway restart

Limpiar unidades heredadas

hermes gateway migrate-legacy --dry-run
hermes gateway migrate-legacy -y

Consejos

• Prefiere hermes gateway run para configuración inicial, WSL, Docker y depuración; los errores aparecen directamente.
• Usa --force solo si entiendes que un segundo despachador puede corromper el estado compartido.
• start --all elimina procesos residuales de todos los perfiles antes de iniciar.
• setup guía la configuración de plataformas (Telegram, Discord, WhatsApp, etc.).
• enroll escribe credenciales de relay en ~/.hermes/.env; requiere haber iniciado sesión (vía hermes setup).