openclaw-homeassistant

What This Skill Does

The openclaw-homeassistant skill acts as a comprehensive bridge between your OpenClaw AI agent and your local Home Assistant installation. It enables you to orchestrate your entire smart home ecosystem through natural language. With support for 34 specialized tools, the agent can manipulate lights, climate controls, media players, and physical covers, as well as trigger custom automations and scripts. By leveraging the Home Assistant API, this skill provides real-time state feedback and granular control, allowing the agent to not just execute commands, but also query the environment, such as checking current sensor values or historical logs. Whether you need to adjust your living room temperature, dim the lights for a movie, or check if a door sensor was triggered while you were away, this skill provides a secure, domain-restricted interface for smart home management.

Installation

To integrate this skill, run the following command in your terminal: clawhub install openclaw/skills/skills/homeofe/openclaw-homeassistant

Once installed, you must configure the skill by providing your Home Assistant URL and a long-lived access token. The configuration also allows you to define allowedDomains to restrict the agent to specific device types and a readOnly boolean to prevent unintended state changes, adding an essential layer of security to your setup.

Use Cases

This skill is perfect for users who want a hands-free, intelligent home experience. Common use cases include setting up complex morning routines that trigger multiple lights and media players simultaneously, querying the status of various sensors, or managing home climate schedules dynamically based on current weather data rendered through Jinja2 templates. It is also highly effective for administrative tasks like monitoring system logs or executing specific home automations that may be difficult to reach through standard mobile dashboard interfaces.

Example Prompts

1. "Set the living room lights to 50% brightness and switch the thermostat to heating mode at 22 degrees."
2. "What is the current temperature in the bedroom, and are any windows or doors left open?"
3. "Run the 'Good Morning' automation and pause the media player in the office."

Tips & Limitations

For maximum security, always define your allowedDomains explicitly in the configuration; avoid allowing all domains if you only need control over lighting and switches. Be aware that the readOnly mode will block all state-changing commands, which is recommended during initial setup. Keep in mind that performance depends on the latency of your local network connection to the Home Assistant server. Always verify that your Home Assistant token has the appropriate permissions required for the domains you intend to control.