home-assistant

What This Skill Does

The Home Assistant skill empowers your OpenClaw AI agent to act as a central controller for your entire smart home ecosystem. By leveraging the Home Assistant REST API, this skill allows the agent to monitor device states, toggle switches, manage climate settings, and trigger complex automations or scenes. It essentially provides a bridge between your agent's decision-making capabilities and your physical environment. Whether you need to dim the lights for a focus session, check if your garage door is closed, or activate a "Goodnight" script, the agent can interpret natural language commands and execute the corresponding API calls directly.

Installation

Installation is straightforward. First, ensure your Home Assistant instance is running and reachable via a URL. You will need a Long-Lived Access Token, which can be generated in your Home Assistant Profile under the Security section. You can configure the skill using a configuration file located at ~/.config/home-assistant/config.json by providing the "url" and "token" keys, or alternatively, by setting the HA_URL and HA_TOKEN environment variables on your system. Once configured, simply use the clawhub install command to integrate the skill into your OpenClaw environment.

Use Cases

• Home Automation Control: Seamlessly turn off all lights when you leave for work or set the thermostat to a specific temperature before you arrive home.
• Scene Activation: Trigger "Movie Night" or "Dinner Party" scenes that coordinate multiple lights, blinds, and media players simultaneously.
• Status Monitoring: Ask your agent about the current state of devices, such as inquiring whether the front door is locked or verifying if the washing machine has finished its cycle.
• Integrated Workflows: Use Home Assistant webhooks to have your home devices trigger agent responses, such as performing a specific task when a motion sensor detects your presence.

Example Prompts

1. "OpenClaw, dim the living room lights to 30 percent and turn on the television."
2. "Check if the front door is locked and lock it for me if it's currently open."
3. "Run the 'Goodnight' routine, which turns off all lights and sets the thermostat to 68 degrees."

Tips & Limitations

To ensure peak reliability, keep your Home Assistant instance updated and ensure the agent has a stable network connection to the server. Note that the agent can only control devices that are explicitly exposed to Home Assistant. Always test your automation triggers in the Home Assistant dashboard before relying on them for critical security tasks. Be mindful that rapid, repeated API calls may occasionally be throttled if your Home Assistant instance is under heavy local load.