WLED灯光控制

技能简介

通过HTTP JSON API远程控制WLED LED控制器，支持灯带开关、亮度调节、颜色设置、动态效果、色板切换及预设场景调用。

能做什么

• 远程开关LED灯带电源
• 调节亮度（0-255级）
• 设置RGB颜色与白色
• 应用内置动态光效并调整速度/强度
• 切换色彩 palettes 与调用保存的预设
• 查询设备完整状态信息

使用说明

安装准备

1. 确保WLED设备与运行环境处于同一网络
2. 获取设备IP地址或mDNS主机名（如wled-abc123.local）
3. Python 3环境（无需额外依赖库）

基础命令格式

python3 scripts/wled.py -H <ip> <command> [args]

常用操作示例

# 电源控制
python3 scripts/wled.py -H 192.168.1.100 power on
python3 scripts/wled.py -H 192.168.1.100 power off

# 亮度调节
python3 scripts/wled.py -H 192.168.1.100 brightness 200

# 颜色设置
python3 scripts/wled.py -H 192.168.1.100 color 255 100 0

# 动态效果
python3 scripts/wled.py -H 192.168.1.100 effect 9 -s 150

# 加载预设
python3 scripts/wled.py -H 192.168.1.100 preset 2

简化配置（可选）

创建配置文件~/.wled/config.json定义设备别名，或使用环境变量WLED_HOST避免重复输入地址。

输入与输出

见下方输入与输出表格。

风险提示

• 需确保目标设备IP/主机名正确，误操作可能影响其他网络设备
• 动态IP环境下建议配置静态IP或mDNS主机名，防止连接中断
• 部分效果在高亮度下功耗较大，注意供电能力
• API调用无身份验证，内网隔离可降低未授权访问风险

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/rowbotik/wled/SKILL.md
来源类型：开源项目文档