homebridge

What This Skill Does

The Homebridge skill for OpenClaw provides a robust interface to control your smart home ecosystem directly through the Homebridge Config UI X REST API. By bridging the gap between OpenClaw and your HomeKit accessories, this skill allows for seamless automation and manual control of lights, switches, thermostats, fans, and various other IoT devices managed by your Homebridge server. It handles authentication securely via Bearer tokens, enabling granular control over device characteristics like power state, brightness, hue, saturation, and target temperature settings.

Installation

To integrate this skill into your environment, follow these steps:

1. Ensure your Homebridge server is running with the Config UI X plugin enabled.
2. Create a credentials file at ~/.clawdbot/credentials/homebridge.json and populate it with your url, username, and password as defined in the configuration documentation.
3. Execute the installation command in your terminal: clawhub install openclaw/skills/skills/jiasenl/clawdbot-skill-homebridge.
4. Verify the connection by attempting to list your accessories using the internal command set.

Use Cases

This skill is perfect for users who want to centralize their smart home management within the OpenClaw agent workflow. Common scenarios include creating complex automation routines that trigger smart lighting based on time or calendar events, adjusting HVAC settings before arriving home, or managing groups of switches to simulate presence while away. It is an essential tool for power users looking to integrate IoT data into their LLM-driven agentic tasks.

Example Prompts

1. "Turn off all the lights in the living room and set the thermostat to 20 degrees."
2. "Can you check the current status of the hallway lamp and set its brightness to 75%?"
3. "List all available devices in the bedroom and tell me if any are currently switched on."

Tips & Limitations

To ensure optimal performance, verify that your Homebridge server is accessible via the network path defined in your credentials file. Note that this skill relies on the specific characteristic types exposed by your connected Homebridge plugins. If a device does not respond to a command, double-check the unique identifier in the accessories list using the api/accessories endpoint. For security, ensure that the file permissions for ~/.clawdbot/credentials/homebridge.json are restricted to your local user to prevent unauthorized access to your smart home controls.