A comprehensive SSH-based toolkit for managing Home Assistant instances, providing deep access to configurations, automations, and system health.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install home-assistant-toolkit
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-toolkit 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 Expert Skill?
The Home Assistant Expert Skill is a powerful extension designed for Openclaw Skills that transforms your AI agent into a senior smart home administrator. By leveraging SSH and the Home Assistant REST API, this skill provides granular control over your instance, including configuration file editing, logs monitoring, and HACS management. Unlike basic integrations, this tool is version-aware, dynamically fetching release notes and scanning your specific integrations to provide context-accurate troubleshooting and configuration advice.
Built for power users and developers, this skill ensures that every YAML change is validated before application, significantly reducing the risk of a broken configuration. Whether you are managing complex Jinja2 templates, setting up ESPHome devices, or generating entire dashboard views, this skill provides the professional CLI-driven workflow required for a robust smart home ecosystem.
Home Assistant Expert Skill Use Cases
- Automating YAML configuration updates with integrated validation and rollback protection.
- Monitoring system health to identify offline devices, low battery sensors, and stale integrations.
- Managing system-wide backups and HACS updates through a unified interface.
- Generating tailored dashboard YAML views based on discovered entities and room groupings.
- Troubleshooting breaking changes by comparing current instance state against dynamic release notes.
How Home Assistant Expert Skill Works
- The skill establishes a secure SSH connection to the Home Assistant Terminal & SSH add-on.
- It performs an initial system scan to identify the core version, installed HACS components, and active integrations.
- User-specific documentation and state data are cached locally in the references directory to provide version-relative context.
- Commands are executed via specialized shell scripts that wrap the HA CLI and REST API for tasks like device control or automation management.
- The skill dynamically fetches public release notes from GitHub to ensure advice on breaking changes remains current.
Home Assistant Expert Skill Setup
To integrate this with your Openclaw Skills environment, follow these steps:
- Configure SSH in HA: Install the Terminal & SSH add-on and add your public key to the
authorized_keyssection. - Generate Token: Create a Long-Lived Access Token in your Home Assistant user profile under the Security tab.
- Environment Configuration: Set the following variables in your
openclaw.jsonor shell environment:
export HA_URL="http://homeassistant.local:8123"
export HA_TOKEN="your_long_lived_token"
export HA_HOST="homeassistant.local"
export HA_SSH_PORT="22"
export HA_SSH_USER="root"
export HA_CONFIG_PATH="/config"
- Verify: Run the connection check script:
bash scripts/check-setup.sh
Home Assistant Expert Skill Data Schema & Taxonomy
The skill organizes its intelligence and state within the references/ directory to maintain context-aware operations:
| File | Description |
|---|---|
ha-state.json |
Stores the active HA version and connection status. |
ha-release-notes.md |
Dynamically fetched changelogs relative to the user's version. |
user-integrations.md |
Curated documentation for the specific integrations found on the instance. |
ha_scan.json |
Raw output of the integration and entity discovery process. |
Home Assistant Expert Skill Advanced Features
- Intelligent YAML Rollback: Automatically backs up and restores configuration files if
ha core checkfails during an update. - Version-Relative Logic: Filters help and recommendations based on whether the user's specific version supports a feature.
- Holistic Diagnostics: Cross-references official integrations, HACS components, and Add-ons to identify architectural conflicts.
- Automated Dashboard Generation: Groups entities by area and type to generate modern 'Sections' view YAML templates.
- Native IR and Matter Support: Includes specialized logic for managing infrared proxies and Matter/Thread device stacks.
SKILL.md
Loading
Related Openclaw Skills
Expense Claim Processor
An end-to-end automation skill that transforms raw receipt images and PDFs into organized, submission-ready expense claim packages.
WeChat Knowledge Builder
A specialized tool for converting WeChat chat logs into structured knowledge cards, Feishu databases, and AI training datasets.
Whale Alert Monitor
A professional crypto monitoring agent designed to track large-scale wallet activities, exchange flows, and institutional movements across multiple blockchains.
AICC Security Guard
A mission-critical security layer that prevents AI agents from handling sensitive data unless the AICC native plugin is active.
Generic Drug Lookup
A specialized pharmaceutical lookup tool that identifies the generic names of drugs using local search and intelligent LLM analysis.
Time Tracker by eBillity
A specialized skill for managing time tracking, project costs, and invoice generation through automated workflows.
Featured*
