Homey 智能家居控制
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/sundial-org-awesome-openclaw-skills-homey。
技能介绍
要解决什么问题
家里跑的是 Athom Homey,灯、温控、门锁和传感器都挂在上面,但 AI 助手往往没法直接「说一句话就执行」。本技能背后是 homeycli 与官方 homey-api,把设备列表、开关、能力读写、场景(Flows)和房间(Zones)收成可被 Agent 调用的命令行能力,并支持 --json 输出,方便程序化决策。
技能如何工作
认证分两条路:局域网/VPN 用 Homey Web App 的本地 API Key + 网关 IP;云端/无界面主机 用 Developer Tools 里的 Personal Access Token。连接确认后,典型用法包括:
snapshot:一次性拉取当前环境概要,适合 Agent 先建立上下文- 设备控制:
onoff、亮度dim、色温/色相、温控目标target_temperature、门锁locked、音量等(只读类如measure_temperature、alarm_motion用查询而非写入) - Flows 与 Zones:按名称触发自动化或按房间组织设备
- 模糊匹配:设备/Flow 名支持精确、子串与拼写容错(Levenshtein),减少自然语言里轻微笔误导致的「找不到设备」
常见能力类型在文档里有对照表;不确定某设备支持什么时,应先 devices 查看能力列表,避免对传感器执行「开机」类错误操作。
适用边界与注意点
- 运行环境要求 Node.js ≥ 18;未配置认证会出现 No auth configured,需按本地或云端分别写入凭据。
- 多个设备同名或模糊命中多条时,CLI 会返回候选 ID,需用 设备 ID 消歧。
- 本地模式适合 Agent 与 Homey 同网;VPS/远程托管更宜用云端 Token,并注意 Token 权限与轮换。
使用场景
- AI 在家庭网关上跑,用户说「关掉客厅灯」时,Agent 用模糊匹配定位设备并执行 onoff。
- 托管在 VPS 的助手需在上班路上触发 Homey 早晨 Flow,通过云端 Token 远程调用。
- 自动化流程要先读卧室 `measure_temperature`,再决定是否下调空调 `target_temperature`。
- 编写集成脚本前,用带 `--json` 的 devices 列出全屋灯光及能力,供下游逻辑解析。
适合人员
- 在树莓派或家里 NAS 上部署 OpenClaw,希望 Agent 用本地 API Key 直呼 Homey 的极客房主
- 把助手放在云上、仍要遥控家里场景与设备的远程办公者,需配置 Developer Tools 云端 Token
- 把 Homey 能力表与 JSON 输出接入自有自动化编排的智能家居集成工程师
- 习惯用 Flow 做晨间/离家routine、又想让对话助手触发而非只点 App 的家庭自动化维护者