home-assistant

What This Skill Does

The home-assistant skill provides OpenClaw with the capability to interface directly with your Home Assistant instance. By leveraging Home Assistant's robust REST API and webhook system, this skill allows the agent to act as a central controller for your smart home ecosystem. It supports bidirectional communication, meaning the AI can execute commands to manipulate smart devices and react to events triggered by Home Assistant automations. Whether you are adjusting climate settings, toggling light switches, triggering complex scenes, or executing scripts, this skill bridges the gap between AI intelligence and physical home automation.

Installation

To begin, ensure you have a long-lived access token generated from your Home Assistant profile. You can configure the skill using one of two methods. For persistent environments, create a config file at ~/.config/home-assistant/config.json containing your URL and token. Alternatively, export your credentials as environment variables HA_URL and HA_TOKEN. Once configured, you can utilize the clawhub command to install the integration, ensuring the agent has the necessary permissions to communicate with your specific local network address.

Use Cases

This skill is perfect for users who want to move beyond simple voice commands. You can automate your morning routine by asking the agent to trigger a 'Good Morning' script which adjusts the thermostat, starts the coffee maker, and turns on bedroom lights. It is also excellent for security and convenience; use it to query the current status of all sensors or to perform batch actions, such as shutting down all household devices when you leave for work. The webhook support allows for sophisticated event-driven behavior, letting your agent react to physical motion or door sensors in real-time.

Example Prompts

1. "OpenClaw, please turn on the living room lights and set the brightness to 50 percent."
2. "Check the status of the garage door, and if it's open, send a notification and close it."
3. "Run my 'Movie Night' scene in the basement and set the thermostat to 72 degrees."

Tips & Limitations

Always ensure your Home Assistant instance is reachable from the network where OpenClaw is running. While this skill is powerful, it is restricted by the permissions of the token used; verify that the token has enough scopes to perform the requested actions. Avoid placing sensitive credentials in version-controlled files. For complex automations, keep your logic inside Home Assistant whenever possible, using this skill primarily for high-level orchestration.