KeepBot von A bis Z
KeepBot ist ein Bot für Twitch (Chat-Befehle, Moderation, Punkte-System, Chat-Games, Timer, Automationen, öffentliche Statistik-Seiten) und für Discord (AutoMod, Mod-Befehle, Autorolle bei Live, eigenes Discord-Dashboard). Alles läuft über app.keepbot.de.
Dieses Handbuch listet jeden Chat-Befehl, jede Einstellung und die Fragen, die erfahrungsgemäß aufkommen. Nutz die Suche oben - sie filtert die ganze Seite.
Wie das Dashboard aufgebaut ist
Die Sidebar hat zwei Kategorien, die sich gegenseitig zuklappen. Die Abschnitte darin sind ebenfalls aufklappbar - es ist immer nur einer offen.
- Twitch-Bot - Übersicht (Twitch-Dashboard, Öffentliche Seite) · Chatbot (Commands, Timers, Automationen, Counters, Module, Import) · Moderation (Filter, Rechte, Nutzer) · Loyalty (Punkte, Quotes, Stream-Store, Giveaways) · Stream & Analyse (Overlays, Aktivität, Chat-Statistik).
- Discord-Bot - Übersicht (Discord-Dashboard) · Server (Verbindung, AutoMod, Immune Rollen) · Benachrichtigungen (Stream-Benachrichtigung).
- Fest unten - Audit-Log, Einstellungen, Support, Abmelden.
Fehlt deinem Account Twitch oder Discord, steht in der jeweiligen Kategorie „Jetzt verknüpfen“ statt der Menüpunkte.
01 Einrichten
Vom Login bis der Bot im Chat schreibt.
Anmelden
- Auf app.keepbot.de/login wählst du „Mit Twitch anmelden“ (Twitch-Bot) oder „Mit Discord anmelden“ (Discord-Bot).
- Keine Angst die jeweils andere Plattform kannst du später über „Jetzt verknüpfen“ in der Sidebar oder unter Einstellungen → Verbindungen ergänzen. Danach landest du mit beiden Logins im selben Account.
- Freischaltung: Neue Accounts werden nach dem ersten Login von uns manuell freigeschaltet. Bis dahin siehst du eine Warteseite („Erneut prüfen“ lädt neu), und der Bot tritt deinem Chat noch nicht bei. Über die Entscheidung bekommst du eine Nachricht: per Twitch-Whisper, wenn du dich mit Twitch angemeldet hast, per Discord-Direktnachricht bei Discord-Login.
Bot in den Twitch-Chat holen
- Twitch-Dashboard → Bot-Einstellungen → „Zum Chat hinzufügen“. Der Bot joint sofort.
- Optional „Stummschalten“ - der Bot bleibt im Chat, schreibt aber nichts (nützlich beim Einrichten).
- Unter Sprache der Bot-Antworten Deutsch oder Englisch wählen. Betrifft alle eingebauten Antworten (Games, Moderation,
!points…), nicht deine eigenen Command-Texte.
02 Commands
Eingebaute Standard-Befehle sind sofort da und lassen sich pro Kanal abschalten und umbenennen. Eigene Commands legst du unter Twitch-Bot → Chatbot → Commands an (mit Aliassen, Cooldowns und Rechte-Level).
Standard-Befehle
!points <user> für jemand anderen. Heißt die Währung z. B. „Kekse“, funktioniert automatisch auch !kekse.!uptime wird so z. B. !laufzeit - danach reagiert nur noch der neue Name. Feld leer lassen stellt den Originalnamen wieder her.Eigene Commands
- Anlegen über die Kachel „Neuer Command“ oben in der Liste - das Formular öffnet sich als Fenster. Bearbeiten (Stift) öffnet dasselbe Fenster; Schalter, Bearbeiten und Löschen stehen immer sichtbar in jeder Zeile. Genauso funktionieren Timers, Counters, Automationen, Store-Artikel und Rechte.
- Name, Antwort-Text, Rechte-Level (Alle / Follower / Sub / VIP / Mod / Broadcaster), Cooldowns (global / pro Nutzer / pro Kanal).
- Aliase pro Command über den „Aliase“-Button.
- Der Antwort-Text darf Text-Variablen enthalten.
- Ein eigener Command mit gleichem Namen hat immer Vorrang vor dem Standard-Befehl.
Counters
Ein Zähler wie !deaths: !deaths zeigt den Wert, !deaths +1 / -2 ändert ihn, !deaths 0 setzt ihn, !deaths reset nullt ihn. In Texten über {count:deaths}. Name per Klick direkt in der Tabelle umbenennbar; „Ändern durch“ legt fest, wer +/- darf.
03 Text-Variablen
In eigenen Commands und Timern verfügbar. In geschweiften Klammern.
{user} {user.login}{channel}{args} {target} {touser}{count} {count:name}{uptime} {viewers} {game} {title}{followage} {rank} {time}{urlfetch <url>} {customapi <url>}04 Module & Chat-Games
Unter Chatbot → Module. Jedes Modul einzeln an/aus, mit eigenen Parametern. Einsätze und Gewinne laufen über das Punkte-System und landen im Audit-Log.
8ball
Roulette
Slots
Duel
Verlosung
!join bei, Mods ziehen.Giveaway
Wetten / Contests
Votekick
Emote-Pyramide
Viewer-Queue
!bet ist bot-intern (nutzt die Bot-Punkte, sofort auszahlbar). !prediction ist die native Twitch-Prediction mit Kanalpunkten - siehe Integrationen.05 Moderation
Unter Moderation → Moderation. Ein Preset-Umschalter (Aus / Minimal / Mittel / Streng) setzt sinnvolle Werte für alle Filter; einzelne Filter lassen sich aufklappen und feinjustieren. Mods und Broadcaster sind von allen Filtern ausgenommen.
!permit, erlaubte Domains über die Whitelist.Sanktionsstufen & Eskalation
Pro Filter: INFO · WARNING (Hinweis im Chat) · TIMEOUT (mit Dauer) · BAN. Optional eskaliert der Bot Wiederholungstäter innerhalb eines Zeitfensters automatisch Richtung Timeout/Ban.
Whitelist
Vier Typen: Domain (erlaubter Link), Wort (Ausnahme vom Wortfilter), Nutzer (komplett ausgenommen), Rolle (Rolle komplett ausgenommen).
Nutzer-Verwaltung
Unter Moderation → Nutzer: Suche → Profil mit Status, Punkten, Watch-Time und letzten Buchungen. Interne Rollen MODERATOR / VIP vergeben, Nutzer per Opt-out aus Punkten/Statistik nehmen. Die Rolle ADMIN (= Dashboard-Zugriff) vergibt nur der Besitzer - am einfachsten unter Einstellungen → Team & Zugriff.
06 Punkte & Ränge
Unter Loyalty → Punkte. Der Tab „Einstellungen“ steuert, wie Punkte vergeben werden.
!<name> funktioniert dann automatisch.!rank, in {rank} und im Leaderboard.Leaderboard
Drei Tabs: Aktuell (Guthaben), Gesamt verdient (Summe aller positiven Buchungen - importierte Guthaben zählen hier nicht mit) und Watch-Time. Punkte lassen sich pro Nutzer manuell vergeben / setzen / zurücksetzen (mit Begründung, landet im Audit-Log).
Quotes
Zitatsammlung: !quote (zufällig), !quote <nr>, !quote add <text> (Mods). Verwaltung unter Loyalty → Quotes.
07 Store & Giveaways
Der Stream-Store (Loyalty → Stream-Store) lässt Zuschauer Punkte gegen Belohnungen eintauschen.
- Artikel: Name, Kosten, Bestand (oder unbegrenzt), Typ (Text / Sound / Zugang / eigen), an/aus.
- Zuschauer lösen mit
!redeem <name>ein - die Punkte werden sofort abgebucht, die Einlösung landet als „ausstehend“ in der Queue. - Im Dashboard Genehmigen oder Ablehnen. Ablehnen erstattet Punkte und Bestand zurück.
Die Giveaway-Historie (Titel, Gewinner, Teilnehmerzahl) steht im Modul Giveaway unter Chatbot → Module.
08 Timer & Automationen
Timers
Chatbot → Timers. Wiederkehrende Nachrichten mit Intervall und Mindest-Chatzeilen (postet nur, wenn genug los ist). Optional als Twitch-Announcement mit Farbwahl statt normaler Nachricht.
Automationen
Chatbot → Automationen. Aufbau Trigger → Bedingungen → Aktionen. Aktionen u. a.: Chat-Nachricht, Timeout/Ban, Punkte geben/abziehen, Titel/Kategorie ändern, Shoutout, Umfrage starten, Prediction starten/beenden, anderen Command ausführen.
09 Statistik, Feed & Audit
10 Öffentliche Seiten
Ohne Login erreichbar, gepflegt unter Twitch-Bot → Übersicht → Öffentliche Seite.
/c/<kanal>/c/<kanal>/leaderboard/c/<kanal>/stats11 Integrationen
Discord-Stream-Benachrichtigung
Discord-Bot → Benachrichtigungen → Stream-Benachrichtigung. Postet über einen Discord-Webhook, sobald der Stream online geht - Embed mit Titel, Kategorie, Vorschaubild und Link. Optional auch bei Follower-Meilensteinen, neuen Clips sowie Giveaway-Start und -Gewinner. Das funktioniert auch ohne den Discord-Bot auf deinem Server; der Bot selbst ist im Kapitel Discord-Bot beschrieben.
- Webhook in Discord anlegen (Kanal → Bearbeiten → Integrationen → Webhooks) und die URL einfügen. Nur echte
discord.com/api/webhooks/…-URLs werden akzeptiert. - Erwähnung wählbar: keine /
@everyone/@here/ Rollen-ID. - Nachricht per Template:
{mention} {title} {game} {url}. „Test senden“ schickt einen Beispiel-Post.
Import aus anderen Bot-Plattformen
Chatbot → Import. Rohes JSON aus der API des bisherigen Bots einfügen - die Quelle wird automatisch erkannt.
- Übernimmt Commands, Timer, Quotes, verbotene Wörter und Loyalty-Punkte. „Vorschau“ zeigt die Fundzahlen, ohne zu schreiben.
- Vorhandene Einträge werden nicht überschrieben, sondern übersprungen. Für Punkte werden die Logins bei Twitch aufgelöst; unbekannte werden übersprungen.
Twitch-Predictions
Native Kanalpunkte-Predictions, von Mods aus dem Chat gesteuert:
channel:manage:predictions erteilt. Ohne das antwortet !prediction mit „Prediction fehlgeschlagen“.12 Discord-Bot
Ein zentraler Bot (hansen_army) moderiert direkt auf deinem Discord-Server. Alles unter Discord-Bot in der Sidebar.
Server verbinden
- Discord-Bot → Server → Verbindung (oder im Discord-Dashboard): „Bot einladen“, Server auswählen, bestätigen. Der Server wird dabei automatisch mit deinem Account verknüpft, du landest direkt im Discord-Dashboard.
- Bot schon auf dem Server (z. B. von früher)? „Verknüpfungscode generieren“ und im Server
/link <code>eingeben. Die Seite aktualisiert sich danach von selbst. - Die Karte „Server“ im Discord-Dashboard zeigt, ob der Bot aktiv ist; rote Hinweise nennen fehlende Rechte.
Discord-Dashboard
Aufgebaut wie das Twitch-Dashboard: Live-Kacheln (Bot, Mitglieder, online, im Sprachkanal, gerade live), Kennzahlen für Woche/Monat/Jahr (Nachrichten, Beitritte, Austritte, AutoMod, Verwarnungen, Timeouts, Bans), Aktivitäts-Diagramm, „Letzte Ereignisse“, „Letzte Moderation“ und eine Konfigurations-Übersicht. Kacheln sind anklickbar: „Gerade live“ zeigt, wer streamt (mit Link), „Im Sprachkanal“ die Mitglieder je Kanal, „Online“ den Status, „Mitglieder“ die neuesten Beitritte, die Zeitraum-Kacheln die einzelnen Ereignisse (30 Tage gespeichert).
AutoMod
Discord-Bot → Server → AutoMod. Jede Regel einzeln an/aus mit eigener Aktion - Hinweis, Nachricht löschen & warnen, löschen & stummschalten oder löschen & sperren - und eigenen Einstellungen (Zahnrad).
Berechtigungen pro Regel: Rollen- und Kanal-Ausnahmen („für alle verweigern, außer …“ bzw. „für alle zulassen, außer …“).
- Automatisierte Aktionen - zusätzliche Eskalation ab einer Anzahl Verstöße in einem Zeitfenster (z. B. Bann nach 5 Verstößen in 10 Minuten).
- Eingeschränkte Kanäle - Kanäle, in denen nur Bilder, Videos und/oder Befehle erlaubt sind; alles andere wird gelöscht.
- Immune Rollen (Server → Immune Rollen) - Rollen, die AutoMod komplett ignoriert. Server-Besitzer und Administratoren sind immer immun.
Mod-Befehle
Mitglieder mit immuner Rolle sind vor den Befehlen geschützt. Unter Verbindung stellst du ein, ob Aktionen im Kanal gemeldet, per DM an den Nutzer geschickt und in einem Log-Kanal protokolliert werden. Optional werden Twitch-Bans auch in Discord angewendet (für Zuschauer, die Twitch und Discord verknüpft haben).
Server-Protokoll im Log-Kanal
Ist ein Log-Kanal eingerichtet, meldet der Bot dort zusätzlich (unter Verbindung → Server-Protokoll im Log-Kanal einzeln abschaltbar):
- Server verlassen: „… hat den Server verlassen“ mit Rollen, seit wann die Person Mitglied war und der neuen Mitgliederzahl.
- Rollen-Änderungen: „Rolle erstellt / aktualisiert / gelöscht“, bei Änderungen mit ✓ erlaubten und ✗ entzogenen Berechtigungen, Name, Farbe und Anzeige. Reines Umsortieren der Rollenliste wird nicht gemeldet.
Geteilte Bann-Listen
Mit befreundeten Streamern Banns teilen, auf Twitch und Discord. Zu finden unter Twitch-Bot → Moderation oder Discord-Bot → Server → Geteilte Bann-Listen.
- Gründen (Premium): Name vergeben, du bekommst einen Einladungscode
BAN-XXXX-XXXXzum Weitergeben. - Beitreten (kostenlos): Code eingeben, der Gründer bestätigt die Anfrage. Danach werden alle bestehenden Banns der Liste bei dir übernommen.
- Automatisch: Bannt ein Mitglied jemanden dauerhaft, egal ob über das Dashboard, direkt auf Twitch, durch einen Mod oder auf Discord, wird die Person bei allen anderen Mitgliedern gebannt. Timeouts werden nicht geteilt.
- Entbannen wirkt für alle nur, wenn der Kanal entbannt, der gebannt hat. Dieser Kanal und der Gründer können einen Eintrag auch per Aufheben überall aufheben.
- Plattformen: Pro Liste wählst du mit den Schaltern Twitch und Discord, wofür sie bei dir gilt, beim Beitreten und später unter „Gilt bei dir für“. Ist eine Plattform aus, werden deine Banns dort nicht geteilt und die Banns der Liste dort nicht gesetzt. Schaltest du sie später ein, werden die bestehenden Banns nachgezogen.
- Importieren (Banns importieren): deine bestehenden Twitch-Banns, die Banns deines Discord-Servers oder eine Datei mit Twitch-Namen (TXT/CSV, ein Name pro Zeile). Importierte Banns werden bei allen anderen Mitgliedern gesetzt.
Autorolle bei Live
Mitglieder, deren Discord-Status „streamt“ zeigt (Twitch/YouTube in Discord unter Verbindungen verknüpft), bekommen automatisch die gewählte Rolle. Sind sie dabei in einem Sprachkanal, wird ihr Servername mit „[LIVE]“ markiert; verlassen sie den Sprachkanal oder beenden den Stream, wird das zurückgenommen.
13 Einstellungen & Konto
Unten in der Sidebar unter Einstellungen.
14 FAQ
Die Fragen, die erfahrungsgemäß aufkommen.
Der Bot ist im Chat, antwortet aber auf nichts.
Der Reihe nach prüfen: Ist er stummgeschaltet (Twitch-Dashboard → Bot-Einstellungen)? Ist der betreffende Standard-Befehl im Kanal abgeschaltet? Läuft noch ein Cooldown? Hat der:die Nutzende das nötige Rechte-Level (z. B. Mod-only)? Bei !points/!rank: Punkte-Modul überhaupt aktiv?
Ich habe einen neuen Kanal verbunden - muss ich den Bot neu starten, damit er joint?
Nein. Das war früher so, ist behoben: sobald ein Kanal aktiviert wird, joint der Bot automatisch.
Warum zählt die Watch-Time nicht?
Watch-Time (und je nach Einstellung auch Chat-Punkte) werden nur gezählt, während der Stream online ist. Außerdem prüfen: Steht der Account auf der Liste ausgeschlossener Accounts oder hat er Opt-out?
Wie ändere ich den Namen der Währung?
Loyalty → Punkte → Einstellungen → Währungsname. Der Chat-Befehl passt sich automatisch an: heißt sie „Kekse“, funktioniert !kekse genau wie !points.
Wie lege ich einen eigenen Command an?
Chatbot → Commands → Kachel „Neuer Command“. Name ohne !, Antwort-Text (darf Variablen enthalten), Rechte-Level und Cooldowns. Aliase danach über den „Aliase“-Button.
Was bedeuten die Schutzstufen bei der Moderation?
Aus / Minimal / Mittel / Streng sind Presets: ein Klick setzt für alle Filter zusammenpassende Werte und Sanktionen. Danach kannst du einzelne Filter aufklappen und nachjustieren - die Stufe bleibt als Ausgangspunkt.
Wie funktioniert !permit?
!permit <user> (Mods) gibt einem Nutzer für 60 Sekunden frei, einen Link zu posten, ohne dass der Link-Filter zuschlägt. !permit <user> 120 für 120 Sekunden. Dauerhaft erlaubte Domains gehören in die Whitelist, ganze Rollen (Sub/VIP) über das Häkchen am Link-Filter.
!prediction sagt „Prediction fehlgeschlagen“.
Dem Bot fehlt die Twitch-Berechtigung channel:manage:predictions. Unter Einstellungen → Verbindungen auf „Neu autorisieren“ klicken - beim erneuten OAuth wird der Scope erteilt.
Unterschied zwischen !bet und !prediction?
!bet ist eine bot-interne Wette auf die Bot-Punkte - läuft komplett im Bot, sofort auszahlbar, auch wenn du keine Kanalpunkte-Predictions nutzen willst. !prediction startet die native Twitch-Prediction mit Kanalpunkten.
Wie importiere ich meine Commands aus meinem bisherigen Bot?
Chatbot → Import. Rohes JSON aus der API des bisherigen Bots im eingeloggten Browser öffnen, kopieren und einfügen. „Vorschau“ zeigt, was erkannt wurde; „Importieren“ übernimmt es. Vorhandene Commands bleiben unangetastet.
Der Discord-Post kommt nicht, wenn ich live gehe.
Prüfen: Integration aktiv, gültige Webhook-URL gespeichert (Test-Button nutzen), Häkchen „Bei Stream online“ gesetzt. Der Post kommt pro Stream nur einmal (Schutz gegen Doppel-Posts). Erkennt Twitch den Stream-Start verzögert, kann der Post ein paar Minuten brauchen.
Beim Laden ist die Seite kurz weiß / flackert.
Der Effekt (FOUC) ist behoben - das Dashboard tauscht sein Stylesheet erst, wenn das neue geladen ist. Falls es doch auftritt: einmal hart neu laden (Strg + F5).
Können Mods ins Dashboard?
Ja. Unter Einstellungen → Team & Zugriff fügst du sie per Twitch-Name als Admin hinzu. Sie melden sich mit ihrem eigenen Twitch-Account an und sehen dann deinen Kanal - ohne eigene Freischaltungs-Anfrage. Das Team selbst verwaltet nur der Besitzer. Twitch-Mod/VIP werden bei Aktivität automatisch von Twitch übernommen.
Nach dem Login sehe ich nur „Dein Account wartet auf Freischaltung“.
Neue Accounts werden von uns manuell freigeschaltet. Sobald wir entschieden haben, bekommst du eine Nachricht per Twitch-Whisper bzw. Discord-Direktnachricht (je nachdem, womit du dich angemeldet hast). Bis zur Freischaltung tritt der Bot deinem Chat nicht bei. Wurde dein Account abgelehnt, melde dich bitte unbedingt im Discord-Support. Ohne Kontakt können wir ihn nicht freischalten.
Brauche ich Twitch und Discord?
Nein. Mit Twitch nutzt du den Twitch-Bot, mit Discord den Discord-Bot. Die jeweils andere Plattform kannst du jederzeit über „Jetzt verknüpfen“ ergänzen - danach kommst du mit beiden Logins in denselben Account.
Ich habe mich aus Versehen erst mit Discord angemeldet - jetzt habe ich zwei Accounts.
Mit Twitch anmelden, dann Einstellungen → Verbindungen → Discord verknüpfen. Ein leerer Discord-Account (ohne Twitch und ohne verbundenen Server) wird dabei automatisch übernommen und entfernt.
Die Autorolle bei Live wird nicht vergeben.
Die Bot-Rolle braucht „Rollen verwalten“ (und für „[LIVE]“ im Namen „Nicknames verwalten“) und muss in der Rollenliste über der Live-Rolle stehen - das Dashboard zeigt fehlende Rechte rot an. Außerdem erkennt Discord „live“ nur, wenn das Mitglied Twitch/YouTube in Discord unter Verbindungen verknüpft hat und der Status als „streamt“ angezeigt wird. Den Server-Besitzer kann Discord grundsätzlich nicht umbenennen.
Muss ich mich regelmäßig einloggen, damit mein Account bleibt?
Nein. Einmal eingerichtet läuft der Bot einfach weiter - die Twitch-Verbindung wird automatisch erneuert, egal wie selten du ins Dashboard schaust.
Nur wenn Twitch dem Bot den Zugriff entzieht (z. B. nach einer Passwortänderung oder wenn du die App bei Twitch entfernst), bekommst du einen Twitch-Whisper, eine Discord-Nachricht und im Dashboard einen roten Hinweis. Ob beides bei dir ankommt, prüfst du unter Einstellungen → Konto & Daten → Benachrichtigungen testen. Ein Klick auf „Neu autorisieren“ genügt. Passiert das 90 Tage lang nicht (mit Erinnerung 14 Tage vorher), wird der Account gelöscht.
Wie lade ich meine Daten herunter oder lösche meinen Account?
Einstellungen → Konto & Daten. Dort gibt es den Datenexport als JSON und „Account löschen“ (mit Bestätigung durch Eintippen des Namens). Zusätzlich kannst du die Twitch-Autorisierung unter Twitch → Einstellungen → Verbindungen entfernen.
Punkte eines Zuschauers sind falsch - was tun?
Loyalty → Punkte → Punkte vergeben. Nutzer suchen, dann vergeben (addieren), setzen (auf einen Wert) oder zurücksetzen. Jede Änderung steht mit Begründung im Audit-Log. Die letzten Buchungen eines Nutzers siehst du in seinem Profil.
Wie oft aktualisieren sich die Statistiken?
Live-Kacheln alle 15 s. Chat-/Emote-Statistik wird laufend gezählt (rückwirkend erst ab Einführung). Die Namen der 3rd-Party-Emotes (BTTV/FFZ/7TV) holt der Bot alle 6 Stunden.
Ist der Bot down?
app.keepbot.de/health zeigt Version und Status. Nach einem Update dauert ein Deploy rund 10 Minuten, in denen der Bot kurz neu startet.
Bekommen andere meine Chat-Statistik zu sehen?
Nur wenn du es willst. /c/<kanal>/stats ist standardmäßig aus und wird erst mit dem Häkchen „Öffentliche Chat-Statistik“ (Übersicht → Öffentliche Seite) freigegeben.