Commande hermes gateway — Référence Complète & Exemples

Vue d’ensemble

hermes gateway gère la passerelle de messagerie unifiée qui connecte Hermes à Telegram, Discord, WhatsApp, Weixin et d’autres plateformes. Elle prend en charge un mode interactif au premier plan et un service d’arrière-plan géré.

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

Sous-commandes

run — Mode premier plan (recommandé pour WSL, Docker, Termux)

hermes gateway run
hermes gateway run -v           # Augmenter la verbosité stderr (-v INFO, -vv DEBUG)
hermes gateway run -q           # Supprimer toute la sortie de log stderr
hermes gateway run --replace    # Remplacer toute instance existante
hermes gateway run --force      # Démarrer même si un service supervise déjà ce profil

start / stop / restart — Contrôle du service

hermes gateway start
hermes gateway start --system   # Cibler le service au niveau système Linux
hermes gateway start --all      # Tuer d'abord les processus résiduels de tous les profils
hermes gateway stop
hermes gateway restart

status — Afficher l’état de la passerelle

hermes gateway status
hermes gateway status --deep    # Vérification approfondie
hermes gateway status -l        # Sortie complète, non tronquée
hermes gateway status --system  # Cibler le service au niveau système Linux

install / uninstall — Installer comme service

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

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

list — Lister les profils et leur état

hermes gateway list

setup — Configurer les plateformes

hermes gateway setup

migrate-legacy — Supprimer les unités de service héritées

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

Arrête, désactive et supprime les anciennes unités hermes.service laissées par les anciennes installations, sans toucher aux unités de profil ni aux services tiers.

enroll — S’inscrire auprès d’un connecteur relay

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

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

Scénarios courants

Exécuter la passerelle interactivement

hermes gateway run

Installer et démarrer comme service

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

Redémarrer après modification de configuration

hermes gateway restart

Nettoyer les unités héritées

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

Astuces

• Préférez hermes gateway run pour la configuration initiale, WSL, Docker et le débogage ; les erreurs apparaissent directement.
• N’utilisez --force que si vous comprenez qu’un second dispatcher peut corrompre l’état partagé.
• start --all tue les processus résiduels de tous les profils avant le démarrage.
• setup guide la configuration des plateformes (Telegram, Discord, WhatsApp, etc.).
• enroll écrit les credentials relay dans ~/.hermes/.env; nécessite d’être connecté (via hermes setup).