Roborock + Home Assistant

1. Prerequisites

Before starting, ensure you have:

• Home Assistant installed and running
• Roborock robot vacuum (S4, S5, S6, S7, S8 series or similar)
• Roborock app installed with your vacuum set up and connected
• Email access for verification code

Supported Models

Most Roborock models work with the native integration:

• S-Series: S4, S5, S5 Max, S6, S6 Pure, S6 MaxV, S7, S7+, S7 MaxV, S8, S8 Pro
• E-Series: E4, E5

2. Integration Setup

Step 1: Ensure Vacuum is Set Up

Your vacuum must be fully set up in the Roborock app first:

• Connected to WiFi
• Linked to your Roborock account
• Able to be controlled from the app

Step 2: Add Integration

1. Go to Settings → Devices & Services
2. Click + Add Integration
3. Search for Roborock
4. Enter the email address used for your Roborock account

Step 3: Enter Verification Code

Roborock will send a verification code to your email. Enter it in Home Assistant when prompted.

Step 4: Verify Connection

After authentication, your vacuum should appear with all its entities. You'll see controls for vacuum, mop, battery, and various sensors.

3. Available Features

Vacuum Control

• Start/stop/pause cleaning
• Return to dock
• Fan speed selection (quiet, balanced, turbo, max)
• Locate robot (makes it beep)

Mop Control (S7+ and newer)

• Mop intensity adjustment
• Mop mode selection
• Mop lift for carpets

Status & Sensors

• Battery level and charging status
• Cleaning area and time
• Consumable status (brush, filter, sensors)
• Error reporting

Additional Controls

• Do not disturb scheduling
• Volume control
• Child lock

4. Room-Specific Cleaning

One of the most useful features is cleaning specific rooms. This requires a few setup steps.

Step 1: Name Rooms in App

Use the Roborock app to name your rooms (Kitchen, Living Room, etc.). The vacuum must have completed at least one full mapping run.

Step 2: Get Room IDs

Room IDs are numeric values the vacuum uses internally. Get them using Developer Tools:

1. Go to Developer Tools → Services
2. Call roborock.get_maps for your vacuum
3. Check the response for room IDs (they'll be in the attributes)

Step 3: Clean Specific Rooms

Use the vacuum.send_command service with segment cleaning:

service: vacuum.send_command
target:
  entity_id: vacuum.roborock_s7
data:
  command: app_segment_clean
  params:
    - segments:
        - 16  # Kitchen room ID
        - 17  # Living room ID
      repeat: 1

5. Automation Ideas

Clean When Everyone Leaves

automation:
  - alias: "Vacuum when house is empty"
    trigger:
      - platform: state
        entity_id: group.family
        to: "not_home"
        for: "00:10:00"
    condition:
      - condition: time
        after: "09:00:00"
        before: "17:00:00"
    action:
      - service: vacuum.start
        target:
          entity_id: vacuum.roborock_s7

Return to Dock Before Bed

automation:
  - alias: "Dock vacuum at night"
    trigger:
      - platform: time
        at: "22:00:00"
    condition:
      - condition: not
        conditions:
          - condition: state
            entity_id: vacuum.roborock_s7
            state: "docked"
    action:
      - service: vacuum.return_to_base
        target:
          entity_id: vacuum.roborock_s7

Kitchen Clean After Cooking

automation:
  - alias: "Clean kitchen after cooking"
    trigger:
      - platform: state
        entity_id: binary_sensor.stove_power
        to: "off"
        for: "00:30:00"
    action:
      - service: vacuum.send_command
        target:
          entity_id: vacuum.roborock_s7
        data:
          command: app_segment_clean
          params:
            - segments:
                - 16  # Kitchen
              repeat: 1

Low Battery Notification

automation:
  - alias: "Vacuum low battery alert"
    trigger:
      - platform: numeric_state
        entity_id: sensor.roborock_s7_battery
        below: 20
    condition:
      - condition: not
        conditions:
          - condition: state
            entity_id: vacuum.roborock_s7
            state: "docked"
    action:
      - service: notify.mobile_app
        data:
          message: "Vacuum battery low ({{ states('sensor.roborock_s7_battery') }} %)"

6. Troubleshooting

Authentication Failed

• Verify you're using the correct email for your Roborock account
• Check spam folder for verification code
• Try logging out and back into the Roborock app

Vacuum Not Responding

• Check if vacuum is online in the Roborock app
• Verify WiFi connection on the vacuum
• Restart the integration from Settings → Integrations

Room Cleaning Not Working

• Ensure map is saved in the Roborock app
• Verify room IDs are correct (use get_maps action)
• Check that rooms are properly segmented in the app

Entities Missing

• Some features depend on vacuum model
• Mop controls only appear on mop-capable models
• Try reloading the integration

8. Sources

This guide was compiled from official documentation:

• Home Assistant Roborock Integration (official docs)

Last verified: 2026-01-31 against Home Assistant 2026.1. If you find outdated information, let us know.