6 Min. Lesezeit

01Was du brauchst

auf einen BlickEin Govee Home-Konto, Leuchten mit Farbunterstützung, die in der Govee Home-App eingerichtet sind, und ein Twitch-Kanal, der Kanalpunkte-Belohnungen haben kann.

Nutzt du einen KI-Assistenten? Gib ihm ai.itsbagelbot.com/govee/setup.md. Diese Seite ist für Assistenten geschrieben und verwendet die genauen Namen der Schaltflächen.

Du brauchst ein Govee Home-Konto und Govee-Leuchten, die bereits in der Govee Home-App eingerichtet sind. Leuchten, die nur Bluetooth nutzen, erscheinen unter Umständen nicht. Außerdem brauchst du einen Twitch-Kanal, der Kanalpunkte-Belohnungen erstellen kann. Die Seite Kanalpunkte im Dashboard zeigt, dass Twitch das nur Affiliate- und Partnerkanälen erlaubt. Zuschauer geben Kanalpunkte aus, um die Farbe deiner Leuchten zu ändern.

Das Dashboard hat bei jedem Schritt der Einrichtung eine Schaltfläche „Bitte deine KI um Hilfe“. Sie kopiert eine kurze Nachricht mit dem aktuellen Schritt, damit ein KI-Assistent diese Anleitung lesen und dir helfen kann. Füge deinen Govee-API-Schlüssel niemals in eine KI ein.

02Deinen Govee-API-Schlüssel holen

auf einen BlickDer Schlüssel stammt aus der Govee Home-App und kommt in der Regel per E-Mail.

Die Govee Home-App öffnen

Öffne die Govee Home-App auf deinem Handy und melde dich mit dem Konto an, dem deine Leuchten gehören.
Zum Schlüsselformular gehen

Gehe zu Profil → Einstellungen → „Apply for API Key“. In manchen Versionen der App findest du es unter Über.
Das kurze Formular ausfüllen

Fülle das kurze Formular aus und sende es ab.
Auf die E-Mail warten

Govee schickt den Schlüssel in der Regel per E-Mail an die Adresse deines Govee-Kontos. Kommt er nicht an, prüfe deinen Spam-Ordner und stelle die Anfrage dann erneut.

Ein neuer Schlüssel deaktiviert deine alten Schlüssel Wenn du auf deinem Govee-Konto einen neuen Schlüssel erzeugst, werden alle anderen aktiven Schlüssel dieses Kontos deaktiviert. Verwendet ein anderes Tool einen alten Schlüssel, funktioniert es nicht mehr. Fordere einen neuen Schlüssel nur an, wenn du ihn wirklich brauchst.

03Den Schlüssel im Dashboard verbinden

auf einen BlickÖffne die Seite Govee-Leuchten. Beim ersten Mal führt dich ein Assistent mit vier Schritten durch die Einrichtung.

Öffne die Seite Govee-Leuchten im Dashboard. Der Assistent hat vier Schritte: „Was du brauchst“, „Schlüssel anfordern“, „Schlüssel einfügen“ und „Deine Leuchten“.

Den Assistenten starten

Wähle unter „Was du brauchst“ die Option „Govee einrichten“.
Den Weg prüfen

Unter „Schlüssel anfordern“ zeigt das Dashboard denselben Weg wie oben unter „In der Govee Home-App“. Dort steht auch: „Ein neuer Schlüssel deaktiviert alle älteren Schlüssel deines Govee-Kontos.“ Wähle „Ich habe meinen Schlüssel“, sobald die E-Mail angekommen ist.
Deinen Schlüssel einfügen

Füge unter „Schlüssel einfügen“ den Schlüssel aus der E-Mail von Govee in das Feld „Govee-API-Schlüssel“ ein. Der Schlüssel wird verschlüsselt gespeichert und nie wieder angezeigt.
Speichern

Wähle „Speichern und weiter“. Das Dashboard prüft den Schlüssel zuerst bei Govee.
Deine Leuchten ansehen

Unter „Deine Leuchten“ zeigt das Dashboard „Leuchten mit Farbunterstützung gefunden“ und die Anzahl der Leuchten. Wähle „Belohnungen einrichten“, um fortzufahren.

Beim Speichern können zwei Meldungen erscheinen. Sie bedeuten nicht dasselbe:

„Govee hat diesen Schlüssel nicht akzeptiert. Prüfe ihn und versuche es erneut.“ Der Schlüssel wurde nicht gespeichert. Füge ihn erneut ein.
„Schlüssel gespeichert, aber Govee hat nicht geantwortet, daher ist er noch nicht geprüft. Deine Leuchten funktionieren, sobald Govee wieder erreichbar ist. Falls nicht, füge den Schlüssel erneut ein.“ Der Schlüssel ist gespeichert, und du kannst weitermachen.

04Die Kanalpunkte-Belohnung erstellen

auf einen BlickEine Belohnung pro Leuchte. Zuschauer geben beim Einlösen eine Farbe ein.

Die Seite Govee-Leuchten öffnen

Aktiviere „Govee-Leuchten aktivieren“, falls es deaktiviert ist. Unter „Deine Leuchten“ zeigt jede Leuchte „Nicht eingerichtet“, solange sie keine Belohnung hat.
Eine Leuchte auswählen

Wähle die Leuchte aus, die Zuschauer steuern sollen. Der Belohnungseditor öffnet sich.
Die Belohnung ausfüllen

Stelle den „Belohnungstitel“, die „Kosten (Punkte)“, die „Kachelfarbe“ und die „Abklingzeit“ (0 = aus) ein. Das Feld „Chat-Antwort“ ist optional.
Festlegen, was nach der Ausführung passiert

Wähle unter „Nach der Ausführung“ entweder „Als erfüllt markieren“, „Punkte zurückgeben“ oder „Einem Mod überlassen“.
Die Belohnung erstellen

Wähle „Belohnung erstellen“. Der Bot erstellt die Belohnung auf Twitch. Um sie später zu ändern, passe die Felder an und wähle „Änderungen speichern“.

Was Zuschauer eingeben

Wenn ein Zuschauer die Belohnung einlöst, gibt er eine Farbe ein. Ein englischer Farbname funktioniert, zum Beispiel blue. Ein Hex-Code funktioniert ebenfalls, etwa #00ccff. Wenn du „Zuschauer dürfen die Leuchte ausschalten“ aktivierst, kann ein Zuschauer off eingeben, um die Leuchte auszuschalten.

„Nur live“ ist standardmäßig aktiviert „Nur live“ bedeutet, dass Einlösungen nur funktionieren, wenn dein Stream live ist. Das wird empfohlen. Wenn du es deaktivierst, können Zuschauer die Leuchte auch ändern, während du offline bist.

05Wenn etwas schiefgeht

auf einen BlickDie Meldungen, die das Dashboard und der Chat für Govee-Leuchten anzeigen, und was du dagegen tun kannst.

In den Chatzeilen unten steht @viewer für den Namen des Zuschauers, der die Belohnung eingelöst hat. Jede Erstattungszeile bedeutet, dass der Bot die Punkte zurückgegeben hat.

Was du siehst	Was das bedeutet	Was du tun kannst
„Govee hat diesen Schlüssel nicht akzeptiert. Prüfe ihn und versuche es erneut.“	Govee hat den Schlüssel abgelehnt. Er wurde nicht gespeichert.	Kopiere den Schlüssel erneut aus der E-Mail von Govee, ohne Leerzeichen. Wenn du seitdem einen neueren Schlüssel angefordert hast, verwende den neuesten. Alte Schlüssel funktionieren nicht mehr, sobald du einen neuen erzeugst.
„Schlüssel gespeichert, aber Govee hat nicht geantwortet, daher ist er noch nicht geprüft. Deine Leuchten funktionieren, sobald Govee wieder erreichbar ist. Falls nicht, füge den Schlüssel erneut ein.“	Der Schlüssel ist gespeichert, aber Govee hat nicht geantwortet, als das Dashboard ihn prüfen wollte.	Mach weiter. Probiere die Belohnung etwas später aus. Ändern sich die Leuchten nicht, füge den Schlüssel erneut ein.
Der Schlüssel konnte nicht gespeichert werden.	Das Dashboard konnte den Schlüssel nicht speichern.	Versuche es gleich noch einmal.
„Govee akzeptiert diesen API-Schlüssel nicht mehr. Wähle Schlüssel entfernen und füge dann einen neuen Schlüssel aus der Govee Home-App ein.“	Der Schlüssel war gespeichert, aber Govee lehnt ihn jetzt ab. Eine mögliche Ursache ist ein neuerer Schlüssel auf demselben Konto, der die alten deaktiviert.	Wähle „Schlüssel entfernen“, fordere in der Govee Home-App einen neuen Schlüssel an und füge ihn ein.
„Deine Govee-Leuchten konnten nicht geladen werden. Prüfe deinen API-Schlüssel und versuche es erneut.“	Das Dashboard konnte deine Leuchtenliste nicht von Govee abrufen. Der Schlüssel ist vielleicht falsch, oder Govee hat nicht geantwortet.	Wähle „Erneut versuchen“. Schlägt es weiterhin fehl, wähle „Schlüssel entfernen“ und füge den Schlüssel erneut ein.
„Auf diesem Konto wurden keine Govee-Geräte gefunden.“	Govee hat für diesen Schlüssel keine Geräte zurückgegeben. Die Leuchten sind vielleicht nicht zu diesem Govee-Konto hinzugefügt oder nutzen nur Bluetooth.	Füge deine Leuchten in der Govee Home-App hinzu, verbinde sie mit dem WLAN und wähle dann „Leuchten aktualisieren“.
„Keine Govee-Leuchten mit Farbunterstützung auf diesem Konto gefunden.“	Govee hat Geräte zurückgegeben, aber keines kann die Farbe ändern. Nur Modelle mit Farbunterstützung erscheinen.	Füge deinem Govee-Konto in der Govee-App eine Leuchte mit Farbunterstützung hinzu und wähle dann „Leuchten aktualisieren“.
„Der Server konnte nicht erreicht werden. Versuche es gleich erneut.“	Das Dashboard konnte ItsBagelBot nicht erreichen.	Lade die Seite gleich erneut.
„Verbinde dich erneut, um Zugriff auf Kanalpunkte zu gewähren.“	Der Bot braucht Zugriff auf Kanalpunkte, um Belohnungen in deinem Twitch-Kanal zu erstellen.	Wähle „Erneut verbinden“ und erlaube den Zugriff bei Twitch.
Gib deinen Govee-API-Schlüssel ein.	Das Schlüsselfeld war beim Speichern leer.	Füge den Schlüssel aus der E-Mail von Govee ein und wähle dann erneut „Speichern und weiter“.
Gib einen Belohnungstitel ein.	Das Feld Belohnungstitel ist leer.	Gib einen Titel ein und speichere die Belohnung erneut.
Gib eine ganzzahlige Punktzahl von mindestens 1 ein.	Kosten (Punkte) ist keine ganze Zahl von mindestens 1.	Gib eine ganze Zahl ein, 1 oder mehr.
Gib eine Abklingzeit zwischen 0 Sekunden und 7 Tagen ein.	Die Abklingzeit liegt außerhalb des erlaubten Bereichs.	Gib eine Abklingzeit von 0 Sekunden (aus) bis zu 7 Tagen ein.
Govee-Leuchten konnten nicht umgeschaltet werden.	Der Schalter Govee-Leuchten aktivieren wurde nicht gespeichert.	Lade die Seite neu, prüfe den Schalter und versuche es erneut.
Der Schlüssel konnte nicht entfernt werden.	Der gespeicherte Schlüssel konnte nicht entfernt werden.	Warte einen Moment und wähle erneut „Schlüssel entfernen“.
„Die Belohnung konnte nicht gespeichert werden.“	Die Belohnung wurde nicht erstellt oder aktualisiert. Eine mögliche Ursache ist ein Kanal, der bei Twitch weder Affiliate- noch Partnerkanal ist, denn laut Dashboard erlaubt Twitch das nur diesen Kanälen.	Prüfe Titel und Kosten und versuche es erneut. Schlägt es weiterhin fehl, prüfe, ob dein Kanal bei Twitch Affiliate- oder Partnerkanal ist.
Die Belohnung konnte nicht gelöscht werden.	Die Belohnung konnte nicht gelöscht werden.	Warte einen Moment und versuche es erneut.
„@viewer die Leuchten ändern sich nur während eines Livestreams, deine Punkte wurden erstattet.“	Ein Zuschauer hat die Belohnung eingelöst, während du offline warst und „Nur live“ aktiviert ist.	Nichts. Starte deinen Livestream oder deaktiviere „Nur live“, wenn du auch offline Änderungen willst.
„@viewer diese Farbe wurde nicht erkannt, deine Punkte wurden erstattet. Versuch einen Namen wie blue oder einen Hex-Code wie #00ccff.“	Der Zuschauer hat etwas eingegeben, das weder ein bekannter Farbname noch ein Hex-Code ist.	Sag dem Zuschauer, dass er einen englischen Farbnamen wie blue oder einen Hex-Code wie #00ccff eingeben soll.
„@viewer die Leuchten sind noch nicht eingerichtet, deine Punkte wurden erstattet.“	Der Bot hat zum Zeitpunkt der Einlösung keine funktionierende Govee-Konfiguration für diese Leuchte gefunden.	Öffne die Seite Govee-Leuchten. Prüfe, ob „Schlüssel hinterlegt“ angezeigt wird und die Leuchte eine Belohnung hat.
„@viewer die Leuchten wechseln zu oft, deine Punkte wurden erstattet. Versuch es gleich noch einmal.“	Es kamen zu viele Farbwechsel gleichzeitig, deshalb hat der Bot diesen zurückgehalten.	Bitte den Zuschauer, es gleich noch einmal zu versuchen. Füge der Belohnung eine „Abklingzeit“ hinzu, um die Wechsel zu verteilen.
„@viewer die Leuchten sind nicht erreichbar, deine Punkte wurden erstattet.“	Govee oder die Leuchte hat nicht geantwortet.	Prüfe, ob die Leuchte in der Govee Home-App eingeschaltet und online ist. Versuche es dann erneut.

Geprüft am 12. Oktober 2026.