Control Philips Hue Lighting with AI — How to Use the openhue Skill
機械翻訳 / Machine-translated
Original article: Control Philips Hue Lighting with AI — How to Use the openhue Skill (cccskills)
Skill page: openhue
Key takeaways from this article
If you use Philips Hue lighting, installing openhue lets you ask an AI agent to control your lights in plain language.
You can request things like turning lights on or off, adjusting brightness and color temperature, controlling an entire room at once, and switching scenes.
This article walks you through example requests, installation steps, prerequisites such as the Hue Bridge and OpenHue CLI, and what the skill cannot do.
The agent receives your request, runs an openhue command, and the lighting changes immediately.
For example, before going to bed, you might say:
I'm about to sleep — set the bedroom lights to dim and warm
This skill includes a preset example for bedtime use.
It turns on the entire bedroom at brightness 20 and color temperature 450, by running a command like this:
openhue set room "Bedroom" --on --brightness 20 --temperature 450
You don't need to specify each light individually.
The room name goes in place of "Bedroom," and all the lights in that room change together.
openhue is a skill that teaches an agent how to use the OpenHue CLI to control lighting through the Hue Bridge.
It is included in the GitHub repository openclaw/openclaw and consists of just a single file, SKILL.md.
Operations are divided into three units: lights, rooms, and scenes.
| Unit | What you can request |
|---|---|
| View lists | Display a list of lights, rooms, or scenes |
| Light | Turn on/off, brightness (0–100), color temperature (153–500 mirek), color (color name or hex code like #FF5500) |
| Room | Turn the entire room on/off, adjust brightness, adjust color temperature |
| Scene | Activate a saved scene by specifying the room |
Mapped to everyday use, the distinction is straightforward.
Use light-level control for "just this lamp," and room-level control for "the whole room."
When you want to bring back a familiar atmosphere, just call it by scene name — like Relax or Concentrate.
Color temperature is a number representing the warmth or coolness of light, and mirek is its unit.
In the preset examples, 450 corresponds to warm light and 250 to cool light — the higher the number, the warmer the tone.
Adding the skill itself takes just one command or a single request to your agent.
If you're comfortable using a terminal, run the following command.
You can choose which agent to install it into — Claude Code, Codex, or others — when you run it.
npx skills add https://github.com/openclaw/openclaw --skill openhue
If you're not familiar with the terminal, send the following message to your agent.
It will handle everything from reviewing the contents to placing the files.
Please install the following Agent Skill.
https://github.com/openclaw/openclaw/tree/main/skills/openhue
First, check the contents of SKILL.md and any accompanying files to confirm there is no suspicious behavior (such as sending data externally or reading credentials), then place them in ~/.claude/skills/openhue/ for Claude Code, or ~/.agents/skills/openhue/ for Codex.
The installation location varies depending on your agent and the scope of use.
| Agent | Use across all projects | Use in a specific project |
|---|---|---|
| Claude Code | ~/.claude/skills/ | .claude/skills/ |
| Codex | ~/.agents/skills/ | .agents/skills/ |
Installing the skill alone will not move your lights — you also need to set up the OpenHue CLI and your Hue Bridge separately.
Follow these steps in order:
brew install openhue/cli/openhue-cli with Homebrew to install the OpenHue CLI.openhue get room to see a list of your rooms.Full details on the OpenHue CLI are available on the OpenHue CLI page.
When making a request, include the target room and the desired state.
Here are three common scenarios.
Turn off all the lights in the bedroom
The entire bedroom turns off, so you no longer have to switch off each light one by one before bed.
Set the work room brightness to 100 and color temperature to 250
The entire work room switches to bright, cool-white light.
Ask before a focused work session and you won't need to stop what you're doing to adjust the lighting.
Set the living room to movie mode
The living room lights stay on but dim down to brightness 10.
When you want to use a saved scene, just ask by name — for example, "activate the Relax scene in the bedroom."
The table below shows preset settings for different situations.
Use these as a reference when specifying values in your requests.
| Situation | Example room | Brightness | Color temperature | Light impression |
|---|---|---|---|---|
| Before bed | Bedroom | 20 | 450 | Dim, warm |
| Work | Work room | 100 | 250 | Bright, cool |
| Movie | Living room | 10 | None specified | Dim |
If you're not sure of the room or scene names, just ask: "Show me the list of rooms" or "Show me the list of scenes."
You can check registered names through the OpenHue CLI's list display.
Before using the skill, check the type of bulbs you have and which devices are out of scope.
Color settings only apply to color-capable bulbs — white-only bulbs cannot have their color changed.
The following devices and features also cannot be controlled with this skill:
Be mindful of scope when controlling lights shared with family members.
Room-level requests will change all the lights in that room.
In rooms where someone is present, specifying a light by name will help you limit the scope safely.
The license is MIT.
Before installing, read the contents of SKILL.md and confirm what commands will be executed.
Since there is only one file included, the review burden is minimal.
If you want to hand off control of other devices to your agent as well, these two skills work well in the same scenarios.
sonoscli is a skill for controlling playback, pause, and volume on Sonos speakers on your local network.
You can combine it with openhue to dim the lights and then start playing music in one flow.
eightctl is a skill for checking the status of an Eight Sleep Pod and adjusting its power and temperature.
You can change your bedding settings at the same time you dim the bedroom lights.
No. openhue controls lighting through the Hue Bridge, so having a Bridge on your local network is a requirement.
Not for color changes. Color settings only apply to color-capable bulbs, so check what type of bulbs you have before using this feature.
This skill does not include commands for scheduling. It covers listing lights, rooms, and scenes, as well as operating them. It is designed to change lighting in response to a request at the time you make it.
No. HomeKit scenes and shortcuts are out of scope — use Apple's Home app or Shortcuts for those.
openhue is a skill that lets you delegate Philips Hue lighting control to an agent — turning lights on and off, adjusting brightness, color, and color temperature, operating entire rooms, and switching scenes.
Running it requires the OpenHue CLI and a Hue Bridge; on first use, press the Bridge button to complete pairing.
Once everything is set up, start by checking the list of rooms and try turning off the bedroom lights first.
The installation command and full description are available on the cccskills page.
This article is a repost of the cccskills editorial piece "Control Philips Hue Lighting with AI — How to Use the openhue Skill."
Details about the skill and installation instructions can be found on the cccskills openhue page.