homeassistant-assist

⚠Review·Scanned 2/17/2026

This skill sends natural-language commands to Home Assistant's Assist API ($HASS_SERVER/api/conversation/process) to control HA entities. It requires HASS_SERVER and HASS_TOKEN to be set (e.g., in ~/.openclaw/openclaw.json) and includes install/CLI commands like clawhub install homeassistant-assist.

from clawhub.ai·v26e3094·9.9 KB·0 installs

Scanned from 1.1.0 at 26e3094 · Transparency log ↗

$ vett add clawhub.ai/developmentcats/homeassistant-assistReview findings below

🏠 Home Assistant Assist

An OpenClaw skill for controlling Home Assistant smart home devices using the Assist (Conversation) API.

Note: This is an OpenClaw skill, not a HACS integration. It runs inside OpenClaw and communicates with your Home Assistant instance via its API.

✨ Why This Skill?

Instead of the AI manually looking up entity IDs and building verbose service calls, this skill passes natural language directly to Home Assistant's built-in NLU. This is:

Approach	Tokens	API Calls	Reliability
Traditional (entity lookup + service call)	High	Multiple	Fragile
Assist API	Low	One	Robust

🚀 Faster — Single API call instead of multiple lookups
💰 Cheaper — Fewer tokens spent on entity resolution
🎯 More reliable — Home Assistant knows your home better than any AI

📋 Requirements

OpenClaw installed and running
Home Assistant instance with API access
A Long-Lived Access Token from Home Assistant

🚀 Installation

From ClawHub (Recommended)

clawhub install homeassistant-assist

Or ask your OpenClaw agent:

"Install the homeassistant-assist skill"

Manual Installation

git clone https://github.com/DevelopmentCats/homeassistant-assist.git \
  ~/.openclaw/workspace/skills/homeassistant-assist

⚙️ Configuration

Add the following to your OpenClaw config (~/.openclaw/openclaw.json):

{
  "env": {
    "HASS_SERVER": "https://your-homeassistant-url",
    "HASS_TOKEN": "your-long-lived-access-token"
  }
}

Getting Your Token

Open Home Assistant
Click your profile (bottom left)
Scroll to Long-Lived Access Tokens
Click Create Token
Give it a name (e.g., "OpenClaw")
Copy the token immediately (it won't be shown again!)

Then restart OpenClaw:

openclaw gateway restart

💬 Usage

Just talk naturally to your OpenClaw agent:

"Turn off the kitchen lights"
"Set the thermostat to 72"
"What's the temperature in the living room?"
"Close the garage door"
"Turn on the bedroom fan"
"Is the front door locked?"

The AI passes your request to Home Assistant's Assist API, which handles:

Intent parsing
Fuzzy entity name matching
Area-aware commands
Execution

💡 Tips & Troubleshooting

Entity Names

Home Assistant's Assist uses friendly names. If "bedroom light" doesn't work but "bedroom lamp" does, that's the entity's friendly name in HA. You can:

Add aliases in Home Assistant (Settings → Devices → Entity → Edit → Aliases)
Use the exact friendly name shown in HA

Automations

Assist can enable/disable automations but cannot trigger them directly. Workaround:

Create an automation in HA with a sentence trigger (e.g., "cycle the robot vacuum")
Have the automation call whatever service you need
Now you can say that phrase to Assist!

"Sorry, I couldn't understand that"

Try rephrasing with simpler language
Check if the device exists and is named as expected
Make sure the Assist pipeline is working in HA (Settings → Voice Assistants)

Multiple Devices with Same Name

If Assist says "there are multiple devices called X", add unique aliases to your entities in Home Assistant.

🔗 Links

ClawHub: clawhub.com/skills/homeassistant-assist
GitHub: github.com/DevelopmentCats/homeassistant-assist
OpenClaw: github.com/openclaw/openclaw
HA Conversation API Docs: developers.home-assistant.io

📄 License