Control Nanoleaf light panels via the Picoleaf CLI to manage power, brightness, and color settings programmatically.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install nanoleaf
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 nanoleaf 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 Nanoleaf Lighting Control?
The Nanoleaf skill provides a streamlined interface for interacting with Nanoleaf smart light panels through the Picoleaf CLI. By integrating this capability into your workflow, you can automate your environmental lighting to match your focus state, time of day, or specific development tasks. This tool is a perfect example of how Openclaw Skills can bridge the gap between software agents and physical hardware.
Built for developers who value automation, this skill enables precise control over RGB values, HSL settings, and color temperature. Whether you are building a custom focus mode or integrating lighting cues into your CI/CD pipeline, this skill offers the low-latency, command-line control needed for high-performance automation.
Nanoleaf Lighting Control Use Cases
- Automating office lighting based on meeting status or time of day.
- Creating visual alerts for build failures or deployment successes using RGB triggers.
- Building custom focus mode scripts that dim lights and set specific color temperatures.
- Remote management of smart lighting setups via a centralized AI agent.
How Nanoleaf Lighting Control Works
- The AI agent invokes the picoleaf CLI with specific parameters (e.g., on, off, or color settings).
- The CLI reads the local configuration file located at ~/.picoleafrc to retrieve the device IP and access token.
- A network request is sent to the Nanoleaf controller via the local API on port 16021.
- The Nanoleaf panels update their state immediately based on the provided command.
Nanoleaf Lighting Control Setup
To use this within the Openclaw Skills ecosystem, you must first install the Picoleaf CLI and configure your credentials.
1. Install the CLI
Using Homebrew:
brew tap paulrosania/command-home
brew install paulrosania/command-home/picoleaf
Or via binary download:
curl -sL https://github.com/tessro/picoleaf/releases/latest/download/picoleaf_1.4.0_linux_amd64.tar.gz | tar xz -C ~/.local/bin
2. Authentication
Find your Nanoleaf IP using mDNS: dns-sd -Z _nanoleafapi. Then, hold the power button on your Nanoleaf controller for 5-7 seconds until the LED flashes. Run the following command within 30 seconds to get your token:
curl -iLX POST http://<ip>:16021/api/v1/new
3. Configuration
Create a file at ~/.picoleafrc with your details:
host=<ip>:16021
access_token=<token>
Nanoleaf Lighting Control Data Schema & Taxonomy
The skill relies on a simple INI-based configuration schema to maintain persistence and connectivity. Data is structured as follows:
| Setting | Type | Description |
|---|---|---|
| host | String | The IP address and port (default 16021) of the Nanoleaf controller. |
| access_token | String | The unique API token generated during the physical pairing process. |
Command parameters use standard types: Integers for brightness (0-100), RGB (0-255), and Kelvin temperature (1200-6500).
Nanoleaf Lighting Control Advanced Features
- Chaining commands using shell operators like && for complex lighting transitions.
- Granular color control using HSL (Hue, Saturation, Lightness) for precise aesthetics.
- Integration with mDNS for dynamic IP discovery in changing network environments.
- Low-overhead binary execution suitable for lightweight Openclaw Skills implementations.
SKILL.md
Loading
Related Openclaw Skills
PayRail402
A centralized financial control plane for tracking AI agent transactions across traditional and on-chain payment rails.
MoltyChan
An anonymous textboard for AI agents to communicate and share thoughts without accounts or human intervention.
claw-screener
A professional-grade stock screener that merges Williams %R technical indicators with Warren Buffett-style fundamental analysis for US and Thai markets.
Portfolio Tracker
A comprehensive CLI and web-based tool for tracking stock and crypto portfolios with real-time price updates and dividend analytics.
Bitrix24 AI Assistant
An intelligent interface for Bitrix24 that allows business owners to manage CRM, tasks, and team schedules using natural language.
Frankenstein
A sophisticated synthesis engine that merges the strengths of multiple AI agents into a single, high-performance skill.
Featured*
