home-assistant
Control Home Assistant devices and automations via hass-cli. Use when controlling smart home devices, lights, switches, sensors, climate, media players, or running automations/scripts. Requires HASS_SERVER and HASS_TOKEN environment variables.
Why use this skill?
Control your smart home with OpenClaw. Integrate Home Assistant to manage lights, climate, scripts, and devices using simple natural language commands.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/ericarnoldy/hass-cliWhat This Skill Does
The home-assistant skill provides OpenClaw with a powerful bridge to your smart home environment. By leveraging the hass-cli tool, this skill allows the agent to query the status of connected devices, toggle switches, adjust climate controls, trigger custom automations, and manage media players. It acts as an abstraction layer between your natural language requests and the Home Assistant API, making your home truly responsive to voice or text commands without manual dashboard navigation.
Installation
To get started, first ensure hass-cli is installed via Homebrew (brew install homeassistant-cli) or pip install homeassistant-cli. Once installed, you must authenticate the agent by generating a Long-Lived Access Token in your Home Assistant user profile. Set these as environment variables (HASS_SERVER and HASS_TOKEN) in your system profile or include them in your local TOOLS.md file so the agent can securely reach your home automation instance. Use the command clawhub install openclaw/skills/skills/ericarnoldy/hass-cli to integrate this skill directly into your agent environment.
Use Cases
This skill is ideal for users who want to control their environment programmatically. Common use cases include setting specific lighting scenes for "movie mode," adjusting home climate based on sensor data, automating morning routines by triggering a series of scripts, or monitoring binary sensors like door/window contacts or motion detectors to provide the agent with situational awareness. It is particularly useful for developers building complex event-driven home automations that go beyond the standard UI.
Example Prompts
- "Turn off all the lights in the kitchen and set the fireplace switch to active."
- "Check the current temperature on the thermostat and adjust it to 72 degrees if it's lower than 68."
- "Run my movie mode script and ensure the living room media player is ready for playback."
Tips & Limitations
Always ensure your entity IDs are correctly identified; use hass-cli state list to confirm exact naming patterns (e.g., light.kitchen_main) before executing sensitive commands. Be aware that the skill relies on a stable network connection to your Home Assistant server. If you use a remote tunnel like Nabu Casa, ensure your latency is low for the best response time. Finally, treat your HASS_TOKEN with care, as it provides full access to your smart home controls; never expose this token in public repositories.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-ericarnoldy-hass-cli": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: network-access, external-api