海尔设备接入教程
海尔设备接入用于把「海尔智家」生态下的家电（空调、热水器、洗衣机等）接入 Home Assistant 进行统一管理与控制。由于该集成需要使用账号的
refreshToken与clientId，因此需要借助抓包工具从海尔智家小程序登录请求中获取这两个凭证。
| 名称 | OS | Core | Haier |
|---|---|---|---|
| 版本 | 17.0 | 2025.2.1 | 1.1.5 |
在开始之前，请确认：
- 已安装 HACS（冬瓜 HAOS 默认已内置 HACS，如需更新可参考 HACS - 极速版）。
- 已将海尔设备接入「海尔智家」App，并完成配网。
- HA 盒子、电脑和设备均处于同一个局域网内（详见 智能设备网络设置）。
- 一台电脑（用于安装抓包工具并通过微信小程序登录海尔智家）。
第 1 步：下载并安装抓包工具「小黄鸭 Reqable」
Section titled “第 1 步：下载并安装抓包工具「小黄鸭 Reqable」”下载并安装抓包工具小黄鸭（Reqable），下载地址：https://reqable.com/zh-CN/download。
官方使用教程可参考：https://bbs.hassbian.com/thread-25297-1-1.html。
第 2 步：运行 Reqable 并允许防火墙访问
Section titled “第 2 步：运行 Reqable 并允许防火墙访问”安装完成后运行 Reqable。如果弹出防火墙提示，建议将专用网络和公用网络都勾选，并点击允许访问。
第 3 步：选择工作模式为「API 抓包」
Section titled “第 3 步：选择工作模式为「API 抓包」”工作模式任意，这里选择 API 抓包。
第 4 步：安装抓包证书
Section titled “第 4 步：安装抓包证书”在安装证书页面点击现在安装，后面的页面保持默认即可，然后点击完成。
第 5 步：启动抓包
Section titled “第 5 步：启动抓包”点击右上角的「启动」开始抓包。
第 6 步：通过电脑微信小程序登录海尔智家
Section titled “第 6 步：通过电脑微信小程序登录海尔智家”- 打开电脑版微信，点击左侧栏的小程序图标，进入后搜索「海尔智家」App。
- 一路点击同意，进入海尔智家 App 小程序后点击立即登录。
- 勾选协议后，点击一键登录。
- 点击允许。
第 7 步：在 Reqable 中获取 refreshToken 与 clientId
Section titled “第 7 步：在 Reqable 中获取 refreshToken 与 clientId”返回到 Reqable 中，点击「URL」使列表按字面顺序排列，找到并双击：
https://zj.haier.net/api-gw/oauthserver/applet/v3/login/onekey
在弹出的右侧栏点击响应体，找到 refreshToken 和 clientId。
一定要耐心看清楚，很多人都是看错了行导致接入不成功。
第 8 步：在 HA 中添加 Haier 集成并填写凭证
Section titled “第 8 步：在 HA 中添加 Haier 集成并填写凭证”- 进入 HA，依次点击 设置 > 设备与服务 > 集成 > 添加集成，搜索 haier。
- 输入上一步获取的 refreshToken 和 clientId。
- 进入后就能看到所有支持的设备了。
| 问题 | 解决办法 |
|---|---|
| 找不到登录请求 | 确认已点击右上角「启动」开始抓包后再去小程序登录；在 Reqable 中点击「URL」排序，按字面顺序查找 zj.haier.net/.../login/onekey。 |
| 填写凭证后接入失败 | 多为 refreshToken 或 clientId 看错行、复制不完整。回到响应体中耐心核对，确保完整准确地复制。 |
| 设备搜不到 / 不全 | 确认设备已接入海尔智家 App，且 HA 盒子、电脑、设备处于同一局域网。 |
| 抓包工具无法抓到 HTTPS 内容 | 确认已正确安装并信任抓包证书（第 4 步），必要时重新安装证书。 |
海尔设备接入的核心流程是：安装抓包工具 Reqable → 安装证书并启动抓包 → 通过微信小程序登录海尔智家 → 抓取登录请求获取 refreshToken 与 clientId → 在 HA 中添加 Haier 集成并填入凭证，完成后即可在 Home Assistant 中管理海尔智家设备。