Deebot智能家居集成终极指南：Home Assistant完整配置教程

2026-02-06 05:14:18作者：韦蓉瑛

想让您的Deebot扫地机更智能吗？渴望实现远程控制清洁和实时地图追踪吗？本指南将带您完成Deebot与Home Assistant的完美集成，让您的扫地机成为真正的智能家居成员。

快速上手：5分钟完成基础集成

前置准备

在开始配置前，请确保：

Home Assistant版本不低于2024.1.0
您的Deebot设备型号支持智能控制
拥有Ecovacs账号（用于设备认证）

安装步骤

方法一：通过HACS安装（推荐）

打开Home Assistant侧边栏，进入HACS
点击"集成"，然后点击右下角的"浏览并下载存储库"
搜索"Deebot 4 Home Assistant"并安装
重启Home Assistant服务

方法二：手动安装

cd /config/custom_components
git clone https://gitcode.com/gh_mirrors/de/Deebot-4-Home-Assistant deebot

首次配置向导

进入Home Assistant的"设置" → "设备与服务"
点击"添加集成"，搜索"Deebot"
按照界面提示输入您的Ecovacs账号信息
选择您要集成的Deebot设备
完成配置，设备将自动出现在仪表盘中

核心功能深度解析

基础控制功能

播放/暂停清洁：一键控制清洁任务
定位设备：快速找到扫地机位置
返回充电：自动回充指令
多种清洁模式：支持自动清洁、地图清洁、区域清洁

高级监控功能

实时地图追踪：在Home Assistant中查看扫地机实时位置和清洁路径
多类型传感器：
- 电池电量监测
- 清洁日志记录
- 错误状态提醒
- 风扇速度调节
- 部件寿命监控
- 房间分区管理
- 清洁统计数据
- 状态信息显示
- 水箱信息监控

服务调用详解

通过Home Assistant服务调用，您可以实现更精细的控制：

# 刷新特定类别信息
service: deebot.refresh
target:
  entity_id: vacuum.deebot_xxx
data:
  category: "status"  # 可选值：battery, clean_logs, error, fan_speed, life_spans, rooms, stats, status, water

进阶配置与优化

配置参数详解

在配置流程中，您需要提供以下关键信息：

必填参数：

username：Ecovacs账号用户名
password：Ecovacs账号密码
country：所在国家代码
continent：所在大洲代码

可选参数：

client_device_id：客户端设备ID（用于多设备管理）
verify_ssl：SSL证书验证（默认开启）

区域清洁配置

实现精准的区域清洁控制：

# 在自动化中调用区域清洁
service: vacuum.send_command
target:
  entity_id: vacuum.deebot_xxx
data:
  command: clean_area
  params:
    rooms: ["卧室", "客厅"]
    cleanings: 2

自动化场景示例

工作日自动清洁：

alias: "工作日自动清洁"
description: "工作日上班后自动启动清洁"
trigger:
  - platform: time
    at: "09:00:00"
condition:
  - condition: time
    weekday:
      - mon
      - tue
      - wed
      - thu
      - fri
action:
  - service: vacuum.start
    target:
      entity_id: vacuum.deebot_xxx

电池低电量提醒：

alias: "低电量提醒"
description: "电池电量低于20%时发送通知"
trigger:
  - platform: numeric_state
    entity_id: sensor.deebot_battery
    below: 20
action:
  - service: notify.mobile_app_phone
    data:
      message: "Deebot电池电量低，请及时充电"