Zum Inhalt springen
Farbschema wählenSprache wählen

Einen Discord-Bot verbinden

Der Discord-Steuerungsbot bietet dieselbe Befehlsoberfläche wie das Web-Terminal und der Telegram-Bot — Tasks starten, Status prüfen, den Issue-Assistenten nutzen, Schedules verwalten — aus jedem Discord-Client. Er läuft als eine einzelne persistente Gateway-Verbindung und startet nur, wenn DISCORD_BOT_TOKEN gesetzt ist.

  • Eine Discord-Applikation mit einem Bot-User und dessen Token (aus dem Discord Developer Portal).
  • Der Bot wurde mindestens einem Server eingeladen oder ist per DM erreichbar.
  • Eine laufende SupaCloud-Instanz, die vom Serverprozess erreichbar ist.
  • Ein eigenes SupaCloud-Konto (damit du in den Einstellungen einen Link-Token generieren kannst).
  1. Bot-Token setzen.

    Füge DISCORD_BOT_TOKEN der Serverumgebung deiner SupaCloud-Instanz hinzu, bevor du den Server startest (oder neu startest). Der Steuerungsbot startet nicht, wenn diese Variable fehlt.

    DISCORD_BOT_TOKEN=<your-bot-token>

    Bei einer erfolgreichen Gateway-Verbindung protokolliert der Server:

    discord control bot gateway live
  2. Einen Link-Token in SupaCloud generieren.

    Öffne Einstellungen in der Web-Oberfläche und navigiere zum Abschnitt Telegram. Ein Einmal-Link-Token wird automatisch generiert und dort angezeigt; kopiere ihn (klicke auf Aktualisieren, um einen neuen zu erstellen). Er läuft nach kurzer Zeit ab und kann nur einmal verwendet werden.

  3. Dein Discord-Konto verknüpfen — per DM.

    Öffne eine Direktnachricht mit deinem Bot und sende:

    /link <token>

    wobei <token> der Wert aus dem vorherigen Schritt ist.

    Bei Erfolg antwortet der Bot mit einer Bestätigung. Wenn deine Discord-Identität bereits mit einem anderen SupaCloud-Konto verknüpft ist, wird der Token nicht verbraucht, sodass der rechtmäßige Inhaber ihn noch verwenden kann.

  4. Verknüpfung überprüfen.

    Sende /status an den Bot (per DM oder in einem Kanal, den er lesen kann). Er sollte mit deinen aktiven Tasks antworten und nicht mit einer „nicht verknüpft“-Meldung.

Befehl Beschreibung
/link <token> Diese Discord-Identität mit deinem SupaCloud-Konto verknüpfen.
/status Verknüpfung prüfen — zeigt aktive Tasks, wenn das Konto verknüpft ist.

Den vollständigen Befehlssatz findest du unter Discord-Befehle.

/tasks und /issues öffnen interaktive Button-Abläufe statt einfacher Textantworten. Button-Klicks werden über Discords INTERACTION_CREATE-Ereignis an den Bot übermittelt; es ist keine zusätzliche Konfiguration erforderlich.

Der Issue-Assistent führt dich Schritt für Schritt durch Project → Issue → Agent → Starten mit Inline-Buttons und startet dann den Task. Dies entspricht derselben Funktionalität, die im Web-Terminal (issues <project> + run … --issue <id>) und im Telegram-Bot verfügbar ist.

Ein aus Discord gestarteter Task — ein direktes /run, der /run-Assistent oder der /issues-Assistent — wechselt automatisch in den Live-Modus im startenden Kanal. Sein Fortschritt streamt in eine einzige, an Ort und Stelle bearbeitete Nachricht: die Antwort des Agenten, eine laufende Liste der ausgeführten Tools und sein aktuelles Denken, alles zusammengefasst, damit der Kanal lesbar bleibt. Ein dauerhafter Unfollow-Button stoppt den Stream, die Nachricht wird beim Abschluss des Tasks automatisch finalisiert, und jede einfache (Nicht-Befehls-)Nachricht, die du beim Folgen sendest, wird dem Task als Intervention zugestellt.

Das Folgen ist pro Oberfläche — ein Discord-Start streamt nur in Discord. Das ist volle Parität mit dem Telegram-Live-Modus.