Home Assistant命令行控制

技能简介

hass-cli 是一个命令行工具，用于直接控制 Home Assistant 中的设备和自动化流程，无需打开网页界面即可完成常见操作。

业务背景

运维和智能家居管理人员常需频繁检查或调整设备状态，反复打开网页界面效率低下。通过命令行工具可直接批量查询灯光、传感器等设备状态，快速触发自动化场景，特别适合值班巡检、脚本化运维等场景，将设备管理从图形界面操作转为可复用的指令流。

落地案例：物业技术人员夜间巡查时，无需携带电脑登录后台，通过手机终端执行命令即可批量获取各楼层照明和空调运行状态。发现某区域灯光异常后，直接调用服务重启该回路；遇突发情况时，一键触发预设的应急自动化流程，同步关闭公共区域非必要用电并启动安防模式。

能做什么

• 查询和控制智能设备状态（灯光、开关、传感器等）
• 触发或停止自动化规则
• 查看实体列表和详细信息
• 调用服务执行特定动作
• 批量执行设备命令

使用说明

安装步骤：

1. 确保已安装 Python 3.8 或更高版本
2. 执行安装命令：pip install homeassistant-cli
3. 配置 Home Assistant 访问地址和令牌：hass-cli --server http://homeassistant.local:8123 --token YOUR_TOKEN
4. 验证连接：hass-cli info

常用命令示例：

• 列出所有实体：hass-cli entity list
• 获取实体状态：hass-cli state get light.living_room
• 切换设备状态：hass-cli state toggle switch.kitchen_light
• 触发服务：hass-cli service call light/turn_on --arguments entity_id=light.bedroom

输入与输出

见下方输入与输出表格。

风险提示

• 需妥善保管访问令牌，避免泄露导致未授权访问
• 批量操作前建议先测试单条命令，防止误操作影响多个设备
• 网络不稳定时命令可能执行失败，需检查 Home Assistant 服务状态
• 部分高级功能需要管理员权限令牌

来源信息

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