宜家智能家居控制

技能简介

该技能通过Python SDK连接IKEA Dirigera智能家庭中枢，实现灯光、插座、场景及控制器的远程管理与自动化操作。

业务背景

帮助已采购IKEA Dirigera方案的企业快速打通智能照明与业务系统的联动。行政或设施管理人员可通过程序化指令批量管控办公空间的灯光场景，替代手动App操作，实现会议室一键备会、工位随考勤亮灯等自动化流程，提升空间管理效率并减少能源浪费。

落地案例：某联合办公空间运营方将Dirigera接入自研的工位预约系统：当员工扫码签到后，系统自动调用API开启对应区域灯具并调节至5000K冷白光；检测到该区域30分钟无人活动后，自动触发节能场景降低亮度。晚间保洁时段，后台统一关闭所有插座供电，避免空气净化器等设备空转耗电。

能做什么

• 开关灯具并调节亮度与色温
• 控制智能插座的通断电状态
• 触发预设场景（如睡眠模式）
• 查询设备在线状态与电池电量
• 自动发现Dirigera中枢IP地址
• 生成API访问令牌

使用说明

步骤1：安装依赖

pip install dirigera

步骤2：查找中枢IP

python scripts/find_dirigera_ip.py
# 或指定子网
python scripts/find_dirigera_ip.py --subnet 192.168.1.0/24

步骤3：生成访问令牌

令牌生成需用户物理操作：

python scripts/generate_token_wrapper.py <dirigera-ip> &

启动后立即告知用户：”请按下Dirigera中枢底部的ACTION按钮，完成后告诉我。”待用户确认后，从文件读取令牌：

from pathlib import Path
token = Path("dirigera_token.txt").read_text().strip()

步骤4：连接并控制设备

import dirigera
hub = dirigera.Hub(token=token, ip_address="<ip>")

# 获取设备
light = hub.get_light_by_name(lamp_name="卧室灯")

# 正确访问状态（注意.attributes层级）
if light.is_reachable:
    light.set_light(lamp_on=True)
    light.set_light_level(light_level=75)

输入与输出

见下方输入与输出表格。

风险提示

• 令牌生成必须物理按压中枢按钮，无法纯软件完成
• 设备状态位于.attributes属性下，直接访问顶层属性会报错
• 操作前务必检查device.is_reachable避免指令失效
• 修改设置后调用.reload()同步最新状态

来源信息

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