philips-hue

What This Skill Does

The Philips Hue skill provides low-latency, local control of your smart lighting ecosystem through OpenClaw. By interfacing directly with the Philips Hue Bridge via API v1, it enables granular management of individual light states, color temperatures, and custom hex values. This skill is designed for speed and reliability, bypassing cloud-based dependencies to ensure your lighting commands execute instantly on your local network.

Installation

1. Ensure your Hue Bridge is active and on the same subnet as your OpenClaw agent.
2. Install necessary system dependencies: curl, jq, and python3.
3. Clone the skill repository into your OpenClaw workspace.
4. Create a .env file in the skill directory containing your BRIDGE_IP and USERNAME (API key).
5. If you lack an API key, press the physical button on your bridge and run the setup tool or a request command to register the agent as an authorized device.

Use Cases

• Automated Lighting Scenes: Use the agent to set the room to a specific hue or brightness based on the time of day or activity (e.g., 'Work' mode vs. 'Relax' mode).
• Visual Notifications: Have your lights pulse or change color to alert you when a long-running process completes or a high-priority message arrives.
• Complex Lighting Arrays: Chain multiple light commands together to synchronize the entire house, changing colors and intensity for parties or mood setting.

Example Prompts

1. "OpenClaw, dim the living room light to 20% and set the color to warm white."
2. "Hey, change light number 3 to deep blue and set the brightness to 100%."
3. "OpenClaw, switch the kitchen lights to hex code #FF5733 for my cooking session."

Tips & Limitations

• Pro Tip: Use the chaining functionality to combine brightness and saturation settings in a single command, which reduces API overhead and increases response speed.
• Limitations: This skill relies on API v1. Ensure your Bridge is updated but note that it does not currently support advanced v2 features like persistent group entertainment zones. Always ensure your .env file remains secure as it contains the bridge access credentials. If you experience latency, verify the network connection between the host system and the Hue Bridge hardware.