米家设备控制

技能简介

通过mijiaAPI连接并操控小米米家智能设备，当前支持台灯、智能插座等设备的开关、亮度与色温调节。

业务背景

帮助企业快速接入小米智能家居生态，无需自建硬件平台即可实现办公空间、展厅或员工宿舍的灯光与电源智能化管理。通过统一的API接口，IT管理员可远程批量调控设备状态，降低多地点运维成本，同时支持场景化模式切换，提升空间使用体验。

落地案例：某连锁企业在20个门店部署了米家台灯作为展台照明。总部运营人员通过该技能统一设置营业时间自动开启防蓝光模式保护展品，闭店后远程关闭所有插座杜绝待机耗电。遇到临时活动需调亮灯光时，发送"亮度80"指令即可秒级生效，无需派员现场操作。

能做什么

• 远程开关台灯、智能插座等设备
• 调节灯光亮度（1%-100%）
• 设置色温范围（2700K-6500K）
• 切换阅读、电脑、夜灯、防蓝光等多种预设模式
• 查询设备当前运行状态

使用说明

安装步骤：

1. 进入技能目录：cd /path/to/mijia-skill
2. 安装依赖：uv sync
3. 设置环境变量（设备ID）：export MIJIA_LAMP_DID="your_device_id"
4. 首次运行需扫码登录小米账号

查找设备ID：

from mijiaAPI import mijiaAPI
api = mijiaAPI()
api.login()
devices = api.get_device_list()
for d in devices:
    print(f"{d['name']}: {d['did']}")

常用命令：

cd ~/.clawdbot/skills/mijia
uv run python scripts/lamp_cli.py status    # 查看状态
uv run python scripts/lamp_cli.py on/off/toggle  # 开关/切换
uv run python scripts/lamp_cli.py brightness 50  # 亮度50%
uv run python scripts/lamp_cli.py temp 4000      # 色温4000K
uv run python scripts/lamp_cli.py mode reading   # 阅读模式

输入与输出

见下方输入与输出表格。

风险提示

• 需提前配置小米账号并完成设备绑定
• 设备ID错误会导致指令执行失败
• 网络中断时无法控制设备
• 部分旧款设备可能不支持全部功能

来源信息

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