homeassistant-assist

Route natural-language requests through the Home Assistant Assist API to control devices.

Updated Apr 7, 2026
One-click install
npx skills add https://github.com/zhangyanbo2007/openclaw --skill homeassistant-assist-zhangyanbo2007
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: homeassistant-assist
Source: https://github.com/zhangyanbo2007/openclaw/tree/main/workspace-fox-smarthome/skills/homeassistant-assist-1.1.1
Command: npx skills add https://github.com/zhangyanbo2007/openclaw --skill homeassistant-assist-zhangyanbo2007

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Controls Home Assistant smart home devices by passing natural language to the Assist (Conversation) API, removing the need for manual entity lookups and verbose service calls.

Core Features & Use Cases

  • Direct natural-language control of any HA-integrated device (lights, switches, thermostats, covers, vacuums, media players, etc.).
  • Fire-and-forget execution: Assist handles intent parsing, entity resolution, area context, and command execution.
  • Use Case: Issue a single command to control or query multiple devices across rooms.

Quick Start

Tell your assistant to turn on the kitchen lights.

Frequently Asked Questions about homeassistant-assist

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I control Home Assistant devices using natural language commands?

You can control Home Assistant devices using natural language by routing requests through the Assist API, which handles intent parsing and entity resolution automatically. This removes the need for manual entity lookups and verbose service calls for any HA-integrated device.

Do I need a specific API endpoint to use natural language for home automation?

Yes, natural language home automation requires the Home Assistant Conversation API endpoint at /api/conversation/process. The Assist API forwards your text commands to this endpoint to parse intents, resolve areas, and execute actions across your integrated devices.

What environment variables do I need to set up Home Assistant voice control?

Home Assistant voice control requires setting the HASS_SERVER environment variable to your server URL and a valid HASS_TOKEN for authentication. Additionally, the curl binary must be available on the system to execute the API requests.

Can I query the status of multiple smart home devices across different rooms at once?

Yes, you can query and control multiple smart home devices across rooms with a single natural language command. The Assist API handles area context and entity resolution automatically, supporting lights, thermostats, vacuums, media players, and other HA-integrated devices.

What types of smart home devices work with natural language commands via the Assist API?

Natural language commands via the Assist API work with any Home Assistant-integrated device, including lights, switches, thermostats, covers, vacuums, and media players. Both control and query tasks are supported across all rooms and areas configured in your Home Assistant setup.

Why does my Home Assistant natural language command fail to execute?

Execution failures for Home Assistant natural language commands usually stem from missing environment variables, an invalid HASS_TOKEN, or lack of the curl binary. Verify that HASS_SERVER is correctly set and your token has the necessary permissions to call the Conversation API.