title: “Openhue — Control Philips Hue lights, scenes, rooms via OpenHue CLI” sidebar_label: “Openhue” description: “Control Philips Hue lights, scenes, rooms via OpenHue CLI”

{/* 本页面由 website/scripts/generate-skill-docs.py 根据技能对应的 SKILL.md 文件自动生成。请直接编辑源文件 SKILL.md，而非此页面。 */}

Openhue

通过 OpenHue CLI 控制 Philips Hue 灯具、场景及房间。

技能元数据

参考：完整的 SKILL.md 文件

:::info 以下是当触发该技能时 Hermes 会加载的完整技能定义。技能处于激活状态时，智能体将依据此内容执行操作。

::

OpenHue CLI

通过 Hue Bridge 从终端控制 Philips Hue 灯具及场景。

先决条件

# Linux (pre-built binary — releases ship tarballs, not bare binaries)
curl -sL "https://github.com/openhue/openhue-cli/releases/latest/download/openhue_Linux_x86_64.tar.gz" \
  | tar -xz -C /tmp openhue \
  && install -m 0755 /tmp/openhue ~/.local/bin/openhue
# (use openhue_Linux_arm64.tar.gz on ARM64)

# macOS
brew install openhue/cli/openhue-cli

首次使用时，需按下 Hue Bridge 上的按钮进行配对。该桥接器必须处于相同的局域网中。

适用场景

• “打开/关闭灯光”
• “调暗客厅的灯光”
• “设置场景”或“电影模式”
• 控制特定的 Hue 房间、区域或单个灯泡
• 调整亮度、颜色或色温

常用命令

列出资源

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

控制灯光

# 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"

控制室

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

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

场景

openhue set scene "Relax" --room "Bedroom"
openhue set scene "Concentrate" --room "Office"

快速预设

# 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

# Everything off
openhue set room "Bedroom" --off
openhue set room "Office" --off
openhue set room "Living Room" --off

备注

• Bridge设备必须与运行Hermes的机器处于同一局域网内。
• 首次使用时，需手动按下Hue Bridge上的按钮进行授权。
• 颜色功能仅适用于支持色彩显示的灯泡（不支持纯白光型号）。
• 灯光名称和房间名称对大小写敏感——请使用openhue get light命令查看准确名称。
• 该功能可与cron作业完美结合，实现定时控制灯光亮度（例如睡前调暗灯光，醒来时调亮）。