OpenClaw + Home Assistant: управление умным домом голосом и текстом
Представьте: вы пишете в Telegram «Выключи свет в спальне и поставь будильник на 7 утра» — и это происходит. Без специальных команд, без приложений. OpenClaw в связке с Home Assistant делает именно это: превращает естественный язык в действия умного дома. В этой статье разберём, как настроить интеграцию с нуля.
Зачем объединять OpenClaw и Home Assistant
Home Assistant — одна из самых популярных open-source платформ для умного дома. Она объединяет сотни устройств: лампочки, термостаты, розетки, камеры, датчики. Но у неё есть ограничение — управление через стандартный интерфейс требует понимания структуры системы.
OpenClaw убирает этот барьер. Агент принимает команды на естественном языке, разбирает намерение и отправляет нужные запросы к Home Assistant API. Вы не думаете про entity_id и сервисы — просто говорите что нужно.
Плюс: OpenClaw можно подключить к Telegram, голосовым интерфейсам или любому другому каналу. Умный дом становится доступен откуда угодно.
Требования
Перед настройкой убедитесь, что:
- Home Assistant версии 2024.1 или новее
- OpenClaw версии 2026.3 или новее
- Оба сервиса доступны в одной сети или через VPN
- У вас есть права администратора в Home Assistant для создания токена
Шаг 1. Создайте Long-Lived Access Token в Home Assistant
Long-Lived Access Token (LLAT) — это долгосрочный токен для API-доступа. Он безопаснее логина и пароля для автоматизированных систем.
- Откройте Home Assistant в браузере.
- Перейдите в Настройки → Профиль (иконка пользователя внизу слева).
- Прокрутите вниз до раздела «Долгосрочные токены доступа».
- Нажмите «Создать токен», задайте имя (например,
openclaw-integration). - Скопируйте токен — он показывается только один раз.
Никогда не публикуйте этот токен и не сохраняйте в публичных репозиториях.
Шаг 2. Настройте навык Home Assistant в OpenClaw
Создайте файл навыка или отредактируйте существующий конфиг. Укажите параметры подключения к Home Assistant:
skills:
home_assistant:
enabled: true
url: "http://192.168.1.100:8123"
token: "ваш_long_lived_access_token"
timeout: 10
Замените 192.168.1.100 на IP-адрес вашего сервера Home Assistant. Если Home Assistant доступен через домен — используйте его.
Шаг 3. Проверьте соединение
После сохранения конфига перезапустите OpenClaw и проверьте статус навыка:
openclaw skills status home_assistant
Если всё настроено правильно, увидите список доступных устройств и их текущее состояние.
Примеры команд: что умеет делать агент
Примеры реальных команд, которые OpenClaw понимает и выполняет через Home Assistant:
| Команда пользователя | Действие |
|---|---|
| «Выключи свет в спальне» | Вызов light.turn_off для спальни |
| «Какая температура на кухне?» | Чтение sensor.kitchen_temperature |
| «Поставь термостат на 22 градуса» | Вызов climate.set_temperature |
| «Закрой шторы в гостиной» | Вызов cover.close_cover |
| «Включи сцену “Вечер”» | Вызов scene.turn_on |
| «Поставь будильник на 7:00» | Создание автоматизации через automation |
Агент понимает контекст: если написать «стало холодно», он может сам предложить поднять температуру термостата.
Сценарии автоматизации
Управление через Telegram
Самый удобный сценарий для большинства пользователей. Настроив интеграцию OpenClaw с Telegram, вы получаете полноценный чат-интерфейс для управления домом прямо в мессенджере.
Схема: Telegram → OpenClaw → Home Assistant REST API → устройства.
Голосовое управление
OpenClaw можно подключить к голосовым ассистентам через bridge-интеграции. Работает с Apple HomeKit через HomeKit Bridge, Google Home через официальный integration, а также с голосовыми интерфейсами на основе Whisper (локальное распознавание речи).
Контекстные сценарии
Один из интересных сценариев: агент отслеживает несколько условий одновременно. Например, «когда я возвращаюсь домой после 21:00 — включи приглушённый свет и поставь тихую музыку». Это уже не просто автоматизация по таймеру, а поведенческий сценарий с пониманием контекста.
О создании подобных сценариев подробнее рассказано в разделе создание собственных навыков.
Интеграция с другими системами умного дома
Home Assistant хорошо покрывает большинство потребностей, но OpenClaw также совместим с другими системами:
| Система | Способ интеграции | Сложность |
|---|---|---|
| Home Assistant | REST API + LLAT | Низкая |
| MQTT | Прямая публикация в топики | Средняя |
| Apple HomeKit | Через HomeKit Bridge | Средняя |
| Google Home | Через Google Home API | Средняя |
| IFTTT | Webhooks | Низкая |
Безопасность: важные правила
Интеграция умного дома с AI-агентом требует особого внимания к безопасности.
Не открывайте Home Assistant напрямую в интернет. Если нужен удалённый доступ, используйте VPN или Tailscale. Home Assistant Nabu Casa (официальный облачный сервис) тоже безопасный вариант.
Используйте отдельный токен для OpenClaw. Если токен будет скомпрометирован, отзовите только его — не меняя пароль от всего аккаунта.
Ограничьте права токена. В Home Assistant 2024.1+ можно создавать токены с ограниченными правами — только на чтение или только на определённые устройства.
Логируйте все действия агента. Включите логирование в OpenClaw, чтобы видеть все команды, которые агент отправляет к Home Assistant.
Для запуска на сервере
OpenClaw для управления умным домом удобнее запускать на постоянно включённом устройстве — NAS, Raspberry Pi или небольшом VPS. Для VPS Timeweb Cloud предлагает тарифы от 200 рублей в месяц — этого достаточно для работы OpenClaw с Home Assistant.
Итог
OpenClaw + Home Assistant — это Natural Language Interface для вашего умного дома. Вместо изучения entity_id и сервисов вы просто пишете что хотите, а агент разбирается с деталями. Настройка занимает около 20 минут и не требует программирования. Главное — соблюдать правила безопасности: не открывать Home Assistant в интернет и использовать отдельные токены для каждой интеграции.