control-ikea-lightbulb

What This Skill Does

The control-ikea-lightbulb skill is a specialized automation tool designed for local area network (LAN) control of smart lighting devices. While the name references IKEA, the engine primarily utilizes the python-kasa library to interact with TP-Link Kasa-compatible smart bulbs. This skill provides a programmatic interface to adjust bulb power states, brightness, and color (using the HSV color model) without the need for cloud authentication or external internet access. By operating directly over the local network via IP address, it ensures low-latency control and preserves privacy. Included in this package are the main control script, a light-show controller for complex sequencing, and convenience wrappers built for the uv environment management tool.

Installation

To integrate this skill into your environment, use the OpenClaw management command: clawhub install openclaw/skills/skills/antgly/control-ikea-lightbulb.

Ensure you have the uv package manager installed on your machine. For macOS users, you can run brew install uv. For other platforms, pipx install uv is recommended. The skill is designed to handle dependency management automatically via the included pyproject.toml file, meaning you do not need to manually configure virtual environments. Simply navigate to the skill folder and execute the provided shell scripts, which are configured to run within the managed environment context.

Use Cases

This skill is perfect for home automation enthusiasts and developers building smart environments. Common scenarios include:

• Integrating lighting control into broader AI workflows, such as dimming lights when an AI agent initiates a focus session or movie mode.
• Creating dynamic light shows or ambient lighting patterns using the included light_show.py utility for events.
• Automating routine tasks like turning off all lights at a specific time or when the system detects no activity.
• Providing accessibility features, such as voice-activated color changes or brightness adjustments for users who prefer hands-free interaction with their physical environment.

Example Prompts

1. "Turn on the office light at 192.168.4.69 and set the brightness to 50%."
2. "Set the living room bulb at 192.168.1.15 to a warm orange color using HSV values 30, 100, 80."
3. "Run the light show sequence on the bulb at 192.168.4.69 with a 5-second duration and enable the off-flash effect."

Tips & Limitations

• Network Requirements: Ensure the bulb is on the same subnet as your machine; the controller must be able to route traffic to the bulb's static IP.
• Hardware Compatibility: While optimized for Kasa, it is designed as a starting point for TRADFRI devices. If your specific bulb is not supported, technical support can be requested to add specific hardware modules.
• Color Temp: When using white, the system defaults to 9000K for a cooler appearance; use the --white-temp flag if you prefer warmer lighting.
• Security: Because this acts directly on the LAN, ensure your local network is secure, as any device with access to these scripts can manipulate your lighting.