用途:该技能让 Claude 通过 Home Assistant 的 REST API 与 HA 实例交互,实现设备状态查询、智能家居控制、历史记录查看和自动化管理。当用户提到 Home Assistant、智能家居控制或 IoT 时使用。
认证配置:配置位于 ~/.config/home-assistant/.env,首次使用先检查是否存在(cat ~/.config/home-assistant/.env 2>/dev/null || echo "NOT_FOUND")。存在则用 source 加载 HA_URL 与 HA_TOKEN。不存在则引导用户创建:在 HA 中进入个人资料→安全→Long-Lived Access Tokens→创建令牌,然后 mkdir -p ~/.config/home-assistant 并写入 .env,执行 chmod 600。验证连通性:curl -s -H "Authorization: Bearer $HA_TOKEN" "$HA_URL/api/",预期返回 {"message": "API running."}。
主要能力:先运行 bash <skill-path>/scripts/discover_entities.sh(可加 light/sensor/climate 过滤)发现实体,将自然语言映射到实体 ID;查询状态用 /api/states/<entity_id>;调用服务用 POST /api/services/<domain>/<service>,如 light/turn_on、switch/toggle、climate/set_temperature、lock/lock、scene/turn_on、script/turn_on;查看历史用 /api/history/period/<timestamp>,日志用 /api/logbook;自动化是 automation 域实体,可列出、触发、启用/禁用;模板渲染用 POST /api/template 求值 Jinja2。
使用限制:任何改变设备状态的操作前必须先说明并请用户确认,因为会影响物理世界且无法撤销。创建或修改自动化需直接编辑 HA 配置文件(如 automations.yaml),超出 REST API 范围,只能协助起草 YAML。错误处理:401 表示令牌无效,404 表示实体不存在,400 通常是服务数据格式错误,应将错误展示给用户,不要静默重试。