Homey智能家居控制

技能简介

通过命令行安全控制 Homey 智能家居中枢，支持灯光、温控、插座等设备的开关、调光、调色及温度调节，同时可查看设备状态、管理区域和触发自动化流程。

能做什么

• 控制设备开关、亮度、颜色、温度
• 查看设备列表、状态和能力值
• 管理区域，按区域查看设备分布
• 列出并触发自动化流程
• 获取完整的家庭中枢概览

使用说明

1. 安装依赖

cd skills/homey-cli
npm install

2. 创建应用凭证

1. 访问 https://tools.developer.homey.app/tools/app
2. 新建应用，回调地址填写 http://localhost:8787/callback
3. 记录生成的 Client ID 和 Client Secret

3. 配置环境变量

创建 .env 文件：

export HOMEY_CLIENT_ID="your-client-id"
export HOMEY_CLIENT_SECRET="your-client-secret"
export HOMEY_REDIRECT_URL="http://localhost:8787/callback"

4. 登录授权

bash run.sh auth login

按浏览器提示完成 OAuth 流程，令牌自动保存至 ~/.config/homey-cli/。

5. 常用操作

# 选择要控制的 Homey
bash run.sh homey use <homeyId>

# 列出所有设备
bash run.sh devices list

# 开灯/关灯
bash run.sh devices on <deviceId>
bash run.sh devices off <deviceId>

# 调光至 40%
bash run.sh devices dim <deviceId> 0.4

# 设置色温或颜色
bash run.sh devices color <deviceId> #FF8800

# 设置目标温度
bash run.sh devices temperature <deviceId> 21.5

# 读取当前温度
bash run.sh devices read <deviceId> measure_temperature

# 触发自动化流程
bash run.sh flows trigger <flowId>

输入与输出

见下方输入与输出表格。

风险提示

• 仅支持白名单内的能力操作，默认允许：onoff、dim、light_hue、light_saturation、light_temperature、target_temperature
• 不支持删除设备、修改流程、更改应用设置等破坏性操作
• 需妥善保管 OAuth 凭证，避免泄露
• 设备 ID 需通过 list 命令查询获取，不支持模糊名称匹配

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/krausefx/homey-cli/SKILL.md
来源类型：GitHub 仓库