用AI控制Philips Hue照明 ― openhue技能使用指南
機械翻訳 / Machine-translated
原文链接：用AI控制Philips Hue照明 ― openhue技能使用指南（cccskills）
技能页面：openhue
本文结论
使用Philips Hue照明的用户，安装openhue后即可通过AI代理用自然语言控制照明。
可以控制的内容包括：开关灯、亮度调节、色温调节、按房间批量操作以及场景切换。
本文将依次介绍示例指令、安装步骤、Hue Bridge与OpenHue CLI的准备工作，以及不支持的功能。
代理收到请求后会执行openhue命令，照明状态会立即改变。
例如睡前可以这样说：
睡觉前，把卧室的灯调暗一点，换成暖色
该技能内置了适合睡前的配置示例。
配置为将整个卧室设置为亮度20、色温450并开灯，实际执行的命令如下：
openhue set room "Bedroom" --on --brightness 20 --temperature 450
无需逐一指定每盏灯。
"Bedroom"处填入房间名称，该房间的所有灯光会一并改变。
openhue是一个技能，用于向代理传授如何通过Hue Bridge使用OpenHue CLI控制照明。
它包含在GitHub的openclaw/openclaw仓库中，内容只有一个SKILL.md文件。
操作单位分为灯光、房间和场景三类。
| 操作单位 | 可请求的内容 |
|---|---|
| 查看列表 | 显示灯光、房间、场景的列表 |
| 灯光 | 开关、亮度（0～100）、色温（153～500 mirek）、颜色（颜色名称或如#FF5500的色值代码） |
| 房间 | 整个房间的开关、亮度、色温 |
| 场景 | 指定房间，启用已保存的场景 |
对应日常使用场景，区别很简单：
"只控制这盏灯"用灯光单位，"整个房间"用房间单位。
想恢复常用氛围时，可以用Relax或Concentrate等场景名称来调用。
色温是表示光色的数值，mirek是其单位。
示例配置中450对应暖色，250对应冷色，数值越大颜色越暖。
添加技能本体，可通过命令或向代理发送请求两种方式完成。
如果能使用终端，请执行以下命令。
安装目标（Claude Code或Codex等代理）可在执行时选择。
npx skills add https://github.com/openclaw/openclaw --skill openhue
如果不熟悉终端操作，请将以下内容发送给代理，可以将内容确认到文件放置的全部工作交由代理完成：
次の Agent Skill をインストールしてください。
https://github.com/openclaw/openclaw/tree/main/skills/openhue
まず SKILL.md と付属ファイルの中身を確認し、不審な処理（外部への送信、認証情報の読み取りなど）がないことを確かめてから、Claude Code なら ~/.claude/skills/openhue/、Codex なら ~/.agents/skills/openhue/ に配置してください。
存放位置因代理和使用范围而有所不同。
| 代理 | 在所有项目中使用 | 在特定项目中使用 |
|---|---|---|
| Claude Code | ~/.claude/skills/ | .claude/skills/ |
| Codex | ~/.agents/skills/ | .agents/skills/ |
仅安装技能无法控制照明，还需要单独准备OpenHue CLI和Hue Bridge。
请按以下步骤操作：
OpenHue CLI的详细信息可在OpenHue CLI页面查阅。
在请求中注明目标房间和希望达到的状态。
以下介绍三种常见使用场景：
把卧室的灯全部关掉
整个卧室熄灯，省去睡前逐一关灯的麻烦。
把工作室的亮度调到100，色温调到250
整个工作室的灯光变为明亮的白色光。
在需要集中精力之前发出请求，无需停下手中的事情去调整照明。
把客厅调成电影模式
客厅灯光保持开启，亮度降至10。
如果想使用已保存的场景，可以用"在卧室启用Relax场景"这样的名称来请求。
各场景的配置示例如下表所示，可作为在请求中指定数值的参考。
| 场景 | 房间示例 | 亮度 | 色温 | 光感 |
|---|---|---|---|---|
| 睡前 | 卧室 | 20 | 450 | 较暗的暖色 |
| 工作 | 工作室 | 100 | 250 | 明亮的冷色 |
| 看电影 | 客厅 | 10 | 不指定 | 较暗 |
如果不知道房间或场景的名称，可以请求"显示房间列表"或"显示场景列表"。
已注册的名称可通过OpenHue CLI的列表显示功能查看。
使用前，请确认灯泡类型和不支持的设备。
颜色设置只对支持彩色的灯泡生效，纯白色灯泡无法更改颜色。
以下设备和功能也不在此技能的控制范围内：
在与家人共用的照明场景中，请注意操作范围。
按房间发出请求时，该房间的所有灯光都会改变。
如果有人正在使用某个房间，建议指定灯光名称来缩小控制范围，更为安全。
许可证为MIT。
安装前请阅读SKILL.md的内容，确认会执行哪些命令。
文件只有一个，确认负担很小。
如果希望将照明以外的设备也交由代理控制，以下两个技能可在相同场景中使用。
sonoscli是一个用于控制本地网络上Sonos音响播放、暂停和音量的技能。
可以与照明控制结合使用，实现关灯后播放音乐的流程。
eightctl是一个可用于查看Eight Sleep Pod状态、控制电源和调节温度的技能。
可以在调暗卧室灯光的同时，一并调整寝具设置。
不能。
openhue通过Hue Bridge控制照明，因此Hue Bridge必须在本地网络上可用。
无法更改颜色。
颜色设置只对支持彩色的灯泡生效，请提前确认手边灯泡的类型。
此技能不包含设置定时任务的命令。
支持的操作为查看列表以及控制灯光、房间和场景。
使用方式为收到请求时当场改变照明状态。
不能。
HomeKit场景和快捷指令不在支持范围内，请使用Apple的家庭应用或快捷指令。
openhue是一个技能，可将Philips Hue的开关、亮度、颜色、色温、按房间批量操作以及场景切换交由代理处理。
运行需要OpenHue CLI和Hue Bridge，首次使用时需按下Bridge上的按钮进行配对。
准备就绪后，请先查看房间列表，从关闭卧室灯光开始尝试。
安装命令和介绍文字可在cccskills页面查看。
本文转载自cccskills的文章「用AI控制Philips Hue照明 ― openhue技能使用指南」。
技能详情和安装方法请访问cccskills的openhue页面。