6 мин чтения

01Что вам нужно

с первого взглядаАккаунт Govee Home, цветные лампы, настроенные в приложении Govee Home, и канал Twitch, который может создавать награды за баллы канала.

Используете ИИ-помощника? Дайте ему ai.itsbagelbot.com/govee/setup.md. Эта страница написана для помощников и использует точные названия кнопок.

Нужны аккаунт Govee Home и лампы Govee, уже настроенные в приложении Govee Home. Лампы, которые работают только по Bluetooth, могут не отображаться. Также нужен канал Twitch, который может создавать награды за баллы канала. На странице «Баллы канала» в панели управления указано, что Twitch разрешает это только компаньонам и партнёрам. Зрители тратят баллы канала, чтобы менять цвет ваших ламп.

На каждом шаге мастера настройки в панели управления есть кнопка «Попросить помощи у своего ИИ». Она копирует короткое сообщение с текущим шагом, чтобы ИИ-помощник мог прочитать это руководство и помочь вам. Никогда не вставляйте ключ API Govee в ИИ.

02Получите ключ API Govee

с первого взглядаКлюч выдаётся в приложении Govee Home и обычно приходит по электронной почте.

Открыть приложение Govee Home

Откройте приложение Govee Home на телефоне и войдите в аккаунт, которому принадлежат ваши лампы.
Перейти к форме ключа

Перейдите в Profile → Settings → «Apply for API Key». В некоторых версиях приложения этот пункт находится в разделе О приложении.
Заполнить короткую форму

Заполните короткую форму и отправьте её.
Дождаться письма

Govee обычно присылает ключ по электронной почте на адрес вашего аккаунта Govee. Если письма нет, проверьте папку «Спам», затем отправьте запрос ещё раз.

Новый ключ отключает старые Создание нового ключа в аккаунте Govee отключает все остальные активные ключи этого аккаунта. Если другой инструмент использует старый ключ, он перестанет работать. Запрашивайте новый ключ, только когда он действительно нужен.

03Подключите ключ в панели управления

с первого взглядаОткройте страницу «Освещение Govee». В первый раз четырёхшаговый мастер проведёт вас через настройку.

Откройте страницу Освещение Govee в панели управления. В мастере четыре шага: «Что вам нужно», «Получите ключ», «Вставьте ключ» и «Ваши лампы».

Запустить мастер

На шаге «Что вам нужно» выберите «Настроить Govee».
Проверить путь

На шаге «Получите ключ» панель управления показывает тот же путь, что описан выше, в разделе «В приложении Govee Home». Там же написано: «Новый ключ отключает все старые ключи вашего аккаунта Govee.» Выберите «У меня есть ключ», когда письмо придёт.
Вставить ключ

На шаге «Вставьте ключ» вставьте ключ из письма Govee в поле «Ключ API Govee». Ключ хранится в зашифрованном виде и больше не показывается.
Сохранить ключ

Выберите «Сохранить и продолжить». Панель управления сначала проверит ключ у Govee.
Посмотреть свои лампы

На шаге «Ваши лампы» панель управления покажет «Найдено ламп с поддержкой цвета» и их количество. Выберите «Настроить награды», чтобы продолжить.

При сохранении могут появиться два сообщения. Они означают разное:

«Govee не принял этот ключ. Проверьте его и повторите попытку.» Ключ не был сохранён. Вставьте его снова.
«Ключ сохранён, но Govee не ответил, поэтому ключ ещё не проверен. Ваши лампы заработают, когда Govee снова будет доступен. Если лампы не заработают, вставьте ключ ещё раз.» Ключ сохранён, и можно продолжать.

04Создать награду за баллы канала

с первого взглядаОдна награда на лампу. Зрители вводят цвет, когда активируют награду.

Открыть страницу «Освещение Govee»

Включите «Включить освещение Govee», если этот параметр выключен. В разделе «Ваши лампы» каждая лампа показывает «Не настроено», пока для неё нет награды.
Выбрать лампу

Выберите лампу, которой зрители смогут управлять. Откроется редактор награды.
Заполнить награду

Заполните «Название награды», «Стоимость (баллы)», «Цвет плитки» и «Задержка между получениями» (0 = отключено). Поле «Ответ в чате» необязательно.
Выбрать, что будет после выполнения

В разделе «После выполнения» выберите «Отметить как выполненную», «Вернуть баллы» или «Оставить модератору».
Создать награду

Выберите «Создать награду». Бот создаст награду в Twitch. Чтобы изменить её позже, поменяйте поля и выберите «Сохранить изменения».

Что пишут зрители

Когда зритель активирует награду, он вводит цвет. Английское название цвета работает, например blue. Шестнадцатеричный код тоже работает, например #00ccff. Если вы включите «Разрешить зрителям выключать лампу», зритель может ввести off, чтобы выключить лампу.

«Только во время трансляции» включено по умолчанию «Только во время трансляции» означает, что награду можно активировать только во время вашего стрима. Это рекомендуется. Если вы отключите эту опцию, зрители смогут менять свет и когда вы не в эфире.

05Если что-то пошло не так

с первого взглядаСообщения, которые панель управления и чат показывают для ламп Govee, и что с ними делать.

В строках чата ниже @viewer означает имя зрителя, который активировал награду. Каждая строка о возврате означает, что бот вернул баллы.

Что вы видите	Что это значит	Что делать
«Govee не принял этот ключ. Проверьте его и повторите попытку.»	Govee отклонил ключ. Ключ не был сохранён.	Скопируйте ключ из письма Govee ещё раз, без лишних пробелов. Если с тех пор вы запрашивали более новый ключ, используйте его. Старые ключи перестают работать, когда вы создаёте новый.
«Ключ сохранён, но Govee не ответил, поэтому ключ ещё не проверен. Ваши лампы заработают, когда Govee снова будет доступен. Если лампы не заработают, вставьте ключ ещё раз.»	Ключ сохранён, но Govee не ответил, когда панель управления его проверяла.	Продолжайте. Попробуйте награду чуть позже. Если лампы не меняют цвет, вставьте ключ ещё раз.
«Не удалось сохранить ключ.»	Панель управления не смогла сохранить ключ.	Попробуйте ещё раз через минуту.
«Govee больше не принимает этот ключ API. Выберите «Удалить ключ», затем вставьте новый ключ из приложения Govee Home.»	Ключ был сохранён, но Govee теперь его отклоняет. Одна из возможных причин: на том же аккаунте есть более новый ключ, который отключает старые.	Выберите «Удалить ключ», запросите новый ключ в приложении Govee Home и вставьте его.
«Не удалось загрузить ваши лампы Govee. Проверьте ключ API и попробуйте снова.»	Панель управления не смогла получить список ваших ламп от Govee. Возможно, ключ неверный или Govee не ответил.	Выберите «Повторить попытку». Если ошибка повторяется, выберите «Удалить ключ» и вставьте ключ ещё раз.
«На этом аккаунте не найдено устройств Govee.»	Govee не вернул ни одного устройства для этого ключа. Возможно, лампы не добавлены в этот аккаунт Govee или работают только по Bluetooth.	Добавьте лампы в приложении Govee Home, подключите их к Wi-Fi, затем выберите «Обновить список ламп».
«На этом аккаунте не найдено ламп Govee с поддержкой цвета.»	Govee вернул устройства, но ни одно из них не умеет менять цвет. Здесь показываются только модели с поддержкой цвета.	Добавьте лампу с поддержкой цвета в аккаунт Govee в приложении Govee, затем выберите «Обновить список ламп».
«Не удалось связаться с сервером. Попробуйте чуть позже.»	Панель управления не смогла связаться с ItsBagelBot.	Обновите страницу чуть позже.
«Подключитесь заново, чтобы предоставить доступ к баллам канала.»	Боту нужен доступ к баллам канала, чтобы создавать награды на вашем канале Twitch.	Выберите «Подключиться заново» и подтвердите доступ в Twitch.
Введите ключ API Govee.	При сохранении поле ключа было пустым.	Вставьте ключ из письма Govee, затем снова выберите «Сохранить и продолжить».
Введите название награды.	Поле Название награды пустое.	Введите название и снова сохраните награду.
Введите целое число баллов, не меньше 1.	Поле Стоимость (баллы) должно содержать целое число от 1 и выше.	Введите целое число, 1 или больше.
Введите задержку от 0 секунд до 7 дней.	Значение Задержка между получениями вне допустимого диапазона.	Введите задержку от 0 секунд (отключено) до 7 дней.
Не удалось переключить освещение Govee.	Переключатель Включить освещение Govee не сохранился.	Обновите страницу, проверьте переключатель и попробуйте снова.
Не удалось удалить ключ.	Сохранённый ключ не удалось удалить.	Подождите немного и снова выберите «Удалить ключ».
«Не удалось сохранить награду.»	Награда не создана и не обновлена. Одна из возможных причин: канал не является компаньоном или партнёром Twitch, а Twitch разрешает создавать награды за баллы канала только таким каналам.	Проверьте название и стоимость, затем попробуйте снова. Если ошибка повторяется, убедитесь, что ваш канал является компаньоном или партнёром Twitch.
Не удалось удалить награду.	Награду не удалось удалить.	Подождите немного и попробуйте снова.
«@viewer лампы меняют цвет только во время трансляции, баллы возвращены.»	Зритель активировал награду, пока вы были не в эфире, а «Только во время трансляции» включено.	Ничего не делать. Начните трансляцию или отключите «Только во время трансляции», если хотите менять свет и вне эфира.
«@viewer такой цвет не распознан, баллы возвращены. Попробуйте название, например blue, или HEX-код, например #00ccff.»	Зритель ввёл что-то, что не является известным названием цвета или HEX-кодом.	Скажите зрителю ввести название цвета на английском, например blue, или HEX-код, например #00ccff.
«@viewer лампы ещё не настроены, баллы возвращены.»	В момент активации награды бот не нашёл рабочей настройки Govee для этой лампы.	Откройте страницу «Освещение Govee». Убедитесь, что показывается «Ключ сохранён» и у лампы есть награда.
«@viewer лампы меняют цвет слишком часто, баллы возвращены. Попробуйте ещё раз через минуту.»	Слишком много смен цвета пришло одновременно, поэтому бот отклонил этот запрос и вернул баллы.	Попросите зрителя повторить попытку через минуту. Добавьте «Задержку между получениями» к награде, чтобы смены цвета шли реже.
«@viewer не удалось подключиться к лампам, баллы возвращены.»	Govee или лампа не ответили.	Проверьте, что лампа включена и в сети в приложении Govee Home. Затем попробуйте снова.

Проверено 12 октября 2026 г.