【openclaw实用Skill】openhue 技能

通过OpenHue CLI控制Philips Hue灯光和场景。提供完整的Hue Bridge控制功能,包括发现设备、设置灯光、调整亮度、颜色和场景。

技能概述

openhue 技能使用OpenHue CLI工具来控制Philips Hue智能灯光系统。通过Hue Bridge,用户可以控制单个灯光、房间和场景。该技能提供了完整的灯光管理功能,包括发现Hue Bridge、设置、读取灯光状态、开关控制、亮度调整、颜色设置和场景切换。OpenHue CLI提供了简单而强大的命令行界面,使得通过命令或脚本控制Hue灯光变得简单易用。

下载地址:https://github.com/openclaw/openclaw/tree/main/skills

主要功能

• 设备发现: 自动发现网络中的Hue Bridge
• 引导设置: 提供引导式设置流程
• 灯光控制: 开关、亮度、颜色控制
• 房间控制: 按房间控制多个灯光
• 场景切换: 切换预定义的灯光场景
• 状态读取: 读取灯光、房间和场景状态

触发条件

在以下情况下应该调用此技能:

• 用户需要控制Philips Hue灯光
• 用户需要设置Hue Bridge
• 用户需要调整灯光亮度或颜色
• 用户需要切换灯光场景
• 用户需要读取灯光状态

使用场景

场景1: 开关灯光

用户需要打开或关闭特定的灯光,使用开关控制命令。

场景2: 调整亮度

用户需要调整灯光的亮度,使用亮度控制命令。

场景3: 设置颜色

用户需要改变灯光的颜色,使用颜色控制命令。

处理过程

1. 设置

发现Hue Bridge并进行引导设置:

openhue discover openhue setup

2. 读取状态

读取灯光、房间和场景的状态:

openhue get light --json openhue get room --json openhue get scene --json

3. 控制灯光

开关灯光、调整亮度和颜色:

openhue set light --on openhue set light --off openhue set light --on --brightness 50 openhue set light --on --rgb #3399FF

4. 切换场景

切换到预定义的场景:

openhue set scene

输入要求

使用此技能时,用户需要提供:

• 操作类型: 要执行的操作(读取、设置等)
• 目标: 灯光、房间或场景的ID或名称
• 参数(可选): 亮度、颜色等参数

输出说明

技能将提供:

• 设备信息: 发现的Hue Bridge信息
• 状态数据: 灯光、房间和场景的当前状态
• 操作确认: 控制操作的执行结果

使用示例

示例: 打开灯光并设置亮度和颜色

openhue set light --on --brightness 50 --rgb #3399FF

最佳实践

1. 首次设置: 首次使用时运行`openhue setup`进行引导设置
2. 设备发现: 使用`openhue discover`查找网络中的Hue Bridge
3. 使用房间: 当灯光名称有歧义时,使用`--room "Room Name"`参数
4. Bridge按钮: 设置过程中可能需要按下Hue Bridge按钮
5. 读取状态: 使用`--json`参数获取机器可读的状态数据

注意事项

• 设置过程中可能需要按下Hue Bridge按钮
• 当灯光名称有歧义时,使用`--room "Room Name"`参数
• 确保Hue Bridge和设备在同一网络中
• 首次使用需要完成引导设置