Does this integration work with Home Assistant Cloud?

Yes. You can use either a local Home Assistant URL or a Nabu Casa remote URL. Both work with the Long-Lived Access Token authentication method. If you use the remote URL, make sure your token has the necessary permissions for the entities you want to control.

Can my agent control devices when I am not actively chatting?

Yes. Once you set up automation triggers, those automations run inside Home Assistant itself. Your agent registers them during the initial conversation, and they persist independently. Your agent can also send proactive notifications through any connected channel when state changes occur.

What happens if Home Assistant goes offline?

Your agent will detect the connection drop and report it in the Logs tab. Commands sent while Home Assistant is offline will return an error message explaining the situation. Once Home Assistant comes back online, the WebSocket reconnects automatically and your agent resumes normal operation.

Smart Home

Home Assistant Integration: Smart Home Control

Link OpenClaw to your Home Assistant instance so you can control lights, locks, sensors, and automations through natural language commands in any connected channel.

Deploy OpenClaw See How It Works

What You Will Get

By the end of this guide, your OpenClaw agent will be connected to your Home Assistant instance and able to control every exposed device. You will send plain-language messages like "turn off the living room lights" or "what is the garage temperature" and get instant responses with real actions taken on your smart home.

The integration uses the Home Assistant REST API and WebSocket connection, which means your agent receives real-time state updates and can execute commands without delay. Entity discovery runs automatically, so every new device you add to Home Assistant becomes available to your agent within minutes.

Once configured, you can interact with your smart home from any channel your OpenClaw agent is connected to, whether that is a chat window on RunTheAgent, a messaging app, or a voice interface. You get a single conversational layer on top of your entire home.

Step-by-Step Setup

Follow these steps to connect Home Assistant to your running OpenClaw instance on RunTheAgent.

Open the Integrations Panel

Navigate to your agent dashboard on RunTheAgent and open the Integrations tab from the sidebar. This panel lists all available third-party services your agent can connect to. Scroll to the Smart Home section or use the search bar to find Home Assistant.

Enter Your Home Assistant URL and Token

Provide your Home Assistant instance URL, including the port if you use a non-standard one. Then paste a Long-Lived Access Token, which you can generate from your Home Assistant profile page under Security. This token allows your agent to authenticate API requests securely.

Run Entity Discovery

Click the Discover Entities button to pull all available devices and services from your Home Assistant. The agent will scan for lights, switches, sensors, climate controls, locks, covers, and media players. Review the discovered list and toggle off any entities you do not want the agent to control.

Map Friendly Names

Home Assistant entities often have technical IDs like light.kitchen_ceiling_1. Use the friendly name mapping to assign conversational labels such as "kitchen light" so your agent can understand natural commands. You can also group entities into rooms or zones for batch control.

Test Basic Commands

Open the chat window and try a few commands. Say "turn on the bedroom light" or "lock the front door" and verify that the correct entity responds. Check the Logs tab to see the API calls your agent made and confirm the state changes in Home Assistant.

Enable State Change Notifications

Turn on the WebSocket listener so your agent receives real-time updates when devices change state. This lets your agent proactively notify you, for example, if a door sensor triggers while you are away or if a smoke detector activates. Configure which entities send notifications in the alert settings.

Set Up Automation Triggers

Create agent-driven automations by defining trigger phrases or conditions. For example, you can tell your agent "when the temperature drops below 65, turn on the heater." The agent translates this into a Home Assistant automation and registers it on your behalf, so it runs even when you are not chatting.

Tips and Best Practices

Limit Entity Exposure

Only expose the entities your agent needs to control. Hiding unnecessary entities reduces confusion and speeds up command matching. You can always re-enable hidden entities later if your needs change.

Use Room Grouping for Batch Commands

Group entities by room so you can say "turn off everything in the kitchen" instead of naming each device. Room groups also make it easier to build scenes and routines that affect multiple devices at once.

Rotate Your Access Token Periodically

Long-Lived Access Tokens do not expire by default, so set a reminder to rotate them every few months. Revoking and regenerating a token takes only a minute in Home Assistant and keeps your integration secure.

Monitor the Connection Health Dashboard

RunTheAgent shows connection uptime and last-response timestamps for your Home Assistant link. Check this periodically to ensure the WebSocket stays connected and API calls are completing within expected latency.

Frequently Asked Questions

Smart Thermostat Control Lighting Scenes Control Energy Monitoring and Optimization

Ready to get started?

Deploy your own OpenClaw instance in under 60 seconds. No VPS, no Docker, no SSH. Just your personal AI assistant, ready to work.

Deploy OpenClaw View Pricing

Starting at $24.50/mo. Everything included. 3-day money-back guarantee.