基于 Home Assistant 的海尔设备全屋智能集成方案
在 Home Assistant 生态中,海尔智能家居集成插件是目前连接海尔智家设备最成熟的方案之一。它允许我们将空调、热水器、窗帘、开关等各类海尔智能产品无缝接入统一系统,实现真正的全屋智能控制。
需求分析与准备
在动手配置前,建议先梳理一下家里的具体场景:
家庭环境控制
- 夏季空调自动调节温度
- 冬季热水器智能预热
- 窗帘根据光照或时间自动开合
设备管理
- 需要一个统一的控制界面
- 实时查看设备状态
- 支持远程操作
安装与部署
目前主要有两种安装方式,根据你的熟悉程度选择即可。
HACS 一键安装(推荐) 如果你已经安装了 HACS,这是最省心的方式:
- 打开 HACS 界面
- 搜索
haier - 点击安装按钮
手动安装方案 适合对 HomeAssistant 基础操作更熟悉的用户:
- 克隆仓库:
git clone https://gitcode.com/gh_mirrors/ha/haier - 复制文件夹:将
custom_components/haier复制到 HomeAssistant 根目录下的custom_components文件夹
认证与配置
安装完成后,进入配置阶段是关键一步:
- 访问集成界面:前往 配置 > 设备与服务 > 集成
- 添加海尔集成:搜索
haier并点击添加 - 账号认证:输入 Client ID 和 Refresh Token 完成设备连接
这里需要注意,Token 的获取通常需要在海尔官方 App 或开发者后台申请,确保权限正确才能拉取到设备列表。
高级定制与调试
实体过滤与筛选
默认情况下,集成可能会加载所有可用设备。如果家里设备较多,可以通过修改源码进行筛选:
- 在
custom_components/haier/core/config.py中,可以设置选择性接入特定设备,排除不需要的类型,或者自定义显示顺序。 - 在
custom_components/haier/config_flow.py中灵活配置,只显示需要的控制项,隐藏不常用的功能,优化界面布局。
这样能避免控制面板过于杂乱,提升日常使用体验。
调试日志开启
遇到连接问题或状态异常时,开启调试日志是排查问题的第一步。在 configuration.yaml 中加入以下配置:
logger:
default: warn
logs:
custom_components.haier: debug
重启后,日志会详细记录组件运行时的交互过程,方便定位是网络问题还是鉴权失败。
常见问题处理
在实际使用中,可能会遇到以下几种情况:
- 设备无法连接:优先检查网络连接是否通畅,以及账号权限是否过期。

