By name: Home Assistant Skill description: Control smart home devices via Home Assistant API.
Home Assistant Skill
Control smart home devices via Home Assistant API.
Skill Metadata
Name: homeassistant
Type: OpenClaw Skill
Purpose: Control lights, switches, covers, climate, scenes, scripts via HA API
Setup Commands
Prerequisites
Home Assistant running on local network
Long-Lived Access Token from HA Profile page
Configuration (One-Command)
# Run this to configure
ha-cli setup <HA_URL> <TOKEN>
# Example:
ha-cli setup 192.168.1.100 your_long_lived_token_here
Or set environment variables:
export HA_URL="http://homeassistant.local:8123"
export HA_TOKEN="your_token_here"
Usage Commands
Basic Control
# Turn on device (any type)
ha-cli on <device_name>
ha-cli <device_name> on
# Turn off device
ha-cli off <device_name>
ha-cli <device_name> off
Brightness & Color
# Set brightness (0-100)
ha-cli brightness <0-100> <device_name>
ha-cli <device_name> brightness 75
# Set RGB color
ha-cli rgb #RRGGBB <device_name>
ha-cli rgb #FF5500 "Living Room"
Temperature
# Set temperature
ha-cli <temperature> <thermostat_name>
ha-cli 22 thermostat
Scenes & Scripts
# Activate scene
ha-cli scene <scene_name>
ha-cli scene movie
# Run script
ha-cli script <script_name>
ha-cli script morning
Status & Discovery
# Check HA status
ha-cli status
ha-cli info
# List all entities
ha-cli list
ha-cli list entities
# List by domain
ha-cli list light
ha-cli list switch
ha-cli list climate
Supported Device Types
| Domain | Commands | Examples |
|--------|----------|----------|
| light | on, off, brightness, rgb | ha-cli on living room |
| switch | on, off | ha-cli off tv |
| cover | open, close, stop | ha-cli open blinds |
| climate | temperature, mode | ha-cli 22 thermostat |
| lock | lock, unlock | ha-cli lock front door |
| scene | activate | ha-cli scene movie |
| script | run | ha-cli script morning |
Entity Matching
Case insensitive
Partial name matching (bed → Bedroom Light)
Fuzzy matching enabled
Error Handling
Connection error: Shows HA URL and token setup instructions
Entity not found: Shows similar entity suggestions
Invalid command: Shows usage help
Related Skills
openhue (Philips Hue)
sonoscli (Sonos speakers)
eightctl (Eight Sleep)
Files
homeassistant/
├── SKILL.md # This file
├── README.md # User documentation
├── ha-cli # Main CLI executable
├── ha # Bash wrapper
└── config.json # Saved configuration