A powerful bridge for controlling Home Assistant smart home devices and managing automated workflows via REST API and bidirectional webhooks.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install home-assistant
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install home-assistant using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Home Assistant?
The Home Assistant skill enables seamless integration between your AI agent and your smart home ecosystem. By leveraging Openclaw Skills, developers can programmatically control a vast array of devices, from lighting and climate to security systems and media players. This skill provides a bridge that allows your agent to not only pull real-time state data from entities but also push commands and respond to event-driven triggers coming directly from your Home Assistant instance.
Built with developer experience in mind, it utilizes the Home Assistant REST API for outbound actions and supports inbound webhooks for reactive workflows. Whether you are building a personal dashboard or an autonomous agent that manages your environment, this skill provides the necessary connectivity and command-line tools to make smart home management effortless.
Home Assistant Use Cases
- Automating home office lighting and climate based on calendar events or work status.
- Creating voice-activated or text-driven scenes that combine multiple device states for specific activities.
- Receiving real-time notifications and taking automated actions when sensors like motion or moisture are triggered.
- Monitoring energy usage or device states through simple CLI commands or agent queries.
How Home Assistant Works
- The skill authenticates with your Home Assistant instance using a Long-Lived Access Token for secure communication.
- It interfaces with the Home Assistant REST API to query entity states or invoke specific services such as light.turn_on or climate.set_temperature.
- For outbound control, the agent sends POST requests with JSON payloads to the appropriate Home Assistant service endpoints.
- For inbound events, Home Assistant can be configured to send webhooks to a designated URL, allowing Openclaw Skills to react to home events instantly.
- A dedicated CLI wrapper provides a simplified interface for manual testing and quick interaction with the smart home environment.
Home Assistant Setup
To get started with this integration, ensure you have jq and curl installed. You can configure the skill using one of the following methods:
Option 1: Config File (Recommended)
Create a configuration file at ~/.config/home-assistant/config.json:
{
"url": "https://your-ha-instance.duckdns.org",
"token": "your-long-lived-access-token"
}
Option 2: Environment Variables
Alternatively, export the following variables in your shell:
export HA_URL="http://homeassistant.local:8123"
export HA_TOKEN="your-long-lived-access-token"
You must generate a Long-Lived Access Token from your Home Assistant profile under the "Long-Lived Access Tokens" section.
Home Assistant Data Schema & Taxonomy
The skill interacts with the Home Assistant entity-based data model using JSON. Below is the primary taxonomy used for data exchange:
| Component | Description | Example |
|---|---|---|
| entity_id | Unique identifier for a device or service. | light.living_room |
| domain | The category of the entity. | light, switch, climate |
| state | The current status of the entity. | on, off, unavailable |
| attributes | Metadata associated with the entity. | brightness, temperature, unit_of_measurement |
| services | Executable actions available for a domain. | turn_on, trigger, set_temperature |
Home Assistant Advanced Features
- Bidirectional Webhook Support: Enable Home Assistant to trigger agent-side logic through rest_command actions.
- Comprehensive CLI Wrapper: Use the
ha.shscript to list, search, and control entities directly from your terminal. - Service Domain Support: Fully compatible with diverse domains including cover, media_player, scene, and script.
- Detailed State Inspection: Access full entity attributes for precision automation, such as specific brightness levels (0-255) or HVAC modes.
SKILL.md
Loading
Related Openclaw Skills
Domainion Ops
A unified interface for automating domain registration, DNS records, and nameserver management across multiple providers.
OpenFishy Feed Publisher
A powerful automation tool for generating high-quality AI visual media and publishing it directly to the OpenFishy feed platform.
Edge-TTS Skill
A high-quality neural text-to-speech engine leveraging Microsoft Edge's service to provide realistic voice synthesis without an API key.
OpenClaw Chrome Relay Helper - Mac
A specialized macOS tool to reliably attach the OpenClaw Browser Relay extension to Chrome for seamless browser automation.
Sentry CLI
A comprehensive command-line interface for managing Sentry.io error monitoring, release workflows, and debug artifact uploads.
X Bookmark Archiver
An automated pipeline to transform X bookmarks into a searchable Markdown knowledge base using AI-powered categorization and summarization.
Featured*
