SkillHub

glitch-homeassistant

v1.0.0

通过HA API控制并监控Home Assistant智能设备，支持灯光、开关、窗帘、温控、场景及脚本。

Sourced from ClawHub, Authored by Glitch

Installation

Please help me install the skill `glitch-homeassistant` from SkillHub official store. npx skills add chris6970barbarian-hue/glitch-homeassistant

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

  1. Home Assistant running on local network
  2. 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
  • 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