Saltar al contenido principal

Integración domótica Roborock, gratuita y de código abierto

Integración Roborock para Gladys Assistant

Robot vacuums paired in the Roborock app: state, start/stop, fan power, dock, battery and routines.

Ver en GitHubTodas las integraciones externas
info

La documentación de esta integración la escribe su autor y, por ahora, solo está disponible en inglés.

Control the robot vacuums of your Roborock account from Gladys Assistant.

This integration targets robots paired in the Roborock app. It talks to them directly over your local network, with an automatic fallback to the Roborock cloud when a robot is not reachable.

If your robot is paired in the Xiaomi Home (Mi Home) app, it answers on an entirely different service: the Xiaomi Home integration is the one you need. Both can be installed at once if you use both apps.

Features​

For every robot of your account:

  • State — the operational state of the robot (cleaning, paused, returning to the dock, charging, docked, error…).
  • Run mode — start or stop a cleaning cycle.
  • Clean mode — the suction level (silent, balanced, turbo, max, gentle).
  • Dock — send the robot back to its charging dock.
  • Battery — the current battery level, in percent.
  • Routines — one button per routine saved in the Roborock app. Pressing it preserves its full configuration: rooms, zones, order, cleaning mode and number of passes.

Configuration​

Two steps, in the Actions box:

  1. Fill in the email of your Roborock account and click Send me a code by email. The address is checked before anything is sent: a typo is reported straight away instead of leaving you waiting for an email.
  2. Fill in the code you receive and click Link the account with this code.

The Unlink the account action forgets the session. A code is single-use and expires quickly: if yours is refused, ask for another one.

Then open the Discovery screen and start a scan: your robots appear and can be added to Gladys.

No password is ever asked for, deliberately: many Roborock accounts have none at all (registered with a code, or through Google/Apple), and those that do may be guarded by two-step validation — the password is then accepted and refused for want of a second factor. The code covers every case.

There is nothing else to configure: the region, your robots, their local keys and their IP addresses are all discovered automatically.

How it works​

The integration discovers your robots through the Roborock cloud, along with their local encryption key and IP address. Commands and state readings then go through the local network first (TCP), falling back to the cloud (MQTT) when a robot is unreachable. The transport in use is shown as a badge on the device.

If the cloud connection drops, the integration reconnects on its own, waiting a little longer after each failure. When Roborock refuses the connection outright (Not authorized), the integration waits an hour between attempts, and the Configuration screen says so. If the refusal lasts, ask for a new code and link the account again.

Limitations​

  • The device layer (MQTT and local TCP transports, commands) has never been exercised against a real robot on a Roborock account. The authentication, on the other hand, is verified end to end against the live cloud. If that is your setup, your feedback and debug logs are very welcome.
  • Only the Roborock "1.0" protocol family is supported. Recent ranges using a different encryption (Dyad, Zeo) are not covered.
  • Suction-level codes vary across model generations. If your model behaves differently, open an issue with the fan_power value visible in the debug logs.

Parámetros de configuración​

Estos son los parámetros que Roborock te pide en su pantalla de configuración en Gladys.

ParámetroTipoObligatorioDescripción
Roborock accountsectionNoTwo steps, in the Actions box below: ask for a code, then enter the code you receive. No password is ever needed.

Cómo instalar Roborock en Gladys​

  1. En Gladys, abre Integraciones: Roborock aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
  2. Haz clic en Instalar. Gladys descarga la imagen Docker (ghcr.io/callemand/gladys-roborock:2.5.1), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración).
  3. Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
  4. También puedes instalarla directamente desde la URL de su repositorio: https://github.com/callemand/gladys-roborock.

Roborock requiere Gladys >=5.1.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.

¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.

Sobre las integraciones externas​

Roborock es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene callemand, no el equipo principal de Gladys.

Suscríbete a la newsletter de Gladys Assistant

Unos pocos correos al mes sobre nuevas versiones y novedades del proyecto. Enviados por Pierre-Gilles Leymarie, fundador del proyecto. Puedes darte de baja cuando quieras 🙂
Última actualización en