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

`ash

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.