Comando hermes gateway — Referência Completa e Exemplos

Visão Geral

hermes gateway gerencia o gateway de mensagens unificado que conecta o Hermes ao Telegram, Discord, WhatsApp, Weixin e outras plataformas. Suporta um modo interativo em primeiro plano e um serviço gerenciado em segundo plano.

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

Subcomandos

run — Modo foreground (recomendado para WSL, Docker, Termux)

hermes gateway run
hermes gateway run -v           # Aumentar verbosidade do stderr (-v INFO, -vv DEBUG)
hermes gateway run -q           # Suprimir toda saída de log no stderr
hermes gateway run --replace    # Substituir qualquer instância existente
hermes gateway run --force      # Iniciar mesmo que um serviço já supervisione este perfil

start / stop / restart — Controle do serviço

hermes gateway start
hermes gateway start --system   # Alvos serviço no nível do sistema Linux
hermes gateway start --all      # Matar processos residuais de todos os perfis primeiro
hermes gateway stop
hermes gateway restart

status — Mostrar status do gateway

hermes gateway status
hermes gateway status --deep    # Verificação profunda
hermes gateway status -l        # Saída completa, não truncada
hermes gateway status --system  # Alvos serviço no nível do sistema Linux

install / uninstall — Instalar como serviço

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

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

list — Listar todos os perfis e seus status

hermes gateway list

setup — Configurar plataformas de mensagens

hermes gateway setup

migrate-legacy — Remover unidades de serviço legadas

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

Para, desabilita e remove unidades antigas hermes.service deixadas por instalações antigas, sem tocar em unidades de perfil ou serviços de terceiros.

enroll — Registrar-se em um conector relay

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

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

Cenários Comuns

Executar o gateway interativamente

hermes gateway run

Instalar e iniciar como serviço

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

Reiniciar após alterações de configuração

hermes gateway restart

Limpar unidades legadas

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

Dicas

• Prefira hermes gateway run para configuração inicial, WSL, Docker e depuração; erros aparecem diretamente.
• Use --force apenas se entender que um segundo dispatcher pode corromper o estado compartilhado.
• start --all elimina processos residuais de todos os perfis antes de iniciar.
• setup guia a configuração das plataformas (Telegram, Discord, WhatsApp, etc.).
• enroll grava as credenciais de relay em ~/.hermes/.env; requer login (via hermes setup).