hermes gateway Befehl — Vollständige Referenz & Beispiele

Überblick

hermes gateway verwaltet das einheitliche Messaging-Gateway, das Hermes mit Telegram, Discord, WhatsApp, Weixin und weiteren Plattformen verbindet. Es unterstützt sowohl einen interaktiven Vordergrundmodus als auch einen verwalteten Hintergrunddienst.

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

Unterbefehle

run — Vordergrundmodus (empfohlen für WSL, Docker, Termux)

hermes gateway run
hermes gateway run -v           # Mehr stderr-Details (-v INFO, -vv DEBUG)
hermes gateway run -q           # Alle stderr-Logs unterdrücken
hermes gateway run --replace    # Vorhandene Gateway-Instanz ersetzen
hermes gateway run --force      # Auch starten, wenn ein Dienst dieses Profil bereits überwacht

start / stop / restart — Dienststeuerung

hermes gateway start
hermes gateway start --system   # Linux-Systemdienst ansprechen
hermes gateway start --all      # Vorher alle veralteten Prozesse aller Profile beenden
hermes gateway stop
hermes gateway restart

status — Gateway-Status anzeigen

hermes gateway status
hermes gateway status --deep    # Tiefen-Check
hermes gateway status -l        # Volle, nicht abgeschnittene Ausgabe
hermes gateway status --system  # Linux-Systemdienst ansprechen

install / uninstall — Als Dienst installieren

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

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

list — Alle Profile und deren Status auflisten

hermes gateway list

setup — Messaging-Plattformen konfigurieren

hermes gateway setup

migrate-legacy — Veraltete Service-Units entfernen

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

Stoppt, deaktiviert und entfernt veraltete hermes.service-Units aus älteren Installationen, ohne Profil-Units oder Drittanbieter-Dienste zu berühren.

enroll — Mit einem Relay-Connector registrieren

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

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

Häufige Szenarien

Gateway interaktiv ausführen

hermes gateway run

Als Dienst installieren und starten

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

Nach Konfigurationsänderungen neu starten

hermes gateway restart

Veraltete Units bereinigen

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

Tipps

• Bevorzuge hermes gateway run für Ersteinrichtung, WSL, Docker und Debugging; Fehler werden direkt angezeigt.
• Nutze --force nur, wenn du verstehst, dass ein zweiter Dispatcher den gemeinsamen Gateway-Zustand beschädigen kann.
• start --all beendet veraltete Gateway-Prozesse aller Profile vor dem Start.
• setup führt durch die Plattform-Konfiguration (Telegram, Discord, WhatsApp usw.).
• enroll schreibt Relay-Anmeldedaten in ~/.hermes/.env; erfordert Anmeldung (über hermes setup).