Home Assistant Integration v2.1 — OpenClaw Skill

Control and query your Home Assistant smart home in plain English through Telegram or any OpenClaw channel.

Setup

1. Create a Home Assistant Long-Lived Token

In Home Assistant: Profile (bottom-left) → Security → Long-Lived Access Tokens → Create Token

Copy the token immediately — it is only shown once.

2. Add credentials to openclaw.json

json { "env": { "HOME_ASSISTANT_URL": "http://homeassistant.local:8123", "HOME_ASSISTANT_TOKEN": "your-long-lived-token-here" } }

Using HTTPS with a self-signed certificate? Also add:

json "HOME_ASSISTANT_SSL_VERIFY": "false"

3. Restart OpenClaw

\bash sudo systemctl restart openclaw

4. Test

Send your bot: home summary

Security Notes

• Connects only to your configured HOME_ASSISTANT_URL — no third-party calls
• Create a dedicated HA user with only the permissions your agent needs
• Store credentials in openclaw.json with restricted permissions (chmod 600)
• Prefer HOME_ASSISTANT_CA_CERT over HOME_ASSISTANT_SSL_VERIFY=false for HTTPS

What You Can Ask

Available Operations

The skill provides 15 Python snippets executed via the OpenClaw exec tool:

• _load_config — loads credentials from environment (always runs first)
• check_api — tests HA connectivity
• ha_summary_for_telegram — full home summary
• get_temperature_sensors — all temperature sensors
• get_lights — lights with brightness levels
• get_switches — all switches with state
• get_climate — thermostat/climate status
• call_service — control any HA device/service
• search_entities — find entities by keyword
• get_cameras — camera list with snapshot URLs
• camera_snapshot — download camera image
• get_automations — all automations with last-triggered
• rigger_automation — fire a specific automation
• get_energy — energy and power sensors
• send_notification — send via HA notify service

Skill File

The full skill implementation is in home_assistant.json in this directory. It contains all 15 snippets as Python code that the agent executes via the Home Assistant REST API (/api/states, /api/services/*).

Troubleshooting

HOME_ASSISTANT_TOKEN not configured Check the HOME_ASSISTANT_TOKEN in your openclaw.json env block and restart OpenClaw.

401 Unauthorized Token expired. Regenerate: HA → Profile → Security → Long-Lived Access Tokens.

SSL certificate verify failed Add "HOME_ASSISTANT_SSL_VERIFY": "false" to your openclaw.json env block.

Connection refused Check HOME_ASSISTANT_URL is correct and HA is running.