首页 › 龙虾技能列表 › Wled — WLED — WLED LED 控制器

Wled — WLED — WLED LED 控制器

v0.1.0

通过 HTTP API 控制 WLED LED 控制器，支持开关、亮度、RGB 颜色、效果、调色板、预设和设备状态。适用于控制 WLED 灯、LED 条、ESP 基础 LED 控制器。

1· 1,972·2 当前·2 累计
by @rowbotik (Alex Buchan)·MIT-0
下载技能包
License
MIT-0
最后更新
2026/2/26
安全扫描
VirusTotal
无害
查看报告
OpenClaw
安全
high confidence
该技能的代码、指令和要求与其控制 WLED 设备的目的一致，不请求无关的凭据或安装外部软件。
评估建议
该技能如其所述，向指定的 WLED 设备发送 HTTP JSON 请求。安装前，请确保：(1) 只指向您控制/信任的设备，(2) 感舒适阅读配置文件（存储设备 IP/别名），(3) 不提供路由器或其他管理员凭据给第三方。该技能不外泄数据、请求无关凭据或安装外部包。...
详细分析 ▾
✓ 用途与能力
名称/描述与实现相符：脚本向 WLED 的 /json 端点发送 HTTP 调用，暴露电源、亮度、颜色、效果、调色板、预设和状态。无不相关的环境变量、二进制文件或服务。
✓ 指令范围
SKILL.md 只指示联系本地 WLED 设备、配置文件使用（~/.wled/config.json 等）和可选 WLED_HOST 环境变量。运行时指令和 scripts/wled.py 中的 CLI 行为与文档一致，不读取或传输目标设备或本地配置文件之外的数据。
✓ 安装机制
仅指令，附带脚本；无安装规格或下载。最低风险的分发模型（无存档或外部安装程序）。
✓ 凭证需求
未声明任何必需的环境变量或凭据；唯一可选的环境变量是 WLED_HOST，适用于设备定向。读取的配置文件路径（home/config）与设备别名成比例。
✓ 持久化与权限
技能不是始终启用，用户可以调用。它不修改其他技能或系统范围的配置；仅读取自己的配置文件位置。
安全有层次，运行前请审查代码。

License

MIT-0

可自由使用、修改和再分发，无需署名。

运行时依赖

无特殊依赖

版本

latestv0.1.02026/2/1

初始发布：通过 HTTP 控制 WLED LED 控制器，支持全面设备和照明命令。- 支持开关、亮度调整和 RGB 颜色控制。- 支持效果、调色板、预设的切换和列表。- 查询完整设备状态。- 命令行工具，支持配置文件和环境变量简化设备选择。- 无外部依赖。

● 无害

安装命令 点击复制

官方npx clawhub@latest install wled
镜像加速npx clawhub@latest install wled --registry https://cn.clawhub-mirror.com

技能文档

控制 WLED LED 条和矩阵通过 HTTP JSON API。

要求

  • 同一网络上的 WLED 设备
  • 设备 IP 地址或主机名
  • Python 3（无外部依赖）

用法

所有命令需要 --host（或 -H）与 WLED 设备 IP/主机名。

电源控制

python3 scripts/wled.py -H  power # 获取电源状态
python3 scripts/wled.py -H  power on # 开启
python3 scripts/wled.py -H  power off # 关闭

亮度

python3 scripts/wled.py -H  brightness # 获取当前亮度
python3 scripts/wled.py -H  brightness 255 # 最大亮度
python3 scripts/wled.py -H  brightness 128 # 50% 亮度

颜色

python3 scripts/wled.py -H  color 255 0 0 # 红色
python3 scripts/wled.py -H  color 0 255 0 # 绿色
python3 scripts/wled.py -H  color 0 0 255 # 蓝色
python3 scripts/wled.py -H  color 255 255 255 # 白色

效果

python3 scripts/wled.py -H  effects # 列出所有效果和 ID
python3 scripts/wled.py -H  effect 0 # 固定颜色
python3 scripts/wled.py -H  effect 9 # 彩虹
python3 scripts/wled.py -H  effect 9 -s 200 # 彩虹，快速速度
python3 scripts/wled.py -H  effect 9 -i 128 # 彩虹，中等强度

调色板

python3 scripts/wled.py -H  palettes # 列出所有调色板和 ID
python3 scripts/wled.py -H  palette 6 # 设置派对调色板

预设

python3 scripts/wled.py -H  presets # 列出保存的预设
python3 scripts/wled.py -H  preset 1 # 载入预设 #1

状态

python3 scripts/wled.py -H  status # 完整设备状态

参考

请参阅 references/api.md 获取完整 API 文档。

配置

避免每次传递 --host 通过创建配置文件 ~/.wled/config.json： 
{
  "bedroom": "192.168.1.100",
  "kitchen": "192.168.1.101",
  "living_room": "wled-abc123.local"
}
然后使用别名： 
python3 scripts/wled.py -H bedroom brightness 255
python3 scripts/wled.py -H kitchen color 255 0 0
或设置 WLED_HOST 环境变量： 
export WLED_HOST=192.168.1.100
python3 scripts/wled.py brightness 255

找到您的 WLED 设备

WLED 设备通常可以通过以下方式找到：
  • 路由器管理面板（查找 ESP 设备）
  • mDNS/Bonjour: wled-.local
  • WLED 应用发现

静态 IP 推荐

IP 地址会随时间变化。为了避免更新您的配置，为 WLED 设备设置静态 IP： 选项 1：基于路由器（最简单）
  • 打开路由器管理面板
  • 通过 MAC 地址找到 WLED 设备
  • 保留/分配静态 IP
选项 2：在设备上
  • 访问 WLED 网页 UI tại http://<当前 IP>
  • 转到设置 → WiFi 设置
  • 手动设置静态 IP
  • 保存并重启
使用 mDNS 主机名（例如 wled-abc123.local）也可以避免 IP 跟踪——路由器会自动解析这些。

数据来源：ClawHub ↗ · 中文优化：龙虾技能库
OpenClaw 技能定制 / 插件定制 / 私有工作流定制

免费技能或插件可能存在安全风险，如需更匹配、更安全的方案，建议联系付费定制

了解定制服务