$cd ../integrations/
🏠 Smart Homev1.4+10 min setup
$ cat hass-integration.md

Home Assistant AI Integration

/** 'It's getting slightly chilly, maybe warm up the living room?' β€” executed contextually via your local Home Assistant instance. */

privacy_bridge.log

Local-First Privacy & Architecture

OpenClaw interfaces with Home Assistant via the Long-Lived Access Token (LLAT) over your local network. Unlike cloud-based assistants, your voice/text intent is processed locally or via encrypted VPC tunnels. We employ a 'Privacy-First' metadata layer that strips personal identifiers from device names before processing, ensuring your floor plan remains private while maintaining 100% control.

orchestration_engine.md

βš™οΈ Smart Home Workflow

1
Intent Mapping
OpenClaw maps natural language to HA services (light.turn_on, climate.set_temperature).
2
State Awareness
Real-time polling of entity states to prevent redundant commands (e.g., skip turning on already active lights).
3
Multi-Entity Orchestration
Execute complex scripts that bridge Zigbee, Z-Wave, and Wi-Fi devices in a single atomic action.
4
Energy Optimization
AI-driven logic for solar curtailment or shifting heavy loads (EV charging) to off-peak hours.
setup_auth.sh

βš™οΈ Step 1: Secure Token Generation

1.
Profile Settings
Navigate to your User Profile in the bottom left of the HA dashboard.
2.
Long-Lived Access Token
Scroll to the bottom, click 'Create Token', and copy the 200+ character string.

πŸ’‘# πŸ’‘ Pro Tip: Name your token 'OpenClaw-Prod' to easily audit AI-driven actions in HA logs.

config.yaml

βš™οΈ Step 2: OpenClaw Configuration

# openclaw/config.yaml
integrations:
homeassistant:
enabled: true
url: "http://homeassistant.local:8123"
token: "eyJhbGciOiJIUzI1NiI..."
exposed_domains: ["light", "switch", "climate", "lock"]

❓ FAQ

Q1. Does it require HACS?

No. OpenClaw connects via Home Assistant's REST API or WebSocket API. No custom components needed.

Q2. Can it create automations?

Yes. Ask OpenClaw to 'turn off all lights at midnight' and it creates the automation in Home Assistant for you.
← Back to Integrations