OpenClaw mit Discord verbinden

Kurz gesagt. Erstelle im Discord Developer Portal eine Anwendung, öffne Bot, drücke Reset Token, um den Token zu bekommen, und schalte Message Content Intent ein. Lade den Bot auf einen Server ein, auf dem du bist, schalte in Discord den Developer Mode ein und kopiere deine eigene Nutzer-ID. Gib OpenClaw dann den Token und erlaube nur deine Nutzer-ID. Auf PlayNHost sind das zwei Felder auf der Seite Agent und ein Neustart. Das Panel installiert den Discord-Connector von OpenClaw für dich.

Geprüft am 6. November 2026, gültig für OpenClaw 2026.11.1.

Diese Anleitung folgt der Discord-Einrichtungsdokumentation von OpenClaw und dem PlayNHost-Panel, so wie es heute funktioniert.

Schritt 1: Discord-Anwendung und Bot erstellen

1. Öffne das Discord Developer Portal, drücke New Application und gib ihr einen Namen.
2. Öffne in der Seitenleiste Bot und setze den Username des Bots auf den Namen deines Agents.
3. Schalte, weiterhin unter Bot, bei Privileged Gateway Intents Folgendes ein:
   • Message Content Intent: hier erforderlich. OpenClaw fragt Discord danach, und Discord lehnt die Verbindung ab („disallowed intents“), wenn er ausgeschaltet ist.
   • Server Members Intent: von OpenClaw empfohlen, nötig für Rollen-Allowlists und das Zuordnen von Namen zu IDs.
   • Presence Intent: optional, nur für Präsenz-Updates.
4. Drücke Reset Token und kopiere den Token. Trotz des Namens erzeugt der erste Druck deinen ersten Token. Halte ihn geheim.

Schritt 2: Bot einladen und DMs erlauben

1. Öffne OAuth2, dann den OAuth2 URL Generator. Hake die Scopes bot und applications.commands an.
2. Hake unter Bot Permissions mindestens View Channels, Send Messages, Read Message History, Embed Links und Attach Files an (Add Reactions ist optional).
3. Öffne die erzeugte URL, wähle deinen Server und drücke Continue. Am einfachsten ist ein privater Server nur mit dir und dem Bot.
4. Erlaube dem Bot, dir zu schreiben: Klicke mit rechts auf das Server-Symbol, öffne Privacy Settings und schalte Direct Messages ein.

Schritt 3: Deine Discord-Nutzer-ID kopieren

Öffne in Discord User Settings, dann Developer, und schalte Developer Mode ein (auf dem Handy: App Settings, Advanced). Klicke dann mit rechts auf deinen eigenen Avatar oder Namen und wähle Copy User ID. Das ist eine lange Zahl (PlayNHost akzeptiert 17 bis 20 Ziffern).

Die Discord-Doku von OpenClaw nutzt dafür den Developer Mode, und das Panel auch: Anders als bei der Telegram-Einrichtung bittet dich die Console nicht, deine ID aus einer Bot-Antwort abzulesen.

Schritt 4 auf PlayNHost: Token und ID einfügen

1. Öffne deinen Server unter panel.playnhost.com, dann den Tab Agent. Setze unter KI-Anbieter einen KI-Anbieter-Schlüssel, falls du das noch nicht getan hast (siehe welchen KI-Schlüssel du nutzt).
2. Drücke unter Chat-Apps bei Discord-Bot-Token auf Setzen, füge den Token ein und drücke Speichern. Das Panel prüft seine Form: Bei einer falschen Eingabe erscheint „That is not a valid discord bot token.“ (also: kein gültiger Discord-Bot-Token).
3. Gib unter Wer ihm schreiben darf deine ID bei Discord-Nutzer-IDs ein und drücke Speichern. Mehrere IDs kommen in eine Zeile, durch Kommas getrennt.
4. Drücke Starten, oder Jetzt neu starten, falls der Agent schon läuft. Discord ist ein eigenes OpenClaw-Plugin, also installiert der erste Start mit einem Discord-Token es einmalig. Neben anderen Zeilen zeigt die Console:

   [PlayNHost] Installing the Discord connector 2026.11.1
   [PlayNHost] Starting OpenClaw 2026.11.1
   [PlayNHost] Your agent is running
   [PlayNHost] Discord: only user 123456789012345678 can message your agent.

   In unserem Test dauerte die Installation des Connectors etwa 30 Sekunden. Spätere Starts verwenden ihn weiter und aktualisieren ihn, wenn OpenClaw selbst aktualisiert wird.
5. Sende deinem Bot in Discord eine Direktnachricht. Dein Agent antwortet. Andere Discord-Konten werden ignoriert.

Lässt du Discord-Nutzer-IDs leer, sagt die Console „Discord: nobody can message your agent yet“ (noch kann niemand deinem Agent schreiben) und erklärt, wie du deine ID kopierst. Bis du sie einträgst, wird jeder ignoriert, der dem Bot eine DM schickt. OpenClaw beantwortet eine erste Nachricht mit einem Pairing-Code: Ignoriere ihn, es muss nichts freigegeben werden, und trage stattdessen deine Nutzer-ID im Bereich Agent ein.

Was PlayNHost für dich einstellt

• Discord-DMs nutzen dmPolicy: "allowlist" mit den IDs aus dem Bereich Agent (oder pairing, solange die Liste leer ist), und diese IDs werden zu den Besitzern der Befehle bei OpenClaw.
• Server-Kanäle bleiben geschlossen: Der Standard groupPolicy von OpenClaw ist allowlist, und kein Server steht auf dieser Liste, bis einer in die Einstellungen von OpenClaw aufgenommen wird. Nutze Direktnachrichten.
• Der Token erreicht OpenClaw als DISCORD_BOT_TOKEN in seiner Umgebung. Ein Token in der Einstellungsdatei von OpenClaw hätte Vorrang davor, deshalb entfernt der Start diesen.
• Derselbe Server kann auch über Telegram sprechen: Setze beide Token und beide ID-Listen. Siehe OpenClaw mit Telegram verbinden.

Schritt 4 auf deinem eigenen Rechner

1. Prüfe mit openclaw plugins list, ob das Discord-Plugin vorhanden ist. Bei unserer Testinstallation des npm-Pakets 2026.11.1 war es nicht gebündelt; das hier hat es hinzugefügt:

   openclaw plugins install npm:@openclaw/discord

2. Lege den Token in die Umgebung des Gateways (nie in einen Chat) und verweise die Konfiguration darauf, mit Zugriff nur für dich:

   export DISCORD_BOT_TOKEN="YOUR_BOT_TOKEN"
   cat > discord.patch.json5 <<'JSON5'
   {
     channels: {
       discord: {
         enabled: true,
         token: { source: "env", provider: "default", id: "DISCORD_BOT_TOKEN" },
         dmPolicy: "allowlist",
         allowFrom: ["123456789012345678"],
       },
     },
     commands: {
       ownerAllowFrom: ["discord:123456789012345678"],
     },
   }
   JSON5
   openclaw config patch --file ./discord.patch.json5 --dry-run
   openclaw config patch --file ./discord.patch.json5
   openclaw gateway

   Der Teil commands macht dich zum Besitzer für Owner-Befehle, was eine von Hand geschriebene Allowlist nicht tut. Bei einer Dienst-Installation lege DISCORD_BOT_TOKEN in ~/.openclaw/.env, damit der Dienst ihn hat, und starte den Dienst neu, statt openclaw gateway auszuführen.
3. Oder behalte den Standardmodus pairing: Schreib dem Bot eine DM und gib den Code innerhalb einer Stunde frei:

   openclaw pairing list discord
   openclaw pairing approve discord <CODE>

Wenn er nicht antwortet

Noch nicht eingerichtet? Erstelle einen OpenClaw-Server.

PlayNHost ist nicht mit der OpenClaw Foundation verbunden. OpenClaw ist Open-Source-Software unter der MIT-Lizenz.