wiz-light-control

What This Skill Does

The Wiz Light Control skill empowers your OpenClaw agent to manage Wiz smart lighting systems directly through your local area network (LAN). By acting as an interface for the light hardware, it removes the need for clunky cloud-based apps. Users can toggle the power state of their lights, transition to specific RGB color profiles, or trigger ambient 'disco' lighting modes for a set duration. This skill utilizes the local UDP protocol to send commands directly to the hardware, ensuring high responsiveness and privacy, as communication stays strictly within your home network.

Installation

Installation is streamlined through the OpenClaw ecosystem. To add this capability to your agent, run the command: clawhub install openclaw/skills/skills/canbirlik/wiz-light-control. Upon first execution, the agent will verify if a Python virtual environment is present. If it is missing, it will automatically bootstrap the environment using python3 -m venv venv && source venv/bin/activate && pip install -r requirements.txt. You must ensure your environment has network access to the bulb's local IP address.

Use Cases

• Home Automation: Integrate your lighting into complex morning or evening routines by having your agent turn lights on at specific brightness levels.
• Ambient Environment: Change the room's color scheme to match a mood, work focus, or movie-watching session.
• Event Notifications: Use the 'disco' mode as a visual alert when a long process finishes or if a specific threshold is met in a data analysis script.
• Energy Management: Quickly turn off all lights in the house through a single voice command to ensure nothing is left running.

Example Prompts

• "Hey, the room is too dark, please turn on the light at 192.168.1.109."
• "I'm hosting a party, can you set the Wiz bulb to disco mode for 10 minutes?"
• "Change the color of my living room light to a warm red for a cozy evening vibe."

Tips & Limitations

• Static IPs: Wiz bulbs rely on network discovery. It is highly recommended to assign a static IP address to your bulb via your router settings to prevent the agent from losing the device when the bulb's IP address changes due to a DHCP refresh.
• Local Network Requirement: This skill only works if your computer is on the same local network as the light bulb. It will not work over the internet unless a VPN or remote bridge is established.
• Security: Since this uses local UDP packets, ensure your network firewall allows communication between the agent's machine and the light's designated IP.