Discord-Einrichtung

Discord ist eine leistungsstarke Plattform für KI-Agenten-Interaktionen. Mit der OpenClaw-Discord-Integration kannst du mit deinem Agenten chatten, Dateien teilen und mit anderen in einer vertrauten Chat-Umgebung zusammenarbeiten.

Diese Anleitung führt dich durch die Erstellung eines Discord-Bots, die Konfiguration von Berechtigungen und die Verbindung mit deiner OpenClaw-Instanz.

Was du brauchst

• Ein Discord-Konto (kostenlos)
• Ein Discord-Server, auf dem du Admin-Rechte hast
• Eine laufende und erreichbare OpenClaw-Instanz
• Etwa 10 Minuten Zeit

Schritt 1: Discord-Anwendung erstellen

Zuerst musst du im Discord-Entwicklerportal eine Anwendung und einen Bot erstellen.

Zum Entwicklerportal gehen

1. Besuche das Discord Developer Portal
2. Melde dich mit deinem Discord-Konto an
3. Klicke oben rechts auf "New Application"

Anwendung benennen

1. Gib deiner Anwendung einen Namen (z.B. "Mein OpenClaw Agent")
2. Klicke auf "Create"
3. Optional: Füge eine Beschreibung und ein App-Icon hinzu

Schritt 2: Bot-User erstellen

Wandle jetzt deine Anwendung in einen Bot um, der Servern beitreten und Nachrichten senden kann.

Bot aktivieren

1. Klicke in der linken Seitenleiste auf "Bot"
2. Klicke auf "Add Bot" und bestätige
3. Dein Bot ist jetzt erstellt

Bot-Einstellungen konfigurieren

1. Unter "Privileged Gateway Intents" aktiviere:
   • MESSAGE CONTENT INTENT (erforderlich zum Lesen von Nachrichten)
   • SERVER MEMBERS INTENT (optional, für Mitglieder-Info)
2. Klicke unten auf "Save Changes"

Bot-Token abrufen

1. Im Bot-Bereich klicke auf "Reset Token"
2. Kopiere den Token sofort (er wird nicht mehr angezeigt)
3. Bewahre ihn sicher auf; du brauchst ihn für die OpenClaw-Konfiguration

Schritt 3: OAuth2 konfigurieren und Bot einladen

Dein Bot muss mit den richtigen Berechtigungen zu deinem Discord-Server eingeladen werden.

OAuth2-Scopes einrichten

1. Klicke in der linken Seitenleiste auf "OAuth2" dann "URL Generator"
2. Unter "Scopes" wähle:
   • bot
   • applications.commands (optional, für Slash-Befehle)

Bot-Berechtigungen konfigurieren

Unter "Bot Permissions" wähle diese Mindestberechtigungen:

• Nachrichten senden
• Nachrichten in Threads senden
• Links einbetten
• Dateien anhängen
• Nachrichtenverlauf lesen
• Reaktionen hinzufügen
• Slash-Befehle verwenden
• Nachrichten lesen/Kanäle ansehen

Einladungs-URL generieren und nutzen

1. Kopiere die generierte URL unten
2. Öffne die URL in deinem Browser
3. Wähle deinen Server aus dem Dropdown
4. Klicke auf "Autorisieren"
5. Schließe das CAPTCHA ab, falls angefordert

Dein Bot sollte jetzt in deiner Server-Mitgliederliste als offline angezeigt werden.

Schritt 4: OpenClaw konfigurieren

Verbinde jetzt deinen Discord-Bot mit deiner OpenClaw-Instanz.

Discord-Plugin-Konfiguration hinzufügen

Bearbeite deine OpenClaw-Konfigurationsdatei (normalerweise config.yaml oder Umgebungsvariablen):

# Discord-Plugin-Konfiguration
plugins:
  entries:
    discord:
      enabled: true
      config:
        botToken: "DEIN_BOT_TOKEN_HIER"
        # Optional: auf bestimmte Kanäle beschränken
        allowedChannels:
          - "general"
          - "bot-commands"
        # Optional: Präfix für Nachrichten erforderlich
        commandPrefix: "!"
        # Optional: Standard-Modell für diesen Kanal
        defaultModel: "moonshot/kimi-k2.5"

Alternative: Umgebungsvariablen

Du kannst auch Umgebungsvariablen nutzen:

# In deiner .env-Datei
OPENCLAW_DISCORD_TOKEN=DEIN_BOT_TOKEN_HIER
OPENCLAW_DISCORD_ENABLED=true

OpenClaw neu starten

Starte nach der Konfiguration deine OpenClaw-Instanz neu, um das Discord-Plugin zu laden:

# Bei Docker Compose
docker compose restart

# Bei systemd
sudo systemctl restart openclaw

Schritt 5: Einrichtung testen

Überprüfe, ob alles korrekt funktioniert.

Bot-Status prüfen

1. Schaue in deine Discord-Server-Mitgliederliste
2. Dein Bot sollte jetzt als online angezeigt werden (grüner Punkt)
3. Falls weiterhin offline, prüfe die OpenClaw-Logs auf Fehler

Testnachricht senden

1. Gehe in deinem Discord-Server zu einem Textkanal
2. Sende eine Nachricht, die den Bot erwähnt oder anspricht
3. Warte auf eine Antwort deines OpenClaw-Agenten

# Beispiel-Testnachrichten
Hallo Bot, was kannst du?
@MeinBotName wie ist das Wetter heute?
!help

Erweiterte Konfiguration

Kanal-spezifische Einstellungen

Verschiedene Kanäle können unterschiedliche Verhaltensweisen haben:

plugins:
  entries:
    discord:
      enabled: true
      config:
        botToken: "DEIN_TOKEN"
        channelConfigs:
          "general":
            model: "moonshot/kimi-k2.5"
            systemPrompt: "Du bist ein hilfreicher Assistent."
          "coding-help":
            model: "anthropic/claude-sonnet-4"
            systemPrompt: "Du bist ein Coding-Experte."
          "admin":
            model: "openai/gpt-5.4"
            allowedUsers:
              - "admin_user_id_123"

Thread-Unterstützung

Aktiviere Thread-Erstellung für lange Gespräche:

config:
  botToken: "DEIN_TOKEN"
  autoCreateThreads: true
  threadAutoArchiveDuration: 1440  # 24 Stunden

Direktnachrichten-Unterstützung

Erlaube Nutzern, deinen Bot direkt anzuschreiben:

config:
  botToken: "DEIN_TOKEN"
  allowDirectMessages: true
  dmRateLimitPerUser: 10  # Nachrichten pro Minute

Fehlerbehebung

Bot zeigt Offline

• Token prüfen: Überprüfe, ob der Bot-Token in der Config korrekt ist
• Logs prüfen: Suche nach Discord-Verbindungsfehlern in den OpenClaw-Logs
• Neustart: Stelle sicher, dass OpenClaw nach den Config-Änderungen vollständig neu gestartet wurde

Bot antwortet nicht auf Nachrichten

• MESSAGE CONTENT INTENT: Überprüfe, ob dies im Discord Developer Portal aktiviert ist
• Berechtigungen: Prüfe, ob der Bot Berechtigungen zum Lesen und Senden von Nachrichten hat
• Kanalzugriff: Stelle sicher, dass der Bot Zugriff auf den Kanal hat, in dem du testest
• Befehlspräfix: Falls du ein Präfix nutzt, stelle sicher, dass deine Nachricht damit beginnt

Rate-Limiting

Falls du Rate-Limit-Fehler siehst:

• Reduziere die Nachrichtenfrequenz
• Aktiviere Message-Queueing in der Config
• Erwäge Discord Nitro für höhere Limits

Slash-Befehle funktionieren nicht

• Lade den Bot mit applications.commands-Scope neu ein
• Warte bis zu einer Stunde auf globale Synchronisierung
• Oder setze eine spezifische Test-Guild für sofortige Synchronisierung

Best Practices

Sicherheit

• Speichere den Bot-Token in Umgebungsvariablen, niemals im Code
• Verwende separate Bots für Entwicklung und Produktion
• Rotiere Token regelmäßig (zurücksetzen und aktualisieren)
• Beschränke den Bot auf bestimmte Kanäle, falls möglich

Performance

• Nutze Thread-Modus für lange Gespräche, um Kanäle sauber zu halten
• Richte Rate-Limiting ein, um Missbrauch zu verhindern
• Erwäge Model-Routing zur Kostenoptimierung
• Aktiviere Context-Compaction für lange Sitzungen

User Experience

• Setze einen klaren Bot-Namen und Avatar
• Nutze Status-Nachrichten, um zu zeigen, wenn der Bot nachdenkt
• Konfiguriere Typing-Indikatoren für besseres Feedback
• Richte Hilfe-Befehle für Nutzer ein

Zusammenfassung

Die Discord-Integration bringt OpenClaw in eine vertraute Chat-Umgebung. Erstelle eine Bot-Anwendung, konfiguriere die notwendigen Berechtigungen und Intents, lade ihn zu deinem Server ein und konfiguriere OpenClaw mit deinem Bot-Token.

Mit erweiterten Funktionen wie kanal-spezifischen Modellen, Thread-Unterstützung und DM-Handling kannst du anspruchsvolle KI-gestützte Discord-Erlebnisse aufbauen.