品牌适配器:米家
本章对应控制台 「米家」 页面的操作说明。
米家适配器是 Olink 的可选社区品牌适配器之一:把该生态设备纳入 Olink 统一设备模型。是否启用由用户自行决定,不属于平台强制预装能力。设备进入统一模型后,可再按需配置 HomeKit、Matter 等出口;出口与适配器解耦,并非「仅服务于某一品牌 → 某一客户端」的专用桥。
网关管理
扫描与添加网关
通过扫描功能发现局域网内可接入的米家网关类设备,按照向导提示填入必要信息并保存。

授权操作
通过 授权链接 在浏览器中登录米家账号完成授权。授权流程采用米家 Home Assistant 集成方案,需要手动将回调地址输入到指定输入框中。

授权成功后浏览器若跳到 olink.homeassistant.local 并提示无法访问 / 网络错误,多为 mDNS 解析不到主机名。请复制地址栏完整回调地址,粘贴到弹窗「手动粘贴回调地址」后确认;或把主机名改成 Olink 的局域网 IP 再粘贴。详见 米家授权后网络错误。
米家回调地址约定端口为 8123,故 Olink 会监听 8123;本机 HA 停掉后常会看到 Olink 占用该端口。与 HA 冲突时可关闭 Olink 的 8123 监听,授权改为手动粘贴回调。见 为何监听 / 接管 8123。
加载设备
从适配器侧同步家庭、房间与设备到 Olink 统一模型。首次连接或设备有大变更后务必执行;否则下游映射与出口(如 HomeKit)看不到最新设备。

同步映射规则
只有存在映射规则的设备类型才支持接入 Olink 系统。

同步房间
将米家的房间结构同步到 Olink 中,为设备提供空间组织基础。

房间管理
- 与米家 MIoT 家庭 / 房间 数据保持对齐,用于在控制台内按空间组织设备。
- 当米家侧房间结构发生变化后,建议在网关上再次执行 加载设备 操作,然后检查下游映射是否正确。
映射管理
与融合中枢一致,存在两层关系(适配器与出口解耦):
- 适配器设备 → Olink 设备/实体:在映射管理中维护,决定是否纳入统一设备模型及服务能力。
- Olink 设备 → 出口配件(如 HomeKit):在对应出口页添加配件,或通过 TOML 声明服务与特征。
设备可见性排查
若某设备在「接入设备」或出口客户端中不可见,请依次检查:
- 是否已加载:确认设备已从适配器同步到 Olink
- 映射是否启用/完整:检查设备映射规则是否正确配置
- 该型号是否在支持范围内:可结合适配器调试能力查看属性读写是否正常
本适配器接入流程
- 同步房间:建议先将适配器侧房间结构同步到 Olink
- 加载设备:同步设备到统一模型
- 检查映射规则:确保设备类型有对应的映射规则
- 验证接入状态:确认可在「接入设备」页查看
- 配置出口(可选):例如在 HomeKit 页为已接入设备添加配件(摄像头请走单配件流程,见 摄像头)
云端偶发标离线导致出口客户端无响应时,可在设备 接入配置 中设 force_online = true(一直在线)。见常见问题 设备常离线问题。
