Home Assistant CLI
Коннектор к Home Assistant: подключился → сделал → напечатал → вышел.
CLI: python ~/.claude/tools/ha_client.py <command>.
Когда использовать
- Прочитать/изменить состояние устройств в Home Assistant (свет, розетки, климат, сенсоры).
- Вызвать любой HA-сервис (
light.turn_on, climate.set_temperature, media_player.play_media...).
- Посмотреть историю состояний сенсора, live-поток событий, конфиг инстанса, комнаты/устройства.
HA vs Яндекс умный дом (отдельный навык под Яндекс (в пак не входит))
| Критерий |
Home Assistant (этот skill) |
Яндекс IoT (отдельный навык под Яндекс (в пак не входит)) |
| Где живёт |
Локально (свой сервер/RPi/Docker), работает без интернета |
Облако Яндекса |
| Устройства |
2000+ интеграций: Zigbee, Z-Wave, MQTT, ESPHome, Xiaomi, и Яндекс-устройства тоже подключаемы |
Только устройства, привязанные к аккаунту Яндекса |
| Автоматизации |
Полноценные (triggers/conditions/scripts), история, дашборды |
Сценарии Алисы, проще |
| Голос |
Опционально (в т.ч. проброс в Алису) |
Алиса нативно |
| Когда брать |
Нужен локальный контроль, не-Яндекс устройства, history/events, сложные автоматизации |
Устройства уже в Яндекс-экосистеме и нужен быстрый доступ/Алиса |
Если HA-инстанса нет, CLI при отсутствии кредов сам печатает, что настроить.
Установка / настройка
- Нужен работающий HA-инстанс (Home Assistant OS на RPi/mini-PC или Docker:
docker run -d --name homeassistant --network=host ghcr.io/home-assistant/home-assistant:stable).
- Токен: HA web UI → профиль (слева внизу) → вкладка Security → Long-lived access tokens → Create Token.
- Env-переменные в
~/.claude/.credentials.master.env (значения заполняет владелец):
HA_URL — базовый URL, например http://homeassistant.local:8123 или http://192.168.x.x:8123
HA_TOKEN — long-lived access token
- Зависимости:
requests (REST), websockets (events/areas/devices) — обе уже установлены локально (websockets 15.0.1).
Команды
| Команда |
Что делает |
API |
ping |
Жив ли API |
GET /api/ |
states [--domain light] |
Все состояния, фильтр по домену |
GET /api/states |
get <entity_id> |
Одна сущность + атрибуты |
GET /api/states/<id> |
call <domain> <service> [--entity id] [--data '{...}'] |
Любой сервис |
POST /api/services/<d>/<s> |
on <entity_id> / off <entity_id> / toggle <entity_id> |
Быстрые шорткаты |
homeassistant.turn_on/turn_off/toggle |
history <entity_id> [--hours 24] |
История состояний |
GET /api/history/period/<ts> |
events [--type state_changed] [--limit 50] |
Live-поток событий (WS), остановка по лимиту или Ctrl+C |
WS subscribe_events |
config |
Версия, локация, компоненты |
GET /api/config |
areas / devices |
Комнаты / устройства |
WS config/area_registry/list, config/device_registry/list — внутренний frontend-API, не гарантирован между версиями; CLI честно сообщит, если команда недоступна |
У каждой команды есть --json (машинный вывод) и --help.
Примеры
# Проверка связи
python ~/.claude/tools/ha_client.py ping
# Весь свет в доме
python ~/.claude/tools/ha_client.py states --domain light
# Включить свет на кухне на 50% яркости
python ~/.claude/tools/ha_client.py call light turn_on --entity light.kitchen --data '{"brightness_pct": 50}'
# Просто вкл/выкл/переключить
python ~/.claude/tools/ha_client.py on switch.heater
python ~/.claude/tools/ha_client.py toggle light.bedroom
# Температура за 12 часов
python ~/.claude/tools/ha_client.py history sensor.living_room_temperature --hours 12
# Следить за изменениями состояний (20 событий и выход)
python ~/.claude/tools/ha_client.py events --type state_changed --limit 20
# JSON для скриптов
python ~/.claude/tools/ha_client.py states --domain sensor --json
Гочи
- Креды не заданы → exit 2 + печать инструкции по настройке (не трейсбек). Так и задумано, пока HA-инстанса нет.
on/off/toggle идут через универсальный домен homeassistant.* — работают для light/switch/fan/media_player и т.п.; для доменных параметров (яркость, цвет, температура) — используй call с --data.
--data — строго JSON в одинарных кавычках снаружи (PowerShell: --data '{\"brightness\": 128}' или через Git Bash без экранирования).
history использует UTC-таймстамп в URL (закодированный +00:00) — окно задаётся --hours, не датами.
events без --type подписывается на ВСЕ события — на живом инстансе это шумно; обычно нужен --type state_changed.
areas/devices — WebSocket-команды внутреннего API реестров (их использует frontend HA). В официальной REST-документации их нет; стабильны годами, но формально «требуют проверки» на конкретной версии HA — при недоступности CLI сообщит об этом явно.
- 401 → токен отозван/невалиден: создать новый long-lived token; 404 на
get → сущности не существует (проверь states).
- POST
/api/services/... возвращает список состояний, изменившихся за время вызова — пустой список не значит «не сработало» (например, устройство уже было в целевом состоянии).
Чек-лист
1---2name: home-assistant-23description: "Умный дом Home Assistant через ha_client.py: состояния, сервисы, история, события. Триггеры: «включи свет через HA», «hass»."4metadata:5 source: https://skillmd.com/skills/jhamidun/home-assistant-26---78# Home Assistant CLI910Коннектор к Home Assistant: подключился → сделал → напечатал → вышел.11CLI: `python ~/.claude/tools/ha_client.py <command>`.1213## Когда использовать1415- Прочитать/изменить состояние устройств в Home Assistant (свет, розетки, климат, сенсоры).16- Вызвать любой HA-сервис (`light.turn_on`, `climate.set_temperature`, `media_player.play_media`...).17- Посмотреть историю состояний сенсора, live-поток событий, конфиг инстанса, комнаты/устройства.1819### HA vs Яндекс умный дом (отдельный навык под Яндекс (в пак не входит))2021| Критерий | Home Assistant (этот skill) | Яндекс IoT (отдельный навык под Яндекс (в пак не входит)) |22|----------|------------------------------|---------------------------|23| Где живёт | Локально (свой сервер/RPi/Docker), работает без интернета | Облако Яндекса |24| Устройства | 2000+ интеграций: Zigbee, Z-Wave, MQTT, ESPHome, Xiaomi, и Яндекс-устройства тоже подключаемы | Только устройства, привязанные к аккаунту Яндекса |25| Автоматизации | Полноценные (triggers/conditions/scripts), история, дашборды | Сценарии Алисы, проще |26| Голос | Опционально (в т.ч. проброс в Алису) | Алиса нативно |27| Когда брать | Нужен локальный контроль, не-Яндекс устройства, history/events, сложные автоматизации | Устройства уже в Яндекс-экосистеме и нужен быстрый доступ/Алиса |2829Если HA-инстанса нет, CLI при отсутствии кредов сам печатает, что настроить.3031## Установка / настройка32331. Нужен работающий HA-инстанс (Home Assistant OS на RPi/mini-PC или Docker:34 `docker run -d --name homeassistant --network=host ghcr.io/home-assistant/home-assistant:stable`).352. Токен: HA web UI → профиль (слева внизу) → вкладка Security → Long-lived access tokens → Create Token.363. Env-переменные в `~/.claude/.credentials.master.env` (значения заполняет владелец):37 - `HA_URL` — базовый URL, например `http://homeassistant.local:8123` или `http://192.168.x.x:8123`38 - `HA_TOKEN` — long-lived access token394. Зависимости: `requests` (REST), `websockets` (events/areas/devices) — обе уже установлены локально (websockets 15.0.1).4041## Команды4243| Команда | Что делает | API |44|---------|-----------|-----|45| `ping` | Жив ли API | `GET /api/` |46| `states [--domain light]` | Все состояния, фильтр по домену | `GET /api/states` |47| `get <entity_id>` | Одна сущность + атрибуты | `GET /api/states/<id>` |48| `call <domain> <service> [--entity id] [--data '{...}']` | Любой сервис | `POST /api/services/<d>/<s>` |49| `on <entity_id>` / `off <entity_id>` / `toggle <entity_id>` | Быстрые шорткаты | `homeassistant.turn_on/turn_off/toggle` |50| `history <entity_id> [--hours 24]` | История состояний | `GET /api/history/period/<ts>` |51| `events [--type state_changed] [--limit 50]` | Live-поток событий (WS), остановка по лимиту или Ctrl+C | WS `subscribe_events` |52| `config` | Версия, локация, компоненты | `GET /api/config` |53| `areas` / `devices` | Комнаты / устройства | WS `config/area_registry/list`, `config/device_registry/list` — **внутренний frontend-API**, не гарантирован между версиями; CLI честно сообщит, если команда недоступна |5455У каждой команды есть `--json` (машинный вывод) и `--help`.5657## Примеры5859```bash60# Проверка связи61python ~/.claude/tools/ha_client.py ping6263# Весь свет в доме64python ~/.claude/tools/ha_client.py states --domain light6566# Включить свет на кухне на 50% яркости67python ~/.claude/tools/ha_client.py call light turn_on --entity light.kitchen --data '{"brightness_pct": 50}'6869# Просто вкл/выкл/переключить70python ~/.claude/tools/ha_client.py on switch.heater71python ~/.claude/tools/ha_client.py toggle light.bedroom7273# Температура за 12 часов74python ~/.claude/tools/ha_client.py history sensor.living_room_temperature --hours 127576# Следить за изменениями состояний (20 событий и выход)77python ~/.claude/tools/ha_client.py events --type state_changed --limit 207879# JSON для скриптов80python ~/.claude/tools/ha_client.py states --domain sensor --json81```8283## Гочи8485- **Креды не заданы** → exit 2 + печать инструкции по настройке (не трейсбек). Так и задумано, пока HA-инстанса нет.86- `on`/`off`/`toggle` идут через универсальный домен `homeassistant.*` — работают для light/switch/fan/media_player и т.п.; для доменных параметров (яркость, цвет, температура) — используй `call` с `--data`.87- `--data` — строго JSON в одинарных кавычках снаружи (PowerShell: `--data '{\"brightness\": 128}'` или через Git Bash без экранирования).88- `history` использует UTC-таймстамп в URL (закодированный `+00:00`) — окно задаётся `--hours`, не датами.89- `events` без `--type` подписывается на ВСЕ события — на живом инстансе это шумно; обычно нужен `--type state_changed`.90- `areas`/`devices` — WebSocket-команды внутреннего API реестров (их использует frontend HA). В официальной REST-документации их нет; стабильны годами, но формально «требуют проверки» на конкретной версии HA — при недоступности CLI сообщит об этом явно.91- 401 → токен отозван/невалиден: создать новый long-lived token; 404 на `get` → сущности не существует (проверь `states`).92- POST `/api/services/...` возвращает список состояний, изменившихся **за время вызова** — пустой список не значит «не сработало» (например, устройство уже было в целевом состоянии).9394## Чек-лист9596- [ ] `HA_URL` + `HA_TOKEN` в `~/.claude/.credentials.master.env`97- [ ] `ping` отвечает `API running.`98- [ ] `states` показывает сущности → entity_id для дальнейших команд брать отсюда99- [ ] Перед `call` с нестандартным сервисом — проверить его существование в HA (Developer Tools → Services); CLI не валидирует имена сервисов100- [ ] Для скриптов/агентов — всегда `--json`