让 AI 成为你的智能家居管家

—— 从零搭建 Home Assistant + Hermes Agent 联动方案

目录

一、为什么需要把 Hermes Agent 接入 Home Assistant？

二、Hermes Agent 的两种集成方式

三、手把手：三步完成配置

四、四大核心工具详解

五、Gateway 实时事件监听

六、安全机制：哪些操作被禁止

七、实战：三个超有用场景

八、总结：你的家，AI 说了算

────────────────────────────────────────────────────────────

一、为什么需要把 Hermes Agent 接入 Home Assistant？

你家里是不是也有一堆智能设备——智能灯泡、智能插座、温控器、摄像头……但问题来了：这些设备各管各的，想用一句话控制全屋？门都没有。

Home Assistant 是个好东西，开源、免费、功能强劲，但它最大的短板是——没有 AI。你想跟它聊天控家电？想多了。

而 Hermes Agent 呢，是个能听懂人话、能调 API 的 AI Agent，但它本身不懂你家有什么设备。

所以，把两者绑在一起，就是让 AI 管家接管你的智能家居——你只管说话，它来干活。这才是智能家居该有的样子，对吧？

━ 整体架构：Hermes Agent 与 Home Assistant 的双通道通信

二、Hermes Agent 的两种集成方式

Hermes Agent 和 Home Assistant 的结合不是随意连一根线那么简单，而是用了两条通道，各干各的活：

简单说：通道 1 是 ‘耳朵’（听设备汇报），通道 2 是 ‘手脚’（帮设备干活）。

━ 四大核心工具一览

三、手把手：三步完成配置

配置实则就三步，比泡面还简单（泡面要等三分钟，这步更快）。

第一步：创建 Long-Lived Access Token

打开你的 Home Assistant 面板 → 点击左侧边栏你的名字 → 往下翻找到 “Long-Lived Access Tokens” → 点 “Create Token”，取个名字列如 “Hermes Agent” → 复制 token。搞定。

第二步：配置环境变量

编辑 ~/.hermes/.env 文件，加上这两行：

# ~/.hermes/.env
HASS_TOKEN=你的long-lived-access-token
HASS_URL=http://192.168.1.100:8123

# 如果 HA 跑在局域网默认端口可以省略 HASS_URL

只要设了 HASS_TOKEN，homeassistant toolset 就会自动激活，Gateway 和设备控制工具同时上线。

第三步：启动 Gateway

hermes gateway

启动后，Home Assistant 就会作为其中一个连接平台出目前网关列表里，跟 Telegram、Discord 那些平起平坐。

四、四大核心工具详解

Hermes Agent 注册了四个工具，相当于给 AI 配了四样武器：

ha_list_entities — 列出设备

列出家中所有设备实体，支持按 domain（如 light、climate、sensor）或 area（如 living room、bedroom）过滤。相当于你的 ‘设备清单’。

ha_get_state — 查看状态

查询单个设备的详细状态，包括亮度、温度、传感器读数等所有属性。相当于 ‘设备体检报告’。

ha_list_services — 查看可执行操作

列出某个设备域下所有可用的控制服务。列如 climate 域下可以 set_temperature、set_hvac_mode 等等。相当于 ‘技能手册’。

ha_call_service — 执行控制

真正干活的那个。指定 domain、service 和 entity_id，AI 就能帮你开灯、调温度、开关窗帘。

五、Gateway 实时事件监听

Gateway 的实时事件功能是这套方案的杀手锏——它通过 WebSocket 订阅 Home Assistant 的 state_changed 事件，一旦设备状态变化，立马把消息推给 AI Agent。

⚠️ 重大：必须配置事件过滤器

默认情况下没有任何事件被转发。你至少得配置 watch_domains、watch_entities 或 watch_all 中的一个，不然 AI 根本不会收到任何设备变动通知。不配置 = 白配。

platforms:
homeassistant:
enabled: true
extra:
watch_domains:
– climate
– binary_sensor
– alarm_control_panel
– light
watch_entities:
– sensor.front_door_battery
ignore_entities:
– sensor.uptime
– sensor.cpu_usage
cooldown_seconds: 30

# ~/.hermes/config.yaml

提议先从关注 climate、binary_sensor 和 alarm_control_panel 开始，这三个覆盖了温控、门窗传感器和安防面板，是最实用的自动化触发器。

六、安全机制：哪些操作被禁止

安全这块做得很到位——Hermes Agent 明确禁用了这些高危 domain：

❌ shell_command — 防止 AI 执行任意 Shell 命令

command_line — 防止通过命令控制传感器或开关

python_script / pyscript — 阻止 Python 脚本执行

hassio — 防止控制 add-on、重启主机等管理员操作

rest_command — 阻断 SSRF 攻击向量

同时 entity_id 还会经过正则校验，防止注入攻击。这安全防线比你家防盗门还严实。

七、实战：三个超有用场景

光说不练假把式，来几个实际场景：

场景 1：早间起床模式

你对 AI 说：‘启动我的早上模式’——AI 自动执行：卧室灯光渐亮 → 温控调到 22 度 → 厨房音箱打开播放新闻。不用设自动化规则，一句话搞定。

场景 2：安防检查

出门前你问：‘家里安全吗？’——AI 自动：检查所有门窗传感器 → 查看安防面板状态 → 检查门锁状态 → 回复你‘所有门窗关闭、安防已布防、门锁已锁好’

场景 3：门开了！⚡

Gateway 监听模式下的终极用法：前门传感器触发 → AI 自动收到‘前门被打开’事件 → AI 自动：查看传感器详情 → 打开走廊灯 → 给你发通知‘前门打开了，走廊灯已开启’

八、总结：你的家，AI 说了算

Home Assistant + Hermes Agent 的组合，本质上就是把开源智能家居的 ‘设备层’ 和 AI Agent 的 ‘智能层’ 打通了。一个负责管硬件，一个负责动脑子。

配置虽然不复杂（三步搞定），但玩法才是重头戏。Gateway 实时事件监听 + 四大控制工具，让你既能 ‘被动响应’ 设备变化，又能 ‘主动控制’ 每一个设备。

如果你的智能家居还在用一个个独立的 App 来控制，是时候升级了。让 AI 管家来替你把全屋设备串成一条线，一句话搞定一切。这才是真正的智能生活。