36eb4a7b3b
- New skills: clawddocs, claude-code-usage, summarize, homeassistant, humanizer, self-improving-agent - Add .learnings/ for self-improvement tracking - Document proaktive cron config (LRN-20260126-001) - Update USER.md: Löchgau as former residence - Update TOOLS.md: Peekaboo workaround - Memory files for 2026-01-25 and 2026-01-26
87 lines
2.3 KiB
Markdown
87 lines
2.3 KiB
Markdown
---
|
|
name: homeassistant
|
|
description: Control Home Assistant - smart plugs, lights, scenes, automations.
|
|
homepage: https://www.home-assistant.io/
|
|
metadata: {"clawdis":{"emoji":"🏠","requires":{"bins":["curl"],"env":["HA_TOKEN"]},"primaryEnv":"HA_TOKEN"}}
|
|
---
|
|
|
|
# Home Assistant
|
|
|
|
Control smart home devices via Home Assistant API.
|
|
|
|
## Setup
|
|
|
|
Set environment variables:
|
|
- `HA_URL`: Your Home Assistant URL (e.g., `http://192.168.1.100:8123`)
|
|
- `HA_TOKEN`: Long-lived access token (create in HA → Profile → Long-Lived Access Tokens)
|
|
|
|
## Quick Commands
|
|
|
|
### List entities by domain
|
|
```bash
|
|
curl -s "$HA_URL/api/states" -H "Authorization: Bearer $HA_TOKEN" | \
|
|
jq -r '.[] | select(.entity_id | startswith("switch.")) | .entity_id'
|
|
```
|
|
|
|
### Turn on/off
|
|
```bash
|
|
# Turn on
|
|
curl -s -X POST "$HA_URL/api/services/switch/turn_on" \
|
|
-H "Authorization: Bearer $HA_TOKEN" \
|
|
-H "Content-Type: application/json" \
|
|
-d '{"entity_id": "switch.office_lamp"}'
|
|
|
|
# Turn off
|
|
curl -s -X POST "$HA_URL/api/services/switch/turn_off" \
|
|
-H "Authorization: Bearer $HA_TOKEN" \
|
|
-H "Content-Type: application/json" \
|
|
-d '{"entity_id": "switch.office_lamp"}'
|
|
```
|
|
|
|
### Control lights
|
|
```bash
|
|
# Turn on with brightness
|
|
curl -s -X POST "$HA_URL/api/services/light/turn_on" \
|
|
-H "Authorization: Bearer $HA_TOKEN" \
|
|
-H "Content-Type: application/json" \
|
|
-d '{"entity_id": "light.living_room", "brightness_pct": 80}'
|
|
```
|
|
|
|
### Trigger scene
|
|
```bash
|
|
curl -s -X POST "$HA_URL/api/services/scene/turn_on" \
|
|
-H "Authorization: Bearer $HA_TOKEN" \
|
|
-H "Content-Type: application/json" \
|
|
-d '{"entity_id": "scene.movie_time"}'
|
|
```
|
|
|
|
### Call any service
|
|
```bash
|
|
curl -s -X POST "$HA_URL/api/services/{domain}/{service}" \
|
|
-H "Authorization: Bearer $HA_TOKEN" \
|
|
-H "Content-Type: application/json" \
|
|
-d '{"entity_id": "...", ...}'
|
|
```
|
|
|
|
### Get entity state
|
|
```bash
|
|
curl -s "$HA_URL/api/states/{entity_id}" -H "Authorization: Bearer $HA_TOKEN"
|
|
```
|
|
|
|
## Entity Domains
|
|
|
|
- `switch.*` — Smart plugs, generic switches
|
|
- `light.*` — Lights (Hue, LIFX, etc.)
|
|
- `scene.*` — Pre-configured scenes
|
|
- `automation.*` — Automations
|
|
- `climate.*` — Thermostats
|
|
- `cover.*` — Blinds, garage doors
|
|
- `media_player.*` — TVs, speakers
|
|
- `sensor.*` — Temperature, humidity, etc.
|
|
|
|
## Notes
|
|
|
|
- API returns JSON by default
|
|
- Long-lived tokens don't expire — store securely
|
|
- Test entity IDs with the list command first
|