homeassistant-assist

What This Skill Does

The homeassistant-assist skill integrates your OpenClaw agent directly with Home Assistant’s Assist (Conversation) API. By acting as a bridge, this skill allows the agent to process natural language commands to control your smart home ecosystem. Rather than requiring complex configurations for every individual device or entity, this skill leverages Home Assistant’s native, powerful intent recognition and fuzzy matching capabilities. It is a 'fire and forget' solution: you provide the request, the agent passes it to your server, and the agent relays the status response back to you. This ensures that as your home configuration evolves—adding new lights, climate controls, or media players—your agent is always capable of handling those devices without requiring updates to the skill itself.

Installation

Installation is streamlined through the ClawHub platform. Execute clawhub install openclaw/skills/skills/dexiaong/homeassistant-assistqp to fetch the source code. Once installed, ensure you have a Home Assistant long-lived access token generated via your Profile page. You must configure the OpenClaw environment by setting your HASS_SERVER URL and your HASS_TOKEN within the agent's configuration JSON. Once these environment variables are active, the agent gains immediate authorized access to your smart home environment.

Use Cases

This skill is perfect for users who want to centralize their home management within their AI agent. Common use cases include controlling lighting states (dimming, turning off), adjusting HVAC systems (thermostat control), managing security entities (locks, covers), or triggering automations. Because it interprets natural language, it is highly effective for compound requests like 'Turn off the living room lights and set the thermostat to 72 degrees,' which Home Assistant handles seamlessly.

Example Prompts

1. 'Hey, can you turn off all the lights in the basement and lock the front door?'
2. 'Set the kitchen thermostat to 70 degrees.'
3. 'What is the current status of the garage door?'

Tips & Limitations

To get the most out of this skill, ensure your Home Assistant entity names are descriptive and include aliases where necessary. If the agent returns an error, it is almost always an issue with device naming in the Home Assistant dashboard rather than a failure of the agent itself. Remember, the agent cannot troubleshoot hardware connectivity; it strictly manages communication with the HA API. Use unique, identifiable names for all devices to avoid ambiguity and ensure the most accurate response from Assist.