playbooks

home / skills / openclaw / openclaw / openhue

openhue skill

/skills/openhue

This skill helps you control Philips Hue lights and scenes via the OpenHue CLI, including on/off, brightness, color, and room-scoped actions.

npx playbooks add skill openclaw/openclaw --skill openhue

Review the files below or copy the command above to add this skill to your agents.

Files (1)
SKILL.md
2.4 KB
---
name: openhue
description: Control Philips Hue lights and scenes via the OpenHue CLI.
homepage: https://www.openhue.io/cli
metadata:
  {
    "openclaw":
      {
        "emoji": "💡",
        "requires": { "bins": ["openhue"] },
        "install":
          [
            {
              "id": "brew",
              "kind": "brew",
              "formula": "openhue/cli/openhue-cli",
              "bins": ["openhue"],
              "label": "Install OpenHue CLI (brew)",
            },
          ],
      },
  }
---

# OpenHue CLI

Use `openhue` to control Philips Hue lights and scenes via a Hue Bridge.

## When to Use

✅ **USE this skill when:**

- "Turn on/off the lights"
- "Dim the living room lights"
- "Set a scene" or "movie mode"
- Controlling specific Hue rooms or zones
- Adjusting brightness, color, or color temperature

## When NOT to Use

❌ **DON'T use this skill when:**

- Non-Hue smart devices (other brands) → not supported
- HomeKit scenes or Shortcuts → use Apple's ecosystem
- TV or entertainment system control
- Thermostat or HVAC
- Smart plugs (unless Hue smart plugs)

## Common Commands

### List Resources

```bash
openhue get light       # List all lights
openhue get room        # List all rooms
openhue get scene       # List all scenes
```

### Control Lights

```bash
# Turn on/off
openhue set light "Bedroom Lamp" --on
openhue set light "Bedroom Lamp" --off

# Brightness (0-100)
openhue set light "Bedroom Lamp" --on --brightness 50

# Color temperature (warm to cool: 153-500 mirek)
openhue set light "Bedroom Lamp" --on --temperature 300

# Color (by name or hex)
openhue set light "Bedroom Lamp" --on --color red
openhue set light "Bedroom Lamp" --on --rgb "#FF5500"
```

### Control Rooms

```bash
# Turn off entire room
openhue set room "Bedroom" --off

# Set room brightness
openhue set room "Bedroom" --on --brightness 30
```

### Scenes

```bash
# Activate scene
openhue set scene "Relax" --room "Bedroom"
openhue set scene "Concentrate" --room "Office"
```

## Quick Presets

```bash
# Bedtime (dim warm)
openhue set room "Bedroom" --on --brightness 20 --temperature 450

# Work mode (bright cool)
openhue set room "Office" --on --brightness 100 --temperature 250

# Movie mode (dim)
openhue set room "Living Room" --on --brightness 10
```

## Notes

- Bridge must be on local network
- First run requires button press on Hue bridge to pair
- Colors only work on color-capable bulbs (not white-only)

Overview

This skill lets you control Philips Hue lights and scenes using the OpenHue CLI. It provides direct commands to list lights, rooms, and scenes and to change power state, brightness, color, and color temperature. It requires a Hue Bridge on your local network and initial pairing with the bridge button.

How this skill works

OpenHue issues commands to the Hue Bridge over your local network, targeting individual lights, rooms, zones, or predefined scenes. You can set power on/off, brightness (0–100), color temperature (Mirek values), and RGB/ named colors for color-capable bulbs. Scenes can be activated for specific rooms and quick presets combine common settings for bedtime, work, or movie modes.

When to use it

  • Turning lights on or off for a single bulb, room, or zone
  • Dimming lights or setting specific brightness levels
  • Changing color or color temperature on color-capable bulbs
  • Activating saved Hue scenes for rooms or areas
  • Applying quick presets like bedtime, work, or movie mode

Best practices

  • Ensure the Hue Bridge is on the same local network as the machine running OpenHue
  • Press the bridge button on first run to complete pairing before issuing commands
  • Use room or scene commands for coordinated changes across multiple lights
  • Check bulb capabilities before sending color commands—white-only bulbs ignore color
  • Keep brightness and temperature values within supported ranges (brightness 0–100, mirek 153–500)

Example use cases

  • Automate ‘Movie mode’: dim living room to 10% with one command
  • Quickly set ‘Work mode’ in the office to 100% brightness and cool temperature
  • Turn off all bedroom lights at night using a single room command
  • Activate a ‘Relax’ scene in the bedroom before winding down
  • Adjust a specific lamp’s RGB color by name or hex for ambiance

FAQ

Do colors work on every Philips Hue bulb?

No. Color commands only work on color-capable bulbs; white-only bulbs will ignore color changes.

What do I need to do before the first run?

Make sure the Hue Bridge is on your local network and press its physical button during the initial pairing step.