Introduction

Pour piloter localement un aspirateur robot Roborock ou un équipement de l’écosystème Xiaomi Mi Home depuis Home Assistant (via l’intégration Xiaomi Miio sans dépendre du cloud au quotidien), il est nécessaire de récupérer le Token de chiffrement local (une clé hexadécimale de 32 caractères attribuée lors de l’appairage Wi-Fi).

Méthode 1 (Recommandée & SecOps) : Script Python open-source en environnement isolé

⚠️ Règle d’hygiène Zero-Trust : Vous devez saisir les identifiants de votre compte Xiaomi Cloud pour interroger l’API d’inventaire. N’exécutez jamais un binaire .exe précompilé sur votre poste principal pour ce type d’opération. Inspectez et exécutez toujours le script Python open-source officiel Xiaomi-cloud-tokens-extractor dans un conteneur Docker éphémère ou un environnement virtuel (venv) isolé.

Exécutez les commandes suivantes depuis un terminal Linux, macOS ou WSL2 :

# Exécution éphémère dans un conteneur Python isolé (supprimé dès la fin du script)
docker run --rm -it python:3.12-slim bash -c "
  apt-get update -qq && apt-get install -y -qq wget unzip >/dev/null &&
  wget -q https://github.com/PiotrMachowski/Xiaomi-cloud-tokens-extractor/releases/latest/download/token_extractor.zip &&
  unzip -q token_extractor.zip &&
  pip install -q -r token_extractor/requirements.txt &&
  python3 token_extractor/token_extractor.py
"

1. Saisissez l’identifiant de votre compte Xiaomi Mi Home, votre mot de passe, puis le serveur régional utilisé (de pour l’Europe).
2. Le script affiche instantanément la liste de vos appareils avec leur adresse IP locale, leur DID, leur Modèle (roborock.vacuum.s5, etc.) et leur Token de 32 caractères.

Méthode 2 : Utilitaire graphique sous Windows

Si vous préférez l’interface autonome packagée par le même auteur (releases GitHub officielles), vérifiez systématiquement l’empreinte SHA256 de l’archive token_extractor_exe.zip avant de la lancer dans Windows Sandbox pour extraire le Token 32 caractères et l’IP locale par serveur régional (de, cn, us).

MàJ 2026 Intégration native Roborock, Xiaomi Miot Auto & Valetudo

En 2026, la gestion des équipements Xiaomi et Roborock dans Home Assistant s’est considérablement simplifiée :

1. Intégration officielle Roborock : Si votre robot est appairé sur l’application dédiée Roborock (et non plus Mi Home), l’intégration native Roborock de Home Assistant gère automatiquement la récupération des clés via un simple code de vérification envoyé par e-mail, puis bascule la communication en local sur votre LAN (protocole MQTT local vers le robot) tout en affichant la carte lidar en temps réel.
2. Xiaomi Miot Auto (HACS) : Pour les équipements restés sur l’application Xiaomi Home (purificateurs d’air, ventilateurs Smartmi, capteurs), l’intégration Xiaomi Miot Auto extrait et synchronise automatiquement les tokens locaux de tous vos appareils en une seule connexion.
3. Souveraineté totale avec Valetudo (100 % hors-cloud) : Pour les modèles compatibles au flash matériel/logiciel (Dreame, Roborock, Conga), le firmware open-source Valetudo coupe définitivement toute communication avec les serveurs cloud du fabricant et expose une interface Web locale ainsi qu’une intégration MQTT Autodiscovery directe dans Home Assistant.

Si vous voulez plus d’information sur l’infrastructure vous pouvez voir mon repo à ce sujet : https://github.com/ravindrajob/InfraAtHome