Hermes Agent mit Discord verbinden

Kurz gesagt. Erstelle im Discord Developer Portal eine Application und einen Bot, schalte Message Content Intent und Server Members Intent ein, kopiere das Bot-Token mit Reset Token, lade den Bot auf deinen Server ein und gib Hermes Agent dann das Token und deine Discord-Nutzer-ID. Nur die IDs auf seiner Allowlist können mit ihm sprechen. Auf deiner eigenen Maschine sind das DISCORD_BOT_TOKEN und DISCORD_ALLOWED_USERS in ~/.hermes/.env oder hermes gateway setup. Bei PlayNHost fügst du Token und ID auf der Seite Agent ein und startest neu.

Geprüft am 7. November 2026, gültig für Hermes Agent v0.23.0.

Dieser Leitfaden nutzt die Discord- und Sicherheitsdokumentation von Hermes Agent und das PlayNHost-Panel in seinem heutigen Stand. Die Discord-Unterstützung ist fester Bestandteil des Messaging-Gateways von Hermes Agent.

Schritt 1: Application und Bot erstellen

1. Öffne das Discord Developer Portal, drücke New Application, gib einen Namen ein und drücke Create. Notiere die Application ID auf der Seite General Information.
2. Öffne im linken Menü Bot. Setze unter Authorization Flow Public Bot auf an, wenn du den eigenen Einladungslink von Discord nutzen willst (Schritt 2), und lass Require OAuth2 Code Grant aus.
3. Schalte unter Privileged Gateway Intents Message Content Intent und Server Members Intent ein und drücke dann Save Changes. Die Dokumentation von Hermes Agent kennzeichnet beide als erforderlich: Ohne Message Content Intent verweigert Discord die Verbindung des Bots, und er geht nie online. Presence Intent ist optional.
4. Drücke unter Token auf Reset Token und kopiere das Token. Discord zeigt es nur einmal. Halte es geheim: Wer es hat, steuert deinen Bot.

Schritt 2: den Bot auf deinen Server einladen

Nutze entweder Installation (Guild Install, Discord Provided Link, die Scopes bot und applications.commands und die unten aufgeführten Berechtigungen) oder baue den Link selbst mit der Application ID aus Schritt 1:

https://discord.com/oauth2/authorize?client_id=YOUR_APP_ID&scope=bot+applications.commands&permissions=309237763136

309237763136 ist der Berechtigungssatz, den die Dokumentation von Hermes Agent empfiehlt: View Channels, Send Messages, Embed Links, Attach Files, Read Message History, Create Public Threads, Send Messages in Threads und Add Reactions. Öffne den Link, wähle deinen Server und drücke Authorize. Du brauchst auf diesem Server die Berechtigung Manage Server.

Schritt 3: deine Discord-Nutzer-ID herausfinden

1. Öffne in Discord Settings, Advanced und schalte Developer Mode ein.
2. Klicke mit rechts auf deinen eigenen Namen und wähle Copy User ID. Das ist eine lange Zahl, zum Beispiel 284102345871466496.

Das ist deine Nutzer-ID, nicht die Application ID des Bots und keine Server- oder Kanal-ID.

Schritt 4 bei PlayNHost: Token und ID einfügen

1. Öffne deinen Server unter panel.playnhost.com und dann den Tab Agent.
2. Setze unter KI-Anbieter einen Schlüssel, falls noch nicht geschehen (siehe Welchen KI-Schlüssel du für Hermes Agent verwendest).
3. Drücke unter Chat-Apps bei Discord-Bot-Token auf Setzen, füge das Token ein und drücke Speichern. Die Zeile zeigt dann nur die letzten vier Zeichen; das Token wird nie wieder angezeigt.
4. Füge unter Wer ihm schreiben darf deine ID bei Discord-Nutzer-IDs ein und drücke Speichern. Mehrere IDs kommen in eine Zeile, getrennt durch Kommas oder Leerzeichen.
5. Drücke Starten, oder Jetzt neu starten, wenn der Agent schon läuft („Änderungen gelten ab dem nächsten Start deines Agents.“). Wenn er läuft, bestätigt die Console:

   [PlayNHost] Your agent is running
   [PlayNHost] Discord: only user 284102345871466496 can message your agent.

6. Schicke dem Bot eine Direktnachricht oder erwähne ihn mit @ in einem Kanal, den er sehen kann. Dein Agent antwortet: in einer Direktnachricht direkt dort, in einem Kanal in einem neuen Thread unter deiner Nachricht.

Wenn du mit einem leeren Feld Discord-Nutzer-IDs startest, sagt die Console „Discord: nobody can message your agent yet“ und bittet dich, dem Bot eine Nachricht zu schicken: Eine Direktnachricht von jemandem, der nicht auf der Liste steht, wird ignoriert, und die Console gibt dann eine Zeile mit der ID dieses Absenders aus, die du hinzufügen kannst. Der Developer Mode ist der schnellere Weg.

Telegram und Discord können gleichzeitig auf demselben Agent laufen: Setze beide Tokens und beide ID-Listen.

Wie sich Hermes Agent in Discord verhält

• Direktnachrichten: Er antwortet auf jede Nachricht, ohne Erwähnung, eine Unterhaltung pro DM.
• Server-Kanäle: Er antwortet nur, wenn du ihn mit @ erwähnst, und eröffnet standardmäßig für jede Erwähnung einen neuen Thread und antwortet dort. Verschiedene Personen im selben Kanal führen getrennte Unterhaltungen.
• Andere Personen: Bei PlayNHost werden nur die Nutzer-IDs auf der Seite Agent beantwortet. Rollenfreigaben, Allow-all-Schalter und Bot-zu-Bot-Zugriff werden bei jedem Start abgeschaltet.

Schritt 4 auf deiner eigenen Maschine

1. Starte den Einrichtungsassistenten und wähle Discord. Laut Dokumentation von Hermes Agent prüft er das Token bei Discord, prüft die Intents, gibt den Einladungslink aus und bietet an, dich freizugeben:

   hermes gateway setup

2. Oder trage die Werte von Hand in ~/.hermes/.env ein:

   DISCORD_BOT_TOKEN=your-bot-token
   DISCORD_ALLOWED_USERS=284102345871466496

3. Starte es mit hermes gateway. Für ein Gateway, das nach dem Abmelden weiterläuft, siehe Hermes Agent 24/7 betreiben: VPS oder gehostet.

Wenn er nicht antwortet

Bei PlayNHost ist das eigene Log von Hermes Agent .hermes/logs/gateway.log unter Files. Du willst auch Telegram? Siehe Hermes Agent mit Telegram verbinden. Noch nicht eingerichtet? Erstelle einen Server für Hermes Agent.

PlayNHost ist nicht mit Nous Research verbunden. Hermes Agent ist Open-Source-Software unter der MIT-Lizenz.