Как получить токен для Xiaomi Mi Robot Vacuum Cleaner: все рабочие способы

Роботы-пылесосы Xiaomi Mi Robot Vacuum Cleaner давно стали неотъемлемой частью «умных домов», но их полноценное использование за пределами стандартного приложения Mi Home требует знания уникального токена устройства. Этот 32-значный ключ открывает доступ к API робота, позволяя интегрировать его с Home Assistant, Node-RED или другими системами автоматизации. Без токена вы не сможете отправлять прямые команды, получать данные о статусе уборки или настраивать сложные сценарии.

Проблема в том, что Xiaomi не предоставляет токен в открытом виде — его нужно извлекать самостоятельно. Существует несколько методов: от простого копирования через Mi Home (если устройство уже привязано) до ручного перехвата трафика с помощью MITM-прокси или специализированных скриптов. В этой статье мы разберём все актуальные способы, включая нюансы для разных моделей (Mi Robot Vacuum-Mop 2 Pro, S5 Max, STYJ02YM и др.), а также расскажем, как избежать типичных ошибок при получении токена.

Что такое токен Xiaomi и зачем он нужен

Токен (или device token) — это уникальный идентификатор, который Xiaomi присваивает каждому устройству в экосистеме Mi Home. Он выполняет две ключевые функции:

• 🔑 Аутентификация: подтверждает, что запрос к устройству исходит от доверенного источника (вашего аккаунта или авторизованного приложения).
• 🛡️ Безопасность: защищает от несанкционированного доступа к управлению роботом (например, через локальную сеть).

Без токена вы ограничены возможностями официального приложения. С токеном открываются горизонты:

• 🏠 Интеграция с Home Assistant, ioBroker или OpenHAB для создания автоматизированных сценариев (например, запуск уборки при уходе из дома).
• 📊 Получение расширенной телеметрии: карты уборки в реальном времени, статус батареи, ошибки датчиков.
• 🔧 Использование альтернативных прошивок (например, Valetudo) для работы без облака Xiaomi.

Важно понимать, что токен не является статичным: при сбросе устройства или перепривязке к другому аккаунту он изменяется. Также Xiaomi периодически обновляет механизмы защиты, поэтому некоторые старые методы извлечения токена (например, через miio extract_tokens) могут перестать работать для новых моделей.

Способ 1: Получение токена через приложение Mi Home (самый простой метод)

Если ваш робот-пылесос уже привязан к аккаунту Mi Home, извлечь токен можно без технических ухищрений — прямо из приложения. Этот метод работает для большинства моделей, включая Mi Robot Vacuum-Mop P, S7 и STYTJ01ZHM.

Шаги для Android:

1. Откройте Mi Home и перейдите на страницу вашего робота-пылесоса.
2. Нажмите на три точки (⋮) в правом верхнем углу → Настройки → Общие настройки.
3. Прокрутите вниз и выберите О программе.
4. Тапните 5–7 раз по версии прошивки (например, 3.5.9_0043), пока не появится уведомление Дополнительные функции разблокированы.
5. Вернитесь в Общие настройки — там появится новый пункт Получить токен (или Device Info). Нажмите на него.
6. Скопируйте отображаемый токен (32 символа) и не делитесь им с посторонними!

Для iOS: официальное приложение Mi Home не поддерживает этот метод. Вместо этого используйте альтернативные клиенты, например, Mi Home (Poco) или Aqara Home (если устройство совместимо). Также можно временно установить Mi Home на Android-эмулятор (BlueStacks).

Убедитесь, что робот подключён к Wi-Fi|Обновите приложение Mi Home до последней версии|Войдите в тот же аккаунт, к которому привязан пылесос|Отключите VPN (он может блокировать доступ к скрытым настройкам)-->

⚠️ Внимание: После обновления Mi Home до версий 6.0+ скрытый режим может исчезнуть. В этом случае используйте Способ 3 (перехват трафика) или откат приложения на версию 5.9.* через APK.

Способ 2: Извлечение токена через Python-скрипт (для опытных пользователей)

Если скрытый режим в Mi Home недоступен, токен можно получить с помощью скрипта miio extract_tokens, который анализирует трафик между приложением и серверами Xiaomi. Этот метод требует базовых знаний работы с Python и ADB.

Необходимые инструменты:

• 🐍 Python 3.8+ с установленными библиотеками miio и python-miio.
• 📱 Android-смартфон с root-правами или ПК с подключённым эмулятором (Genymotion, BlueStacks).
• 🔌 ADB (Android Debug Bridge) для перехвата трафика.

Пошаговая инструкция:

1. Установите зависимости:

   pip install python-miio

2. Скачайте скрипт miio_extract_tokens.py с GitHub.
3. Подключите смартфон к ПК и запустите перехват трафика:

   adb tcpip 5555
   adb connect [IP_вашего_телефона]:5555
   adb logcat | grep "miio"

4. Откройте Mi Home и дождитесь, пока робот-пылесос загрузит данные (например, обновите статус устройства).
5. Остановите запись лога (Ctrl+C) и сохраните вывод в файл miio_log.txt.
6. Запустите скрипт для извлечения токена:

   python miio_extract_tokens.py miio_log.txt

   Результат будет в формате:

   Device ID: 123456789
   Token: a1b2c3d4e5f6... (32 символа)

Если скрипт не находит токен, проверьте:

• 🔄 Версию Mi Home (должна быть не новее 6.0).
• 🌐 Отсутствие VPN или брандмауэра, блокирующего трафик.
• 📡 Стабильное подключение робота к Wi-Fi (токен передаётся только при активном сеансе).

Способ 3: Перехват токена через MITM-прокси (Charles/Fiddler)

Этот метод подходит для пользователей, у которых не работает скрытый режим в Mi Home, а скрипты возвращают ошибки. Суть заключается в перехвате HTTPS-трафика между приложением и серверами Xiaomi с помощью прокси-сервера.

Что понадобится:

• 🖥️ ПК с установленным Charles Proxy или Fiddler.
• 📱 Android/iOS-устройство с Mi Home.
• 🔗 Сертификат прокси, установленный на смартфон (для декодирования HTTPS).

Инструкция для Charles Proxy:

1. Установите Charles Proxy на ПК и включите запись трафика (Proxy → Start Recording).
2. На смартфоне подключитесь к той же сети, что и ПК, и настройте прокси:
   • На Android: Настройки → Wi-Fi → [ваша сеть] → Дополнительно → Прокси-сервер (ручной) → укажите IP ПК и порт 8888.
   • На iOS: Настройки → Wi-Fi → (i) → Настройка прокси → Ручное.

from miio import ChuinMiIoProtocol

protocol = ChuinMiIoProtocol(
ip="192.168.1.100",
token="ваш_токен",
model="roborock.vacuum.m1s"  # уточните модель!
)
device_info = protocol.info()
print(device_info)