Clawdbot Discord Integration

Clawdbot Discord Integrationsübersicht

Die Clawdbot Discord Integration ermöglicht es Ihnen, KI-gestützte Unterstützung auf Ihre Discord-Server zu bringen, indem Sie das offizielle Discord Bot Gateway verwenden. Dies ist bereit für DMs und Gilde-Textkanäle.

Warum Clawdbot mit Discord verwenden?

Discord ist die führende Plattform für Gaming und Community-Kommunikation. Die Integration von Clawdbot mit Discord bietet:

Schnelleinrichtung (Anfänger)

1. Erstellen Sie einen Discord-Bot und kopieren Sie das Bot-Token
2. Aktivieren Sie in den Discord-App-Einstellungen Message Content Intent (und Server Members Intent falls erforderlich)
3. Setzen Sie das Token via env (DISCORD_BOT_TOKEN=...) oder config (channels.discord.token)
4. Laden Sie den Bot mit Nachrichtenberechtigungen auf Ihren Server ein
5. Starten Sie das Gateway
6. DM-Zugriff ist standardmäßig Pairing; bestätigen Sie den Pairing-Code beim ersten Kontakt

Minimale Konfiguration:

{
  "channels": {
    "discord": {
      "enabled": true,
      "token": "YOUR_BOT_TOKEN"
    }
  }
}

Clawdbot Discord einrichten

Voraussetzungen

Bevor Sie Clawdbot mit Discord verbinden, stellen Sie sicher, dass Sie haben:

• Clawdbot auf Ihrem Gerät installiert
• Ein Discord-Konto
• Zugang zum Discord Developer Portal
• Server-Administrator-Berechtigungen

Schritt 1: Discord-Anwendung erstellen

Richten Sie Ihre Clawdbot Discord Anwendung ein:

1. Gehen Sie zum Discord Developer Portal
2. Klicken Sie auf "New Application"
3. In Ihrer App: Bot → Add Bot
4. Kopieren Sie das Bot Token

Schritt 2: Gateway Intents aktivieren

Aktivieren Sie die Intents, die Clawdbot benötigt:

• Message Content Intent — Erforderlich zum Lesen von Nachrichteninhalten
• Server Members Intent — Erforderlich für Allowlists oder Namenssuchen

Schritt 3: Einladungs-URL generieren

Verwenden Sie den OAuth2 URL Generator im Developer Portal:

Erforderliche Berechtigungen für Clawdbot Discord:

• Read Messages/View Channels
• Send Messages
• Embed Links
• Read Message History
• Add Reactions
• Use Slash Commands

Schritt 4: Clawdbot Discord konfigurieren

Fügen Sie Ihren Discord-Bot zu Clawdbot hinzu:

Umgebungsvariable:

DISCORD_BOT_TOKEN=YOUR_BOT_TOKEN

Konfigurationsdatei (~/.clawdbot/clawdbot.json):

{
  "channels": {
    "discord": {
      "enabled": true,
      "token": "YOUR_BOT_TOKEN"
    }
  }
}

Wenn sowohl env als auch config gesetzt sind, hat config Vorrang.

Schritt 5: Gateway starten

clawdbot gateway --port 18789

Discord startet automatisch, wenn ein Token verfügbar ist und channels.discord.enabled nicht false ist.

Schritt 6: Verbindung überprüfen

Überprüfen Sie Ihren Clawdbot Discord Status:

clawdbot channels status discord

Wie es funktioniert

• Direkte Chats werden in die Hauptsitzung des Agenten zusammengeführt (Standard agent:main:main)
• Gilden-Kanäle bleiben isoliert als agent:<agentId>:discord:channel:<channelId>
• Gruppen-DMs werden standardmäßig ignoriert; aktivieren Sie über channels.discord.dm.groupEnabled
• Routing ist deterministisch: Antworten kehren immer zum Kanal zurück, von dem sie kamen

Clawdbot Discord Funktionen

DM-Zugriffskontrolle

Direkte Chats sind standardmäßig über channels.discord.dm.policy gesichert:

Beispiel (strikte Allowlist):

{
  "channels": {
    "discord": {
      "dm": {
        "policy": "allowlist",
        "allowFrom": ["user:123456789"]
      }
    }
  }
}

Gilden-Kanal-Konfiguration

Legen Sie Regeln pro Gilde oder pro Kanal fest:

{
  "channels": {
    "discord": {
      "guilds": {
        "<guild_id>": {
          "channels": ["bot-commands", "ai-chat"],
          "requireMention": true
        }
      }
    }
  }
}

Slash-Befehle

Clawdbot Discord unterstützt native Slash-Befehle:

Native Befehle sind standardmäßig "auto" (für Discord/Telegram aktiviert). Überschreiben mit:

{
  "channels": {
    "discord": {
      "commands": {
        "native": true
      }
    }
  }
}

Gilden-Kontext-Verlauf

Setzen Sie channels.discord.historyLimit (Standard 20), um die letzten N Gilden-Nachrichten als Kontext einzuschließen, wenn auf eine Erwähnung geantwortet wird. Setzen Sie 0 zum Deaktivieren.

Reaktionen

Der Agent kann Reaktionen über das Discord-Tool auslösen (gesteuert durch channels.discord.actions.*).

Clawdbot Discord Konfiguration

Vollständiges Konfigurationsbeispiel

{
  "channels": {
    "discord": {
      "enabled": true,
      "token": "YOUR_BOT_TOKEN",
      "dm": {
        "policy": "pairing",
        "groupEnabled": false
      },
      "guilds": {
        "*": {
          "requireMention": true
        }
      },
      "historyLimit": 20
    }
  }
}

Konfigurationsschreibvorgänge

Standardmäßig darf Discord Konfigurationsupdates schreiben, die durch /config set|unset ausgelöst werden. Deaktivieren mit:

{
  "channels": {
    "discord": {
      "configWrites": false
    }
  }
}

Clawdbot Discord Anmeldedaten-Speicherung

Clawdbot speichert Discord-Anmeldedaten sicher:

~/.clawdbot/credentials/discord/bot_token
~/.clawdbot/credentials/discord/servers.json

Ihre Clawdbot Discord Daten verbleiben auf Ihrem lokalen Rechner.

Clawdbot Discord Fehlerbehebung

Bot offline

Wenn Clawdbot Discord als offline angezeigt wird:

1. Token überprüfen: clawdbot channels verify discord
2. Gateway-Verbindung prüfen
3. Logs überprüfen: cat /tmp/clawdbot/discord.log

Slash-Befehle funktionieren nicht

Wenn Clawdbot Discord Slash-Befehle fehlschlagen:

1. Befehle über Konfiguration neu registrieren
2. Bot-Berechtigungen prüfen
3. Serverspezifische Befehlsregistrierung überprüfen

Berechtigungsfehler

Wenn Clawdbot Discord Berechtigungen fehlen:

1. Bot-Rollenposition in den Servereinstellungen überprüfen
2. Kanalspezifische Berechtigungen prüfen
3. Mit korrekten Berechtigungen erneut einladen

Namensauflösung

Die Namens → ID Auflösung verwendet Gilden-Mitgliedersuche und erfordert Server Members Intent. Wenn der Bot keine Mitglieder suchen kann, verwenden Sie IDs oder <@id> Erwähnungen.

Clawdbot Discord Best Practices

1. Pairing-Modus verwenden: Standardmäßig sicher mit Pairing-Codes für DMs
2. Kanal-Limits setzen: Clawdbot Discord auf geeignete Kanäle beschränken
3. Rollen konfigurieren: Rollenbasierten Zugriff für Clawdbot Discord verwenden
4. Aktivität überwachen: Clawdbot Discord Logs regelmäßig überprüfen
5. Slash-Befehle verwenden: Bessere UX als Textbefehle

Clawdbot Discord Anwendungsfälle

Community-Support

Setzen Sie Clawdbot Discord als Support-Bot ein:

• FAQs automatisch beantworten
• Komplexe Probleme eskalieren
• 24/7-Unterstützung bieten

Gaming-Communities

Verwenden Sie Clawdbot Discord für Gaming-Server:

• Spielinformationen nachschlagen
• Team-Koordination
• Event-Planung

Entwickler-Communities

Clawdbot Discord für Entwickler-Server:

• Code-Unterstützung
• Dokumentationssuche
• Bug-Triage

Nächste Schritte

• Clawdbot WhatsApp Integration - Verbinden Sie Clawdbot mit WhatsApp
• Clawdbot Telegram Integration - Richten Sie Clawdbot auf Telegram ein
• Clawdbot Einrichtungsanleitung - Vollständige Installationsanleitung