Nanoleaf灯控

技能简介

通过Picoleaf CLI控制Nanoleaf智能灯板，支持开关、亮度调节、RGB/HSL色彩设置及色温调整。

业务背景

为智能家居场景提供轻量级灯控能力，支持远程调节Nanoleaf智能灯板的开关、亮度、色彩与色温。适用于办公氛围营造、居家场景切换及自动化工作流集成，无需复杂开发即可实现个性化照明控制。

落地案例：某设计团队将Picoleaf CLI嵌入每日晨会脚本：上午9点自动开启灯光并调至4000K冷白光、80%亮度，帮助成员快速进入工作状态；下午6点切换至2700K暖光、30%亮度，提示下班时间。团队负责人通过配置文件集中管理多台设备IP与令牌，避免重复配对操作。

能做什么

• 远程开关Nanoleaf灯具
• 调节0-100%亮度
• 设置RGB或HSL颜色值
• 调整1200K-6500K色温
• 组合命令实现场景切换

使用说明

安装Picoleaf CLI：

方式一（Homebrew）：
brew install paulrosania/command-home/picoleaf

方式二（二进制）：
curl -sL https://github.com/tessro/picoleaf/releases/latest/download/picoleaf_1.4.0_linux_amd64.tar.gz | tar xz -C ~/.local/bin

配置步骤：

1. 查找设备IP：通过路由器或运行dns-sd -Z _nanoleafapi
2. 生成访问令牌：长按电源键5-7秒至LED闪烁，30秒内执行curl -iLX POST http://<ip>:16021/api/v1/new
3. 创建配置文件~/.picoleafrc：

   host=<ip>:16021
   access_token=<token>

常用命令：

• picoleaf on/off — 开关灯
• picoleaf brightness 50 — 设亮度50%
• picoleaf rgb 255 100 0 — 设橙色
• picoleaf temp 3000 — 设暖白光

输入与输出

见下方输入与输出表格。

风险提示

• 需物理接触设备以生成初始令牌
• 令牌泄露可能导致未授权控制
• 依赖局域网连接，跨网络需额外配置
• 默认端口16021需在防火墙放行

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/rstierli/nanoleaf/SKILL.md
来源类型：GitHub仓库