Home Assistant

OpenClaw Home Assistant Integration

Control your entire smart home through natural language. OpenClaw connects to Home Assistant's REST API so you can ask questions about your home state and trigger automations just by talking to your assistant.

Requirements

• Home Assistant running on your local network (or remotely accessible)
• Long-lived access token from Home Assistant
• OpenClaw on same network (or with remote access configured)

Setup

Step 1: Get a Long-Lived Access Token

1. In Home Assistant → Profile (bottom left)
2. Scroll to Long-Lived Access Tokens
3. Click "Create Token"
4. Name it "OpenClaw" → copy the token

Step 2: Get Your Home Assistant URL

Your HA URL is typically:

• Local: http://homeassistant.local:8123
• Remote: https://your-instance.duckdns.org

Step 3: Configure OpenClaw

integrations:  homeAssistant:    enabled: true    url: "http://homeassistant.local:8123"    token: "your-long-lived-access-token"    # Optional: only expose certain domains    allowedDomains:      - light      - switch      - climate      - sensor      - automation

Step 4: Test the Connection

openclaw test integration home-assistant

Natural Language Control

Turn on the living room lights→ living_room_light turned on ✓Set bedroom temperature to 68°F→ Thermostat set to 68°F ✓Is the front door locked?→ Yes, front_door_lock is locked (last changed 3h ago)What's the temperature outside?→ Weather station reads 72°F, humidity 45%Run the "Movie Night" scene→ Automation triggered ✓

State Monitoring

Ask about any sensor in your home:

Are any windows open?→ 2 windows open: Kitchen window, Bedroom windowWhat's the air quality?→ Living room CO2: 842 ppm (slightly elevated)Did anyone arrive home?→ person.john arrived at 6:32 PM

Automations

Trigger existing Home Assistant automations:

Start the morning routine→ Running automation: morning_routine ✓

Or create new automations through conversation (requires automation domain access).

Cron-Based Smart Home

Combine with OpenClaw's cron system:

crons:  - name: "Evening check"    schedule: "0 21 * * *"    action: "Check all doors locked and report to Telegram"

Every evening at 9pm, your assistant checks security state and sends a report.

Troubleshooting

Connection refused? Verify HA is accessible from where OpenClaw runs. Check URL and port (8123 default).

401 Unauthorized? Token may have expired. Generate a new long-lived token in HA profile.

Entity not found? Entity IDs are case-sensitive. Use HA's developer tools to find exact IDs.

Privacy

All communication happens on your local network (unless HA is remote). No smart home data leaves your home unless you explicitly enable it.