智能家居控制

技能简介

moltbot-ha 是一款命令行工具，用于通过 Home Assistant API 控制智能家庭设备、灯光、场景和自动化流程。该工具内置三级安全确认机制，防止对门锁、报警器、车库门等关键设备的误操作。

能做什么

• 开关灯光、插座、风扇等设备
• 调节亮度、色温等设备属性
• 激活场景与自动化脚本
• 控制温控器、窗帘/车库门
• 查询所有实体状态与列表

使用说明

1. 安装工具

uv tool install moltbot-ha

2. 初始化配置

moltbot-ha config init

按提示输入 Home Assistant 地址（如 http://192.168.1.100:8123），建议选择环境变量存储令牌。

3. 设置访问令牌

export HA_TOKEN="your_token_here"

获取令牌：进入 Home Assistant → 左下角个人资料 → “长期访问令牌” → 创建令牌并复制。

4. 测试连接

moltbot-ha test

5. 常用命令示例

# 列出所有设备
moltbot-ha list

# 开启客厅灯
moltbot-ha on light.living_room

# 设置卧室灯亮度50%
moltbot-ha set light.bedroom brightness_pct=50

# 激活观影场景
moltbot-ha call scene.turn_on entity_id=scene.movie_time

6. 关键操作确认

对门锁、报警器、车库门等执行操作时，工具会返回错误并要求用户确认。获得明确同意后，添加 --force 参数重试：

moltbot-ha on cover.garage --force

输入与输出

见下方输入与输出表格。

项目	内容
输入	Home Assistant URL、HA_TOKEN 长期访问令牌、目标实体ID、操作指令（on/off/toggle/set/call）、可选设备属性参数
输出	设备实时状态、实体完整列表、操作执行结果、关键操作的安全确认提示
适用人群	已部署 Home Assistant 的用户、需 CLI 批量控制设备的开发者、重视操作安全的家庭自动化场景
不包含	Home Assistant 服务器本体、硬件物理安装、Zigbee/Z-Wave 网关配置、图形界面操作

 

风险提示

• 切勿在未获用户明确同意时使用 –force 参数
• 敏感设备（门锁、断路器）可通过配置永久屏蔽
• 令牌泄露可能导致未授权访问家庭网络
• 建议配合 VPN 或本地网络使用，避免公网暴露

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/iamvaleriofantozzi/moltbot-ha/SKILL.md
来源类型：GitHub 开源项目