A robust CLI tool designed for AI agents to securely control Homey home automation hubs and manage smart devices.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install homey-cli
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-cli 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 CLI?
Homey CLI provides a secure and agent-friendly interface for interacting with Homey home automation hubs. It enables technical users and AI agents to manage a wide array of smart home devices, including lights, thermostats, and sockets, without needing a GUI. Built with safety in mind, it utilizes a capability-allowlist model to prevent unauthorized destructive operations.
By integrating this skill with Openclaw Skills, developers can bridge the gap between AI-driven logic and physical hardware, allowing for complex home automation scenarios through simple command-line execution. This tool is ideal for those looking to programmatically inspect device statuses or trigger flows within their smart home ecosystem.
Homey CLI Use Cases
- Automated light management including switching on/off, dimming, and color adjustments.
- Monitoring environmental status such as temperature readings and real-time device availability.
- Triggering complex Homey flows via scheduled tasks or AI-driven prompts.
- Generating full inventories of home automation devices for auditing or reporting.
- Organizing and inspecting smart devices grouped within specific zones.
How Homey CLI Works
- The user authenticates with the Homey Developer Portal to obtain OAuth credentials (Client ID and Secret).
- The CLI establishes a secure connection to the Homey hub using the provided credentials via an OAuth flow.
- Users or AI agents query the hub to list available devices, zones, or automated flows.
- Specific commands are sent to the hub to read sensor data or change device states through allowlisted capabilities.
- The capability-allowlist ensures that only safe, pre-approved operations are executed on the physical hardware.
Homey CLI Setup
First, install the necessary dependencies for this part of your Openclaw Skills library:
cd skills/homey-cli
npm install
Next, create a new app at the Homey developer portal (tools.developer.homey.app) to get your credentials, then configure your .env file:
export HOMEY_CLIENT_ID="your-client-id"
export HOMEY_CLIENT_SECRET="your-client-secret"
export HOMEY_REDIRECT_URL="http://localhost:8787/callback"
Finally, authenticate the CLI and follow the browser prompts:
bash run.sh auth login
Homey CLI Data Schema & Taxonomy
The skill manages its configuration and state through specific files and standardized JSON outputs to maintain a consistent structure within Openclaw Skills:
| Data Element | Path / Format | Description |
|---|---|---|
| OAuth Tokens | ~/.config/homey-cli/credentials.json |
Stores access and refresh tokens for the Homey API. |
| Active Hub | ~/.config/homey-cli/config.json |
Records the ID of the currently targeted Homey hub. |
| Device Metadata | JSON Object | Standardized output including device ID, class, zones, and current capability states. |
Homey CLI Advanced Features
- Capability-allowlisting providing granular safety control to prevent accidental destructive actions on hardware.
- Native JSON output support for all listing commands to facilitate seamless integration with other scripts and AI agents.
- Global inventory command to retrieve the complete state of the smart home hub in one request.
- Support for multi-hub environments allowing easy switching between different Homey instances using the use command.
- Environment variable overrides (
HOMEY_CLI_ALLOWED_CAPABILITIES) to customize the set of allowed device capabilities.
SKILL.md
Loading
Related Openclaw Skills
Beeper CLI
A command-line tool for local Beeper chat history extraction, offering read-only access to threads, messages, and advanced full-text search.
KDP Publisher
A comprehensive AI agent skill for automating the end-to-end creation, formatting, and uploading of books to Amazon Kindle Direct Publishing.
Polymarket BTC 15m Trading Skill
A professional-grade trading skill for Polymarket Bitcoin 15-minute markets featuring automated signal processing and dynamic position sizing.
Polymarket BTC 15m Trading
An automated trading tool for Polymarket Bitcoin 15-minute markets featuring dynamic risk management and signal-based execution.
Austrian Post (post.at) CLI
A powerful CLI tool to manage Austrian Post deliveries, including tracking, listing, and setting delivery preferences.
Lightpanda
A high-performance, lightweight headless browser designed as a drop-in replacement for Chrome in automated data retrieval tasks.
Featured*
