2026-08-10 • 作者原创首发整理 • 智能家居与 AI 接管

Hermes接入Home Assistant:从七个 App 到一个界面

家里智能设备不算多,但每家一个 App:万和、美的、海尔、米家、石头、iKuai……数了数光家电类就装了七个。记录把 12 台设备全部接进 Home Assistant,并交由 Hermes AI 全面接管的完整实战。

📌 本文由作者 Vanhci 亲测原创整理,微信公众号同步发表。包含完整避坑实录与开源脚本指引。
先说说现状有多乱。
家里智能设备不算多,但每家一个 App:万和管热水器、美的管洗衣机、海尔管冰箱、米家管空气净化器和净水器、石头管扫地机、iKuai 管路由器……
数了数,光家电类 App 就装了七个。手机上翻一屏全是家电,打开哪个还得想半天:调个热水器水温,得找到万和 App,点开等它启动,看个开屏广告,再等连接服务器。就为设个 40 度,两分钟没了,更别说开错App的情况了。
配图 1
我一直想找个统一入口,调研了一番,最后把 12 台设备全部接进了 Home Assistant(HA)——一个开源的智能家居平台。这篇就聊聊 HA 是什么、能干什么、以及我怎么把它跑起来的。
配图 2

一、HA 是什么?为什么选它?

Home Assistant(简称 HA)是一个开源的智能家居中枢,核心使命只有一句话:把不同品牌的设备统一到一个界面里控制。
HA官网:
https://www.home-assistant.io

配图 3
一句话总结:它就是智能家居界的"开源操作系统",把各家厂商的"围墙"一个个凿穿。

二、部署:其实不难,半天搞定

配图 4
部署方式有好几种,我选了最省心的路径:群晖 NAS 上跑 Docker 容器。

群晖 NAS(DS218+)上部署 HA 的核心命令

docker run -d--name homeassistant--network host-v /volume1/docker/homeassistant/config:/config-e TZ=Asia/Shanghai--restart unless-stoppedhomeassistant/home-assistant:stable
几个实用经验:
· 镜像拉不下来是国内的常见问题,换个镜像源(daocloud、lscr.io 等)基本能解决;拉取报 invalid tar header 时,先拉个小镜像验证存储层,别急着怀疑硬盘坏了
· 外网访问推荐 Cloudflare Tunnel(免费、不用公网 IP)或 Tailscale(自己用最省心),Nabu Casa 官方云适合怕折腾的
部署完打开 http://nas地址:8123,就能看到 HA 界面了。

三、接入设备:米家、石头、海尔、美的都能接

配图 5
HA 接入设备的方式很灵活,基本是"开箱即用"。
整体体验比想象中顺利,大部分设备登录账号后就能自动发现。最麻烦的万和热水器厂商没开放接口,靠逆向 App 才接上(详见下文踩坑)。
接入完成后,HA 会自动生成设备实体(传感器、开关、按钮等),我家最终有 191 个实体、16 个集成,全部在一个界面里。

踩过的几个坑

先说说最顺的:石头扫地机、群晖 NAS、小天鹅洗衣机,内置集成或局域网直连,基本一次成功。
再说坑:
· 小米/米家:官方 Xiaomi Home 集成登录反复失败(报"请检查凭据"),换社区集成 xiaomi_miot_auto 扫码登录才通
· 海尔:官方 hOn 集成只认海外账号,国区账号登不上;得换国内版 haier 集成(微信小程序抓包拿 token)
· 万和热水器:厂商没开放接口,只能逆向 App 接入;账号严格单会话,HA 登录会顶掉手机 App,配个家庭子账号就互不影响了

四、仪表盘:把全屋摆在手机上

设备接进来之后,最重要的就是界面。HA 的仪表盘(Dashboard)可以自己排版,我用的是 sections 布局:一个设备一个区块,每台设备挑几个最常用的控制放上去。
比如热水器区块放电源开关、温度调节、当前水温;扫地机区块放开始清洁、回充、电量;净化器放风速档位……手机上滑一屏就是全屋,控制都在卡片上,不用点进详情页。
配图 6
配图 7
HA 的手机 App 体验也很好:在家走内网直连(永不掉线),出门自动切外网,还能语音控制。

五、自动化:让设备自己干活

配图 8
设备能手动控制只是第一步。但说实话,说到自动化,各家 App 其实也都有场景功能——小米有、海尔有、石头也有。那 HA 的自动化强在哪?两点:跨品牌,和本地执行。
先说跨品牌。厂商 App 的自动化只能在自己生态里玩:小米 App 能联动的是米家设备,海尔 App 管不到石头扫地机。而我家设备本来就是混搭的——米家净化器、石头扫地机、万和热水器、小天鹅洗衣机。想让它们协同,厂商 App 根本做不到,HA 可以。
再说本地执行。厂商的自动化大多跑在云端:你设了「PM2.5 高于 50 自动开净化器」,如果家里断网,这个规则就失效了。HA 的自动化跑在 NAS 上,纯本地——断网照常触发,延迟还更低。
还可以用更复杂的条件。比如回家自动开灯:手机连上家里 Wi-Fi、且太阳已经落山,才打开玄关灯,30 秒后自动关。「太阳落山」这种天文条件,厂商 App 里想都不要想。
自动化全在 UI 里点出来,不用写代码。花半小时配两三个场景,你会发现「智能家居」的爽感其实来自这里——不是手机遥控,是它自己知道该干嘛。

六、AI 助手接管:在微信里指挥全屋

设备接完了,最后一步:让 Hermes Agent接管了控制。HA 提供 REST API,拿一个长期访问令牌,AI 就能查状态、发命令:
配图 9
现在我在微信上跟它说"看看家里设备状态",它直接调 HA API 返回结果;说"热水器调到 45 度",它查实体、发命令、确认状态变化。扫地机、洗衣机、路由器,全屋设备都能在聊天里指挥。

其实,这一切都是 Hermes 帮我做的

写到这里回头看,最想说的其实是:上面所有事,几乎都是 Hermes 自己完成的——我就是那个动嘴的人。

从最初在 NAS 上装 HA 开始,镜像拉不下来,是它试了各种源、最后锁定了 lscr.io;DSM 防火墙放行端口,是它 SSH 进 NAS 改的 iptables;Cloudflare Tunnel 配 400 Bad Request,是它翻出 HA 新版把配置迁移到 .storage/http 文件,直接改存储文件解决。这些排查过程我全程没碰电脑,就看着它一步步操作、中途发消息汇报进度。

最夸张的是万和热水器。App 抓包全被 SSL 证书校验堵死,它直接下载 APK 逆向,从 8.7MB 的 JavaScript 里挖出厂商的私有 API 域名,破解了 WebSocket 二进制控制协议,还自己写了一个 HA 自定义集成。中间遇到"手机 App 和 HA 互相踢登录"的硬限制,也是它想到用家庭成员子账号分离两个会话。这些如果是人工来做,光逆向一个 App 就够折腾的。

仪表盘也一样。我说"把每台设备的开关和主要功能展示出来",它去调 HA 的 API 读全部 191 个实体,自动分组排版,一个区块一台设备。我说空调的按钮不对,它查了 HA 新版文档,换成专门的 thermostat 卡片。我说净化器选项是英文,它直接翻到集成的翻译表,发现原因后修好又撤掉——全程我在手机上敲几行字就行。

配图 10
整个过程就好像自己想用的功能动动嘴就给配出来,并且立马就用上了,非常丝滑。
这整套流程我也整理成了可复用的技能模板,放在 GitHub 上:
https://github.com/vanhci/hermes-skills

想自己动手的伙伴可以直接拿去用。
总之,使用下来最大的感受:智能家居的瓶颈从来不是硬件,是生态。每个厂商都想让你留在自己的 App 里,而 HA 这样的开源项目,正是把这些围墙一个个凿穿的钥匙。
是不是有一种秦始皇统一六国的感觉。
如果你也想试试,我的建议是:
  1. 先想清楚要接哪些设备,查一下有没有现成方案(HA 社区基本覆盖了主流品牌)
  2. 从 NAS 或一台旧电脑开始,部署成本很低
  3. 先接 1-2 台设备跑通流程,再逐步扩展
当然,如果你也有个hermes agent就更省心了。
(文中所有技术细节均来自实际部署记录。如需 HA 部署、设备接入的具体操作步骤,欢迎交流。)

#HomeAssistant#hermesagent#智能家电

开源实战仓库:github.com/vanhci/hermes-skills ← 返回目录