Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
Version History
**Switched to uv for dependency management and simplified setup.** - Removed the custom virtualenv bootstrap script; now uses uv and pyproject.toml for managing dependencies. - Added pyproject.toml with updated Python and python-kasa version constraints to address resolver issues. - Updated wrapper and helper scripts to use uv instead of manual virtualenv activation. - Updated documentation to reflect the new uv-based workflow, with quick start instructions. - Dropped mention of the old virtualenv in favor of uv; Git ignore advice simplified.
What This Skill Does
Controls TP-Link Kasa-compatible smart bulbs over a local network using a Python script and the python-kasa library. Supports toggling power, setting brightness from 0 to 100, and changing color via HSV values. No cloud account or credentials are required.
Works entirely over LAN without a cloud account, so it keeps working when the vendor's servers are down or discontinued.
When to use it
- Turning a desk lamp on at a scheduled time
- Flashing a bulb red when a build fails
- Running a color sequence for a light show
- Dimming lights automatically in the evening
- Scripting bulb state changes from a home server
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: turn on the bulb at 192.168.4.69 and set it to red at 80% brightness
- 1Identify the bulb's local IP address (192.168.4.69)
- 2Run the control script with --on to power the bulb on
- 3Pass --hsv 0 100 80 to set the hue to red with full saturation
- 4Pass --brightness 80 to set brightness to 80%
Bulb turns on and displays red at 80% brightness
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.