OpenClaw + Home Assistant

Prerequisites

• OpenClaw running (see our deployment guide)
• Home Assistant installed and running
• Network access between OpenClaw and Home Assistant

Step 1: Generate a Long-Lived Access Token

1. Open Home Assistant in your browser
2. Go to Profile (bottom left) → Security
3. Scroll to Long-Lived Access Tokens
4. Click Create Token
5. Name it "OpenClaw" and click OK
6. Copy the token immediately — it won't be shown again

Step 2: Find Your Home Assistant URL

Your Home Assistant URL depends on your setup:

Local network:

http://homeassistant.local:8123
http://192.168.1.XXX:8123

Remote access ( Nabu Casa):

https://your-subdomain.ui.nabu.casa

Self-hosted with SSL:

https://home.yourdomain.com

Configuration

Add the Home Assistant channel to your OpenClaw config:

# In your openclaw config
channels:
  homeassistant:
    enabled: true
    url: "http://homeassistant.local:8123"
    token: "YOUR_LONG_LIVED_ACCESS_TOKEN"

Or via environment variables in your docker-compose.yml:

environment:
  - HOMEASSISTANT_ENABLED=true
  - HOMEASSISTANT_URL=http://homeassistant.local:8123
  - HOMEASSISTANT_TOKEN=your_long_lived_token

Docker networking: If both run in Docker, use the container name or network alias instead of localhost.

Step 3: Restart OpenClaw

docker compose restart openclaw

Verification

Try asking OpenClaw to interact with Home Assistant:

"Turn on the living room lights"
"What's the temperature in the bedroom?"
"Show me all lights that are on"
"Trigger the 'Good Night' automation"
"Lock the front door"

Check logs for API calls:

docker compose logs -f openclaw | grep -i homeassistant

Common Issues

Connection refused: Ensure Home Assistant is running and accessible from the OpenClaw container. Check firewall rules and Docker networking.

Unauthorized: Verify your long-lived access token is correct. Regenerate if needed from Home Assistant profile settings.

Entity not found: Use exact entity IDs from Home Assistant (e.g., light.living_room). Check Developer Tools → States in HA.

Slow response: Home Assistant responds in milliseconds locally. Slow responses may indicate network issues or heavy automation load.