hermes whatsapp Befehl — Vollständige Referenz & Beispiele

Übersicht

hermes whatsapp konfiguriert die WhatsApp-Bridge (Baileys) und koppelt sie per QR-Code mit deinem WhatsApp-Konto. Es ist ein interaktiver Assistent — es gibt keine Unterbefehle. Der Assistent führt dich durch die Auswahl eines Modus, die Einrichtung erlaubter Benutzer, die Installation der Bridge-Abhängigkeiten und das Scannen eines QR-Codes. Nach der Kopplung kannst du wie mit jedem anderen Kontakt über WhatsApp mit Hermes chatten.

hermes whatsapp

Erfordert ein TTY: Der Assistent fragt interaktiv ab.

Was der Assistent tut

1. Modus wählen — eine separate Bot-Nummer (empfohlen) oder deine persönliche Nummer (Self-Chat).
2. Erlaubte Benutzer festlegen — die Telefonnummern, die dem Agenten schreiben dürfen (kommagetrennt, oder * für alle).
3. Bridge-Abhängigkeiten installieren — führt beim ersten Mal npm install im Bridge-Verzeichnis aus (kann einige Minuten dauern).
4. Vorhandene Sitzung prüfen — wenn creds.json bereits existiert, aktuelle Kopplung behalten oder neu koppeln.
5. Per QR-Code koppeln — WhatsApp (oder WhatsApp Business) auf dem Telefon mit der Bot-Nummer öffnen, zu Verknüpfte Geräte gehen und den QR-Code im Terminal scannen.
6. Gateway starten — nach der Kopplung hermes gateway ausführen, um Nachrichten zu empfangen.

Beispiele

hermes whatsapp
# 1. Modus wählen: 1) separate Bot-Nummer (empfohlen)  2) persönliche Nummer (Self-Chat)
# 2. Erlaubte Telefonnummern eingeben (kommagetrennt, oder * für alle)
# 3. Bridge-Abhängigkeiten werden automatisch installiert
# 4. QR-Code mit WhatsApp scannen → Verknüpfte Geräte → Gerät verknüpfen
# 5. Gateway starten: hermes gateway

# Assistent mit vorhandener Sitzung erneut ausführen
hermes whatsapp
# ✓ Vorhandene WhatsApp-Sitzung gefunden — Neu koppeln? [y/N]
# 'n' antworten, um die aktuelle Kopplung zu behalten, 'y', um sie zu löschen und einen neuen QR-Code zu scannen

Tipps

• WhatsApp wird erst nach erfolgreicher Kopplung aktiviert. Wenn du den Assistenten vorzeitig abbrichst, bleibt die Bridge deaktiviert und das Gateway versucht nicht, sie zu starten.
• Die Sitzung (creds.json) wird unter ~/.hermes/whatsapp/session/ gespeichert — sichere sie, um eine erneute Kopplung zu vermeiden.
• Für einen Produktions-Bot über die offizielle Meta-API verwende hermes whatsapp-cloud — die beiden Adapter ergänzen sich, sie sind keine Alternativen.