AgentSkillsCN

nanoleaf

通过 Picoleaf CLI 控制 Nanoleaf 灯板。用于开启/关闭 Nanoleaf、调节亮度、设置颜色（RGB/HSL）、改变色温，或任何 Nanoleaf 照明控制。

SKILL.md
--- frontmatter
name: nanoleaf
description: Control Nanoleaf light panels via the Picoleaf CLI. Use for turning Nanoleaf on/off, adjusting brightness, setting colors (RGB/HSL), changing color temperature, or any Nanoleaf lighting control.
homepage: https://github.com/tessro/picoleaf
metadata: {"clawdbot":{"emoji":"🌈","requires":{"bins":["picoleaf"]},"install":[{"id":"brew","kind":"brew","tap":"paulrosania/command-home","formula":"paulrosania/command-home/picoleaf","bins":["picoleaf"],"label":"Install Picoleaf CLI (brew)"},{"id":"binary","kind":"shell","command":"curl -sL https://github.com/tessro/picoleaf/releases/latest/download/picoleaf_1.4.0_linux_amd64.tar.gz | tar xz -C ~/.local/bin","bins":["picoleaf"],"label":"Install Picoleaf (binary)"}]}}

Picoleaf CLI

Use picoleaf to control Nanoleaf light panels.

Setup

  1. •Find Nanoleaf IP: Check router or use mDNS: dns-sd -Z _nanoleafapi
  2. •Generate token: Hold power button 5-7 sec until LED flashes, then within 30 sec run: curl -iLX POST http://<ip>:16021/api/v1/new
  3. •Create config file ~/.picoleafrc:
    ini
    host=<ip>:16021
access_token=<token>

Power

  • •picoleaf on - Turn on
  • •picoleaf off - Turn off

Brightness

  • •picoleaf brightness <0-100> - Set brightness percentage

Colors

  • •picoleaf rgb <r> <g> <b> - Set RGB color (0-255 each)
  • •picoleaf hsl <hue> <sat> <light> - Set HSL color
  • •picoleaf temp <1200-6500> - Set color temperature in Kelvin

Examples

  • •Warm dim light: picoleaf on && picoleaf brightness 30 && picoleaf temp 2700
  • •Bright blue: picoleaf on && picoleaf brightness 100 && picoleaf rgb 0 100 255
  • •Turn off: picoleaf off

Notes

  • •Default port is 16021
  • •Token generation requires physical access to the Nanoleaf controller
  • •Multiple commands can be chained with &&