A comprehensive CLI-based skill for controlling Athom Homey smart home devices through local LAN or cloud APIs.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install homey
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install homey using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Homey Smart Home Control?
This skill provides a robust interface to interact with your Athom Homey ecosystem, supporting Homey Pro, Homey Cloud, and Homey Bridge. It enables users and AI agents to manage smart devices, execute automated flows, and organize zones via a professional command-line interface. By leveraging Openclaw Skills, developers can integrate home automation directly into their terminal workflows or agentic scripts.
The tool supports both local network access for low-latency control and cloud-based authentication for remote or headless environments. Whether you need to toggle a light, adjust a thermostat, or trigger a complex routine, this skill offers the granular control necessary for sophisticated smart home management within the Openclaw Skills ecosystem.
Homey Smart Home Control Use Cases
- Automating morning or evening routines through shell scripts or AI agents.
- Monitoring real-time sensor data like temperature, humidity, or motion from a terminal.
- Triggering complex Homey Flows (automations) remotely via VPS or headless servers.
- Bulk managing smart devices using JSON-based filtering and automated processing.
- Integrating smart home status checks into developer dashboards using Openclaw Skills.
How Homey Smart Home Control Works
- The user authenticates the CLI using either a local API key for LAN access or a cloud bearer token for remote access.
- The homeycli tool establishes a secure connection to the Homey hub or the Athom Cloud API.
- Users issue commands to list devices, retrieve current states, or set new capability values like brightness or temperature.
- The skill utilizes advanced fuzzy matching to identify devices or flows even with partial names or minor typos.
- For automated workflows, the skill outputs data in structured JSON format, allowing for seamless integration with other Openclaw Skills and data processing pipelines.
Homey Smart Home Control Setup
The skill requires Node.js >= 18. Follow these steps to integrate it with Openclaw Skills:
- Install the CLI tool:
npm install -g .
- Configure Local Authentication (Recommended for home networks):
homeycli auth discover-local --save --pick 1
echo "<LOCAL_API_KEY>" | homeycli auth set-local --stdin
- Configure Cloud Authentication (Recommended for VPS or headless use):
echo "<CLOUD_TOKEN>" | homeycli auth set-token --stdin
- Test the connection:
homeycli status
Homey Smart Home Control Data Schema & Taxonomy
The skill organizes data around the official Homey object model. Most commands support the --json flag to provide structured data compatible with Openclaw Skills automation.
| Entity | Description | Key Metadata Fields |
|---|---|---|
| Devices | Physical or virtual hardware | id, name, capabilities, class, zone |
| Flows | Automated routines and scenes | id, name, enabled |
| Zones | Physical locations or rooms | id, name, parent |
| Capabilities | Specific device traits/states | onoff, dim, target_temperature, locked |
Use homeycli snapshot --json to retrieve a complete state of all devices and flows in a single operation.
Homey Smart Home Control Advanced Features
- Fuzzy matching for device and flow names, allowing for Levenshtein distance typo tolerance during command execution.
- Comprehensive snapshot capability to export the entire state of the smart home into a single JSON object for AI analysis.
- Support for multi-sensor devices, enabling the retrieval of all capability values (e.g., temperature, humidity, luminance) in one command.
- Full JSON output mode for every command, ensuring maximum compatibility with jq and other pipeline tools in the Openclaw Skills ecosystem.
- Detailed capability management allowing for granular control over specific device traits like light hue, saturation, and thermostat targets.
SKILL.md
Loading
Related Openclaw Skills
casedev
A comprehensive legal AI platform providing encrypted document storage, OCR, transcription, and specialized legal search capabilities.
Memory Maintenance
An intelligent memory management tool that reviews daily notes and automates file cleanup for OpenClaw agents.
My Mac Optimizer Controller
An automated system utility for macOS that enables AI agents to monitor performance, clear junk, and manage applications via a local API.
Auto-Updater
A background utility that automates daily version checks and updates for both the core agent and all installed skills.
ohmyopenclaw
A comprehensive collection of AI-native configuration guides designed to automate the setup and optimization of Openclaw Skills for diverse agent architectures.
Clips Machine
An automated workflow for transforming long-form videos into high-engagement, captioned short-form clips for social media.
METADATA
Featured*
