Как добавить Алису в Home Assistant: подключение и настройка

Голосовое управление устройствами из Home Assistant через Алису удобно: «Алиса, включи свет на кухне» — и лампа, подключённая к вашему серверу, реагирует. Но готовой кнопки «подключить» в самом Home Assistant нет. В этой статье разберём, как подключить Алису к Home Assistant: какие способы существуют, что нужно подготовить, как установить компонент Yandex Smart Home через HACS, добавить устройства в приложение Яндекса и что делать, если что-то не работает.

Перед началом важная оговорка: интерфейсы и Home Assistant, и приложения Яндекса, и сторонних компонентов меняются. Названия кнопок и пунктов могут отличаться от описанных. Опирайтесь на структуру действий и на актуальную документацию компонента.

1Кратко: как добавить Алису в Home Assistant

• Встроенной интеграции с Алисой нет. Для управления устройствами голосом ставится сторонний компонент Yandex Smart Home через HACS.
• Есть два способа подключения: через облачный сервис проекта (проще, не нужно открывать Home Assistant в интернет) и прямое, через собственный навык в «Яндекс Диалогах» (нужен внешний HTTPS-адрес).
• Порядок действий: установить компонент в HACS, перезапустить Home Assistant, добавить интеграцию, выбрать сущности, привязать навык в приложении «Дом с Алисой», обновить список устройств.
• Чтобы колонка Яндекс Станция говорила сообщения из Home Assistant и принимала команды от автоматизаций, нужен другой компонент — Yandex Station. Это обратное направление, и оно настраивается отдельно.
• Хорошо работают лампы, розетки, выключатели, климат и датчики. Критичные устройства вроде замков голосу лучше не отдавать.

2Как устроена связка Алисы и Home Assistant

Алиса управляет умным домом через платформу «Умный дом Яндекса». Чтобы устройства стороннего производителя там появились, нужен «навык» — поставщик устройств, к которому приложение обращается по интернету. Home Assistant сам по себе такого навыка не предоставляет, поэтому используется пользовательский (сторонний) компонент Yandex Smart Home, распространяемый через HACS. Он делает так, что выбранные вами сущности Home Assistant становятся видны в экосистеме Яндекса как умные устройства.

Цепочка выглядит так: вы говорите команду Алисе, голос обрабатывается в Яндексе, платформа «Умный дом» обращается к навыку, навык передаёт команду в ваш Home Assistant, а тот управляет устройством.

Важно понимать, что Home Assistant OS и Nabu Casa (платная облачная служба Home Assistant Cloud) сами по себе не дают интеграции с Алисой: у Nabu Casa есть готовые связки с Amazon Alexa и Google Assistant, но не с Яндексом. Для Алисы нужен отдельный компонент.

3Способы подключения

Документация компонента Yandex Smart Home описывает несколько схем подключения. Набор и названия вариантов могут меняться, поэтому проверяйте актуальную документацию проекта. Принцип такой:

Способ	Суть	Что нужно
Через облачный сервис проекта	Связь между Яндексом и вашим Home Assistant идёт через облако, которое поддерживает автор компонента. Домашний сервер сам подключается наружу	Интернет на стороне Home Assistant; открывать порты и настраивать внешний домен не нужно
Прямое подключение через собственный навык в «Яндекс Диалогах»	Вы создаёте частный навык умного дома в консоли разработчика Яндекса, и платформа обращается напрямую к вашему Home Assistant	Внешний адрес Home Assistant по HTTPS (свой домен, DuckDNS, Nabu Casa Remote UI или другой способ), создание навыка в «Яндекс Диалогах»

Для новичка проще облачный вариант: он не требует публиковать ваш Home Assistant в интернете. Прямой вариант выбирают тогда, когда нужна независимость от стороннего облака, и при этом требуется самостоятельно позаботиться о безопасном внешнем доступе (об этом отдельная статья про удалённый доступ).

Если вы используете Nabu Casa, его адрес удалённого доступа может служить внешним HTTPS-адресом для прямой схемы, но интеграцией с Алисой сама подписка от этого не становится.

Критерий	Облачное подключение	Прямое подключение
Внешний адрес и сертификат	Не нужны	Нужны: домен или иной HTTPS-адрес с доверенным сертификатом
Открытие Home Assistant в интернет	Нет	Да, это нужно сделать безопасно
Создание навыка в «Яндекс Диалогах»	Не нужно	Нужно, навык ваш собственный
Зависимость от стороннего сервиса	Есть: команды идут через облако проекта	Меньше: между Яндексом и вашим сервером нет посредника
Сложность	Ниже	Выше
Для кого	Большинство новичков	Те, у кого уже настроен безопасный внешний доступ

Тот же компонент умеет работать и с умным домом VK (платформа Маруси), но в этой статье мы описываем именно Яндекс. Актуальная версия компонента требует достаточно свежего Home Assistant: в документации на момент написания указан минимум 2024.9, поэтому перед установкой сверьтесь с требованиями проекта.

4Что понадобится

• работающий Home Assistant, доступный в локальной сети (http://homeassistant.local:8123);
• установленный HACS — магазин пользовательских интеграций (установка описана в инструкции по HACS);
• учётная запись Яндекса и приложение «Дом с Алисой» (в актуальных версиях может называться «Умный дом» или быть частью приложения Яндекса) на телефоне;
• колонка или устройство с Алисой, привязанное к тому же аккаунту, — например, умная колонка Яндекс Станция;
• для прямой схемы — доступ к «Яндекс Диалогам» и внешний HTTPS-адрес Home Assistant;
• понимание, какие именно устройства вы хотите отдать Алисе.

Доступ к сайту HACS и репозиториям GitHub, откуда ставится компонент, может зависеть от вашего провайдера и региона. Если страницы не открываются, учитывайте это заранее: в ряде случаев требуется VPN.

5Шаг 1. Установите компонент Yandex Smart Home через HACS

1. Откройте в боковом меню Home Assistant раздел HACS.
2. Перейдите в раздел интеграций и воспользуйтесь поиском: введите «Yandex Smart Home». Если компонента нет в списке по умолчанию, добавьте его как пользовательский репозиторий по адресу, указанному в документации проекта (меню в правом верхнем углу HACS → «Пользовательские репозитории», тип «Integration»).
3. Откройте найденный компонент и нажмите кнопку загрузки. Выберите последнюю версию.
4. После установки перезапустите Home Assistant: «Настройки» → «Система» → кнопка питания в правом верхнем углу → «Перезапустить Home Assistant». В старых версиях это было «Конфигурация» → «Управление сервером».

Не пропускайте перезапуск: без него интеграция не появится в списке.

6Шаг 2. Добавьте интеграцию

1. Откройте «Настройки» → «Устройства и службы» (в старых версиях «Конфигурация» → «Интеграции»).
2. Нажмите кнопку добавления интеграции и найдите «Yandex Smart Home».
3. Выберите способ подключения, который поддерживает ваша версия компонента. В мастере будут пояснения на экране.
4. Для облачного варианта вам покажут идентификатор подключения и пароль или ссылку, которые нужны на следующем шаге. Сохраните их, но не публикуйте.

Если вы выбираете прямое подключение, мастер потребует идентификаторы навыка и токены из консоли разработчика Яндекса. Конкретные поля и порядок действий приведены в документации компонента, они меняются, поэтому здесь мы их не дублируем.

7Шаг 3. Выберите, какие устройства отдать Алисе

По умолчанию в Яндекс лучше передавать не все сущности, а только нужные: лампы, выключатели, розетки, климат, шторы, датчики. Так вы избежите путаницы и не откроете лишнего. В зависимости от версии компонента фильтр настраивается из интерфейса интеграции либо через файл configuration.yaml. Принцип записи в YAML обычно такой:

yandex_smart_home:
  filter:
    include_entities:
      - light.kitchen
      - switch.socket_hall

Это лишь иллюстрация: точный синтаксис и доступные параметры сверяйте с документацией установленной версии. После изменения файла проверьте конфигурацию в «Инструментах разработчика» → «YAML» и перезагрузите конфигурацию или перезапустите систему.

Чтобы Алиса правильно понимала команды, дайте сущностям понятные имена и привяжите их к помещениям в Home Assistant. Названия вроде «Свет кухня» понятнее, чем технические идентификаторы. Если у устройства в приложении Яндекса и в Home Assistant разные названия, Алиса будет ориентироваться на приложение Яндекса.

8Шаг 4. Привяжите навык в приложении Яндекса

1. Откройте на телефоне приложение «Дом с Алисой» (или раздел умного дома в приложении Яндекса) под тем же аккаунтом, что и у колонки.
2. Нажмите добавление устройства и выберите добавление устройства стороннего производителя (в актуальных версиях пункт называется примерно «Устройство умного дома» → поиск по производителю; в старых было отдельное добавление через «Производитель»).
3. Найдите в списке навык Yandex Smart Home (его название зависит от схемы подключения: в облачном варианте это навык проекта, в прямом — ваш собственный).
4. Нажмите «Привязать к Яндексу» или аналогичную кнопку и авторизуйтесь: введите данные, которые вам показал мастер в Home Assistant.
5. После успешной привязки навык подтянет список устройств. Они появятся в приложении, и их можно распределить по комнатам.

Если в приложении есть кнопка «Обновить список устройств» или «Обновить навык», нажимайте её каждый раз, когда вы изменили выбор сущностей в Home Assistant.

9Шаг 5. Проверьте работу голосом

Попробуйте простые команды:

• «Алиса, включи свет на кухне»;
• «Алиса, выключи розетку в коридоре»;
• «Алиса, какая температура в спальне» — если есть подходящий датчик и он передан Яндексу.

Команды работают с названиями комнат и устройств так, как они заданы в приложении Яндекса. Если что-то не срабатывает, сначала проверьте управление из самого приложения «Дом с Алисой»: если оно не работает, проблема в связке навыка, а не в голосе.

10Яндекс Станция и Home Assistant: озвучивание и команды

Описанная схема управляет устройствами Home Assistant голосом через Алису. Но бывает и другая задача: управлять самой колонкой из Home Assistant. Например, заставить Яндекс Станцию озвучить сообщение, запустить музыку или выполнить команду Алисы по сигналу датчика. Для этого существует отдельный пользовательский компонент Yandex Station (автор — AlexxIT), который ставится через HACS так же, как и первый. Для голосового управления домом он не нужен, он решает другую задачу.

Задача	Yandex Smart Home	Yandex Station
Направление	От Алисы к Home Assistant: вы говорите, устройство выполняет	От Home Assistant к колонке: автоматизация говорит или запускает команду
Управление лампами, розетками, климатом голосом	Да	Нет
Озвучивание произвольного текста колонкой	Нет	Да
Управление воспроизведением на колонке из Home Assistant	Нет	Да, колонка появляется как медиаплеер
Нужна ли привязка навыка в приложении	Да	Нет, используется вход в аккаунт Яндекса

Как добавить Яндекс Станцию в Home Assistant

1. Установите компонент Yandex Station через HACS (поиск по названию или по автору) и перезапустите Home Assistant.
2. Откройте «Настройки» → «Устройства и службы», добавьте интеграцию Yandex Station и авторизуйтесь в аккаунте Яндекса. Доступные способы входа и их надёжность описаны в документации проекта; предпочитайте те, что помечены как стабильные.
3. Выберите свои колонки: они появятся как устройства с сущностями медиаплеера.
4. Проверьте управление: включите и поставьте на паузу воспроизведение с карточки колонки.

Часть функций работает локально, часть — через облако Яндекса, и набор зависит от модели колонки. Если Home Assistant работает в Docker или за NAT, автоматический поиск колонок по mDNS может не сработать: тогда задайте колонке статический адрес в настройках роутера и укажите его в параметрах компонента.

Пример: озвучить сообщение на колонке

action: media_player.play_media
target:
  entity_id: media_player.yandex_station_kuhnya
data:
  media_content_type: text
  media_content_id: Окно в спальне открыто, на улице дождь

Имя сущности подставьте своё: посмотрите его на странице устройства. Тип text для озвучивания описан в документации компонента, но возможности меняются от версии к версии, поэтому сверяйтесь с README проекта. Такое действие удобно вставлять в автоматизации: «в 7:30 в будни озвучить прогноз», «при протечке сказать на кухне».

Компонент умеет и отправлять колонке текстовые команды, как если бы вы сказали их Алисе, и получать события, например о произнесённой фразе. Подробные примеры и список ограничений собраны в документации, и они обновляются чаще, чем статьи.

Колонка с Zigbee и дубли устройств

Некоторые модели колонок Яндекса сами умеют подключать часть устройств (например, Zigbee-датчики) напрямую, без Home Assistant. Если у вас такая колонка, не дублируйте устройства: одно и то же устройство лучше держать в одной системе, иначе в приложении появятся два экземпляра и команды будут путаться.

11Какие устройства можно отдать Алисе

Платформа умного дома Яндекса оперирует типами устройств и свойствами. Компонент сопоставляет сущности Home Assistant с этими типами. Список поддерживаемого постоянно расширяется, поэтому ориентир такой: хорошо работают света (включая яркость и цвет, если устройство это поддерживает), розетки и выключатели, климат и термостаты, шторы и жалюзи, медиаплееры, датчики температуры, влажности, открытия и протечки, а также кнопки для сценариев. Сложные и нестандартные сущности могут отображаться частично. Полный перечень и рецепты для конкретных приборов ведут в документации компонента.

Сценарий	Что сказать Алисе	Что настроить в Home Assistant
Свет в комнате	«Включи свет в спальне»	Лампы в одной группе и назначенное помещение
Режим «Кино»	«Запусти сценарий Кино»	Сцена или скрипт, переданные Алисе
Температура	«Какая температура в детской»	Датчик температуры в фильтре сущностей
Уход из дома	«Запусти сценарий Ухожу»	Скрипт, выключающий свет и розетки

12Безопасность и приватность

• Передавайте Яндексу только нужные сущности. Не публикуйте замки, сигнализацию и устройства, неправильное срабатывание которых опасно, без осознанной необходимости.
• В облачном варианте команды проходят через стороннюю службу. Оцените, готовы ли вы с этим работать, и ознакомьтесь с условиями.
• В прямой схеме вам придётся открыть доступ к Home Assistant из интернета. Используйте HTTPS, сильный пароль и двухфакторную аутентификацию.
• Не показывайте токены, пароли и идентификаторы подключения на скриншотах и в публичных обсуждениях.
• Если вы подозреваете утечку данных подключения, смените пароль в настройках интеграции и перепривяжите навык.

13Типичные ошибки и проблемы

Проблема	Что проверить
Компонента Yandex Smart Home нет в списке интеграций	Убедитесь, что установка через HACS завершена и вы перезапустили Home Assistant. Очистите кэш браузера и обновите страницу
Не получается привязать навык в приложении	Проверьте, что вы вошли в правильный аккаунт Яндекса и вводите данные именно из мастера. Для прямой схемы убедитесь, что внешний HTTPS-адрес открывается извне
Устройства не появились в приложении	Проверьте фильтр сущностей, обновите список устройств в навыке и дождитесь синхронизации
Алиса отвечает, что устройство недоступно	Проверьте, что Home Assistant включён, у него есть интернет, а само устройство работает в Home Assistant
Алиса путает названия	Дайте уникальные, короткие имена устройствам, избегайте повторяющихся слов и привяжите их к комнатам
Перестало работать после обновления	Обновите компонент в HACS до актуальной версии и прочитайте примечания к релизу в документации проекта. Обновление самого Home Assistant иногда требует обновить и сторонние компоненты
Доступ к HACS или GitHub нестабилен	Проблема на уровне сети; в некоторых случаях доступ зависит от провайдера и может потребовать VPN
Компонент не устанавливается или требует более свежую версию	Проверьте минимальную версию Home Assistant в документации компонента и обновите систему, если нужно
Колонка Yandex Station не находится в Home Assistant	Проверьте, что колонка и Home Assistant в одной подсети, задайте колонке статический адрес и посмотрите журнал компонента; в Docker и за NAT автопоиск по mDNS часто не работает
Привязка навыка вдруг слетела	Отвяжите и привяжите навык заново, обновите список устройств, проверьте срок действия сертификата при прямой схеме
Сертификат не принимается при прямом подключении	Нужен корректный сертификат от доверенного центра сертификации; самоподписанные сертификаты платформа Яндекса обычно не принимает

14Что ещё можно сделать

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

15Практические советы по сценариям и именам

Чтобы управление голосом было приятным, стоит подготовить Home Assistant заранее. Несколько практических приёмов:

• Короткие имена. Алиса лучше понимает короткие и различимые названия: «люстра», «торшер», «ночник». Избегайте похожих имён вроде «Свет 1» и «Свет 2».
• Комнаты. Назначайте комнаты и в Home Assistant, и в приложении Яндекса. Тогда фраза «Алиса, включи свет в спальне» запустит все лампы комнаты, если они добавлены в группу.
• Группы. Если у вас несколько ламп в одной комнате, создайте группу в Home Assistant и передайте Алисе её. Так команда выполняется одной сущностью, а не серией отдельных вызовов.
• Сценарии. Сцены и скрипты удобно превращать в короткие фразы: «Алиса, включи режим кино». В приложении Яндекса также можно создавать собственные сценарии с условиями по голосовой фразе.
• Датчики. Для температуры, влажности и протечек Яндекс предусматривает отдельные типы устройств. Если компонент поддерживает ваш тип датчика, он отобразится в приложении и будет доступен голосом.

Как проверить, что команда дошла до Home Assistant

Откройте в Home Assistant журнал событий или карточку «Журнал» и выполните голосовую команду. Если состояние сущности изменилось, значит, цепочка работает. Если команда не доходит, смотрите журнал ошибок в «Настройки» → «Система» → «Журналы»: там обычно видны сообщения компонента с причиной (например, ошибка авторизации или недоступность адреса).

Что делать при смене пароля или адреса

Если вы меняли внешний адрес Home Assistant, обновляли сертификат или перенастраивали интеграцию, перепривяжите навык: отвяжите его в приложении Яндекса, выполните привязку заново и обновите список устройств. Это самый частый способ починить «внезапно» перестающую работать связку.

Ограничения, о которых стоит знать

Не все типы сущностей Home Assistant имеют аналог в платформе умного дома Яндекса. Нестандартные устройства (например, сложные климатические системы или кастомные сущности) могут отображаться частично или не отображаться вовсе. Кроме того, задержка между командой и реакцией зависит от скорости интернета и загрузки облачных служб. Для критичных сценариев (безопасность, отопление) не полагайтесь только на голосовое управление и оставьте надёжные автоматизации внутри Home Assistant.

16Итог

Чтобы подключить Алису к Home Assistant, нужен сторонний компонент Yandex Smart Home, который ставится через HACS. Для старта выберите облачную схему, добавьте интеграцию в «Настройки» → «Устройства и службы», отфильтруйте сущности, привяжите навык в приложении «Дом с Алисой» и проверьте команды голосом. Помните, что интерфейсы меняются: сверяйтесь с актуальной документацией компонента, не отдавайте Алисе критичные устройства без необходимости и следите за безопасностью внешнего доступа.