Roborock Integration Setup

Roborock vacuums connect to Home Assistant through the built-in Roborock integration. Setup signs in with the client’s Roborock account, then Home Assistant talks to each robot on the local network and checks on it every 30 seconds. The robot still needs internet access: maps come from Roborock’s cloud, and a robot that cannot reach Roborock’s servers also stops answering locally.

Before You Start

1. Set the robot up in the Roborock app, let it map the home, and name the rooms there. Home Assistant uses the app’s rooms.
2. Reserve the robot’s IP address in the router.
3. Know the email address of the Roborock account. The integration sends a verification code to it.

Step 1: Add the Roborock Integration

1. Go to Settings > Devices & Services. The robot usually appears under Discovered as Roborock. Select Add. If it is not there, select Add Integration and search for Roborock.
2. Enter the account’s email address. Leave Roborock server region on Auto unless setup fails.
3. Enter the verification code sent to that email address.

One entry covers every robot on the account. Each robot appears with a vacuum entity, a map, and sensors, selects, and switches for its dock, mop, and consumables, depending on the model.

Step 2: Map the Rooms to Home Assistant Areas

To clean one room at a time, link each room from the Roborock app to a Home Assistant area:

1. Go to Settings > Devices & Services > Entities and select the robot’s vacuum entity.
2. Select the cogwheel, then Map vacuum segments to areas.
3. The robot’s rooms are listed on the left. For each one, select the matching Home Assistant area on the right, then select Save.

If no rooms are listed, save the rooms again in the Roborock app. When the robot’s rooms change, for example after a new map, map them again. Home Assistant raises a repair for this on most models.

Step 3: Clean a Room from an Automation

Use the Clean area with vacuum cleaner action (vacuum.clean_area) and pick one or more areas:

action: vacuum.clean_area
target:
  entity_id: vacuum.saros_10r
data:
  cleaning_area_id:
    - kitchen
    - living_room

Roborock cleans the selected rooms in its own order, not in the order listed.

Keep It Local

The integration falls back to Roborock’s cloud when it cannot reach a robot directly, and raises a Cloud API used repair. The cloud rate-limits requests, so entities can go unavailable. To keep control local:

• Firewall: allow TCP 58867 between Home Assistant and the robot, both ways, and UDP 58866 from the robot to Home Assistant. The robot also needs outbound TCP 8883 to Roborock’s servers.
• DNS filtering: exempt the robot from Pi-hole, AdGuard Home, or NextDNS. Aggressive block lists break the local connection.
• Do not block the robot’s internet. Without Roborock’s servers, it stops accepting local commands too. For a robot that runs fully offline, see Valetudo Vacuum Setup .
• Do not reload in a loop. An automation that reloads the integration whenever a robot goes unavailable hits the cloud rate limit.

Troubleshooting

1. A robot drops offline for about a minute. Roborock robots randomly disconnect from the internet for about a minute, then reconnect. This is expected and recovers on its own.
2. Setup fails with a user agreement error. In the Roborock app, go to Profile > About Us > User Agreement & Privacy Policy, select Revoke authorization, sign in again, accept the policy, and reload the integration.
3. No robot is found. Update Home Assistant: newer Roborock models sometimes need a newer release.