A Python-powered CLI tool for controlling WLED-enabled LED strips and matrices via their native JSON API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install wled
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install wled using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is WLED Control?
The WLED skill provides a powerful interface to interact with ESP8266 or ESP32-based LED controllers from your terminal or AI environment. By leveraging the WLED JSON API, it enables granular control over smart lighting setups without requiring external cloud dependencies or complex hub configurations.
This skill is part of the ecosystem of Openclaw Skills designed to bridge the gap between AI agents and physical hardware, allowing for automated lighting scenes, status indications, or simple manual control through standardized commands. It is particularly useful for developers and hobbyists who want to integrate their smart home environment into their local development workflows and automation scripts.
WLED Control Use Cases
- Toggling LED strip power states programmatically.
- Synchronizing room lighting with system status or build notifications.
- Cycling through complex WLED effects and color palettes via CLI.
- Loading predefined light presets for different times of day.
- Checking device status and brightness levels from an AI agent environment.
How WLED Control Works
- The user identifies the WLED device IP address or mDNS hostname on the local network.
- Commands are issued via the wled.py script, specifying the target host and the desired action like color, brightness, or effect.
- The skill sends a structured HTTP request to the WLED JSON API endpoint of the controller.
- The WLED controller processes the request and updates the LED state immediately.
- The script parses the JSON response from the device to confirm the update or display current status to the user.
WLED Control Setup
Ensure Python 3 is installed on your system. No external dependencies are required as the skill uses standard libraries. To configure persistent hosts for Openclaw Skills, create a configuration file at ~/.wled/config.json:
mkdir -p ~/.wled
cat <<EOF > ~/.wled/config.json
{
"bedroom": "192.168.1.100",
"kitchen": "192.168.1.101"
}
EOF
Alternatively, you can set an environment variable for a single default device:
export WLED_HOST=192.168.1.100
WLED Control Data Schema & Taxonomy
The skill uses a simple JSON configuration schema for alias mapping and interacts with WLED's native JSON response structure for state management.
| Data Component | Description |
|---|---|
| Config File | ~/.wled/config.json mapping user-defined names to IP addresses. |
| API Protocol | Stateless HTTP/JSON via WLED native endpoints. |
| State Metadata | Includes power state, brightness (0-255), RGB values, and effect IDs. |
| Device Discovery | Supports mDNS hostnames (e.g., wled-abc.local) for dynamic IP resolution. |
WLED Control Advanced Features
- Support for mDNS/Bonjour hostnames to handle dynamic IP environments seamlessly.
- Granular effect control including speed (-s) and intensity (-i) parameters.
- Alias system for managing multiple LED controllers across different rooms with simple identifiers.
- Full status retrieval capabilities to sync hardware state with external dashboards or AI agents.
- Zero-dependency Python implementation making it highly portable for various Openclaw Skills deployments.
SKILL.md
Loading
Related Openclaw Skills
AdGuard Home Controller
A robust CLI tool for managing AdGuard Home DNS filtering, protection states, and domain rules via an intuitive HTTP API interface.
CV Builder
A sophisticated AI agent skill that generates professional resumes, interactive CVs, and 3D digital identities with built-in human-in-the-loop verification.
HITL Protocol
An open standard for integrating human decision-making directly into autonomous AI agent workflows using HTTP 202 responses.
OpenClaw Update
A dedicated management skill for monitoring and applying version updates to the OpenClaw platform.
AI Daily Digest
An intelligent RSS aggregator that fetches content from 90 elite tech blogs and uses AI to generate a curated, categorized daily summary.
Daily Company Briefing
An automated business intelligence agent that aggregates corporate news, partner updates, and industry bidding opportunities into a concise morning briefing.
METADATA
Featured*
