homey-cli
Control Homey home automation hub via CLI. Use when you need to control smart home devices (lights, thermostats, sockets, etc.), check device status, list zones, trigger flows, or perform any Homey automation tasks. Supports on/off, dimming, color changes, temperature control, and device inspection. Safe, capability-allowlisted operations only.
Why use this skill?
Control lights, climate, and flows on your Homey hub using the Homey CLI skill for OpenClaw. Secure, agent-friendly smart home automation.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/krausefx/homey-cliWhat This Skill Does
The homey-cli skill provides a secure, robust interface for OpenClaw agents to interact with Homey Pro automation hubs. It enables comprehensive smart home management by allowing agents to discover, query, and manipulate connected hardware. From lighting and climate control to triggering complex home automations, this skill acts as a bridge between high-level agent intents and low-level device capabilities. It features a hardened safety layer, ensuring that only pre-approved, non-destructive operations are permitted, such as changing bulb colors or toggling power states. By abstracting the complexities of the Homey API, it empowers agents to maintain the home environment seamlessly.
Installation
- Install the core dependencies by navigating to the skill directory (
cd skills/homey-cli) and runningnpm install. - Register an application within the Homey Developer Tools to obtain your
Client IDandClient Secret, ensuring the Callback URL is set tohttp://localhost:8787/callback. - Populate your
.envfile with the required credentials as specified in the configuration documentation. - Execute
bash run.sh auth loginto initiate the OAuth handshake. Tokens are securely persisted in~/.config/homey-cli/. - Select your hub by running
bash run.sh homey use <homeyId>to define the target scope for all subsequent operations.
Use Cases
This skill is ideal for home automation scenarios where manual interaction is tedious. Use it to create adaptive lighting scenes based on the time of day, manage climate control to optimize energy efficiency, or query the state of multiple sensors simultaneously. It is particularly effective for managing entire zones, such as triggering an 'Away' flow that shuts down all appliances and locks doors when the user leaves.
Example Prompts
- 'Dim the living room lights to 20% and set the temperature to 22 degrees.'
- 'Check if the front door sensor is reporting as open or closed.'
- 'Turn off all devices in the kitchen and trigger the Good Night flow.'
Tips & Limitations
Always ensure your devices are properly categorized within the Homey app for the best results when using the devices list --json query. The skill is intentionally designed with a restrictive safety model; you cannot delete devices or modify existing flows to prevent accidental hub misconfiguration. If a specific capability isn't responding, check that it is included in your HOMEY_CLI_ALLOWED_CAPABILITIES environment variable. Keep your Homey firmware updated to ensure full compatibility with the latest API versions.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-krausefx-homey-cli": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: network-access, file-read, file-write, external-api