Роботы-пылесосы Xiaomi Mi Robot Vacuum стали неотъемлемой частью «умных домов», но для полноценной работы с ними через сторонние приложения (вроде Home Assistant, ioBroker или Mi Home Local) требуется уникальный токен устройства. Этот 32-значный ключ служит «паролем» для взаимодействия с пылесосом по локальной сети, минуя облако Xiaomi. Без него вы не сможете интегрировать устройство в автоматизации, управлять голосом через Alice или Google Assistant без официального приложения, а также использовать альтернативные прошивки.
Проблема в том, что Xiaomi не предоставляет токен открыто — его нужно извлекать самостоятельно. С 2020 года компания ужесточила защиту: старые методы с чтением сетевого трафика перестали работать, а новые требуют аккаунта с привязкой к региону Mainland China или использования обходных путей. В этом руководстве мы разберём все актуальные способы получения токена для моделей Mi Robot Vacuum (включая серии S5, S6, S7, Mop 2 Pro и другие), включая обход ограничений 2026 года. Вам не понадобятся root-права или паяльник — только смартфон, компьютер и 10-30 минут времени.
1. Что такое токен Xiaomi и зачем он нужен
Токен (или device token) — это уникальный алфавитно-цифровой ключ длиной 32 символа, который генерируется серверами Xiaomi при первом подключении устройства к аккаунту Mi Account. Он выполняет две ключевые функции:
- 🔐 Аутентификация: подтверждает, что запрос на управление пылесосом исходит от доверенного источника (вашего аккаунта или локальной сети).
- 🌐 Локальное управление: позволяет отправлять команды напрямую по протоколу
MiIO(порт 54321), не завися от облачных серверов Xiaomi.
Без токена вы ограничены официальным приложением Mi Home, которое:
- ⏳ требует постоянного интернет-соединения для работы;
- 📵 не поддерживает автоматизации через сторонние системы (например, Home Assistant);
- 🔄 может «терять» устройство после сброса или обновления прошивки.
С токеном вы получаете:
- ⚡ Мгновенный отклик (команды выполняются за 0.1-0.3 секунды против 1-3 секунд через облако).
- 🤖 Возможность создавать сложные сценарии (например, «уборка по расписанию + включение увлажнителя»).
- 🛡️ Работу без интернета (важно для дач или офисов с нестабильным соединением).
⚠️ Внимание: Токен привязан к конкретному устройству и аккаунту. Если вы сбросите пылесос к заводским настройкам или перепривяжете его к другому аккаунту, токен изменится. Сохраните его в надёжном месте (например, в менеджере паролей).
2. Способ 1: Получение токена через Mi Home (официальный метод)
Это самый простой способ, но он работает только для аккаунтов с регионом Mainland China (Китай). Если ваш аккаунт привязан к России, Европе или США, переходите к Способу 2.
Шаги для аккаунтов с регионом Китай:
- Откройте приложение Mi Home и перейдите на страницу вашего пылесоса.
- Нажмите на три точки (⋮) в правом верхнем углу →
Настройки устройства. - Прокрутите вниз и выберите
Общие настройки→Информация об устройстве. - Найдите строку
Mi Home Token(илиDevice Token) — скопируйте 32-значный ключ.
Если пункта с токеном нет:
- 📱 Обновите Mi Home до последней версии (на момент 2026 года —
6.6.100или новее). - 🌏 Убедитесь, что регион аккаунта —
Mainland China(проверяется в профиле аккаунта). - 🔄 Переподключите пылесос к аккаунту (удалите и добавьте заново).
⚠️ Внимание: Смена региона аккаунта на Mainland China может привести к потере доступа к другим устройствам Xiaomi, привязанным к этому аккаунту (например, смартфонам или лампочкам). Рекомендуем создать отдельный аккаунт для пылесоса.
3. Способ 2: Извлечение токена через сетевой трафик (MITM)
Этот метод работает для любых регионов, но требует компьютера и базовых навыков работы с терминалом. Суть — перехватить токен при обмене данными между пылесосом и серверами Xiaomi.
Что понадобится:
- 💻 Компьютер с Windows, macOS или Linux.
- 📱 Смартфон с установленным Mi Home и подключённым пылесосом.
- 🛠️ Утилита
mitmproxyилиFiddler(для перехвата трафика). - 🔧 Программа
Packet Capture(для Android) илиrProxy(для iOS).
Пошаговая инструкция:
- Настройка прокси:
- Установите
mitmproxyна компьютер:pip install mitmproxy - Запустите прокси-сервер:
mitmproxy --mode transparent --showhost - На смартфоне подключитесь к той же сети Wi-Fi, что и компьютер, и настройте прокси вручную (IP компьютера, порт
8080).
- Установите
- Откройте Mi Home и обновите статус пылесоса (например, нажмите «Начать уборку»).
- В терминале
mitmproxyнайдите запрос к доменуapi.io.mi.comилиmiot-spec.org. - В ответе сервера ищите строку
"token": "..."— это и есть ваш токен.
Пример ответа сервера с токеном:
{
"result": {
"token": "a1b2c3d4e5f6...32_символа",
"localIP": "192.168.1.100",
"mac": "78:11:DC:XX:XX:XX"
},
"code": 0
}
Установить mitmproxy|Настроить прокси на смартфоне|Запустить Mi Home и обновить статус|Найти запрос к api.io.mi.com|Скопировать token из ответа-->
⚠️ Внимание: Xiaomi шифрует часть трафика с 2022 года. Если в ответах нет открытого токена, попробуйте использовать Packet Capture на Android с включённым декодированием SSL (требует установки сертификата). На iOS этот метод может не работать из-за ограничений Apple.
4. Способ 3: Использование утилиты MiHome-Binary-Protocol
Для пользователей, которые не хотят возиться с перехватом трафика, есть готовое решение — скрипт mihome-binary-protocol, который автоматизирует извлечение токена. Он работает через эмуляцию запросов к серверам Xiaomi.
Требования:
- 🖥️ Компьютер с Python 3.8+.
- 📋 Логин и пароль от аккаунта Mi Account, к которому привязан пылесос.
- 📡 Пылесос должен быть в сети и подключён к тому же аккаунту.
Инструкция:
- Установите скрипт:
git clone https://github.com/Maxmudjon/com.xiaomi-miio.gitcd com.xiaomi-miio
pip install -r requirements.txt
- Запустите извлечение токена:
python miio_extractor.pyВведите логин (email) и пароль от Mi Account при запросе.
- Скрипт выведет список устройств с их токенами. Найдите ваш пылесос по модели (например,
roborock.vacuum.s5).
Пример вывода:
Device ID: 123456789
Model: roborock.vacuum.s6
Token: 9876543210abcdef9876543210abcdef
IP: 192.168.1.105
5. Способ 4: Токен через альтернативные приложения (без ПК)
Если у вас нет доступа к компьютеру, можно извлечь токен прямо со смартфона с помощью сторонних приложений. Этот метод подходит для Android и iOS, но требует осторожности (некоторые приложения могут нарушать политику Xiaomi).
Приложения для Android:
- 📱 Mi Home Token Extractor (требует root или ADB-доступ).
- 🔍 Packet Capture (для анализа трафика, как в Способе 2).
- 🤖 Tasker + Plugin Mi Home (для автоматического извлечения).
Приложения для iOS:
- 📱 HTTP Catch (для перехвата трафика, требует настройки VPN).
- 🔌 Shortcuts + Scriptable (для автоматизации запросов).
Пошаговая инструкция для Packet Capture (Android):
- Установите Packet Capture из Google Play.
- Запустите запись трафика и откройте Mi Home.
- Обновите статус пылесоса (нажмите на него в списке устройств).
- Остановите запись и найдите запрос к
api.io.mi.com. - В ответе ищите поле
"token".
⚠️ Внимание: Приложения для iOS часто блокируются Apple из-за использования VPN-профилей. Если HTTP Catch не работает, попробуйте использовать Charles Proxy на Mac с подключённым iPhone по USB.
6. Способ 5: Токен через прошивку (для продвинутых пользователей)
Этот метод подходит для владельцев пылесосов с возможностью установки кастомных прошивок (например, Valetudo или OpenMiHome). Он позволяет получить токен напрямую из файлов устройства, но требует разблокировки и прошивки.
Поддерживаемые модели:
| Модель | Поддержка Valetudo | Требуется паяльник |
|---|---|---|
| Xiaomi Mi Robot Vacuum 1S | ✅ Да | ❌ Нет (через UART) |
| Roborock S5/S5 Max | ✅ Да | ❌ Нет |
| Roborock S6/S6 Pure | ✅ Да | ⚠️ Частично (нужен адаптер) |
| Mi Robot Vacuum-Mop 2 Pro | ❌ Нет (на 2026 год) | ❌ Нет |
Инструкция для установки Valetudo:
- Скачайте прошивку Valetudo для вашей модели с официального сайта.
- Подключитесь к пылесосу по
UART(нужен адаптерUSB-to-TTLи открытие корпуса). - Загрузите прошивку через
dockerили вручную (инструкция зависит от модели). - После установки откройте веб-интерфейс Valetudo (обычно по адресу
http://[IP_пылесоса]) и найдите токен в разделеSettings → Mi Cloud.
Что будет если прервать прошивку?
Прерывание процесса прошивки может привести к "окирпичиванию" пылесоса (полной неработоспособности). В этом случае потребуется перепрошивка через ST-Link или обращение в сервисный центр. Рекомендуем использовать источник бесперебойного питания (ИБП) во время процедуры.
7. Проверка токена и первые команды
После получения токена его нужно проверить на работоспособность. Для этого используйте утилиту miio-cli или отправьте тестовую команду через curl.
Установка miio-cli:
npm install -g miio-cli
Проверка подключения:
miio --ip 192.168.1.100 --token ваш_токен info
Если токен верный, вы увидите информацию о пылесосе:
{
"model": "roborock.vacuum.s5",
"firmware": "3.5.8_004216",
"battery": 87,
"state": "idle",
...
}
Примеры команд:
- 🏠 Начать уборку:
miio --ip 192.168.1.100 --token ваш_токен vacuum start - 🛑 Остановить уборку:
miio --ip 192.168.1.100 --token ваш_токен vacuum stop - 🔋 Узнать уровень заряда:
miio --ip 192.168.1.100 --token ваш_токен battery
⚠️ Внимание: Если команда возвращает ошибкуInvalid token, проверьте:
- 🔄 Правильность введённого токена (32 символа, без пробелов).
- 📡 IP-адрес пылесоса (он может меняться при переподключении к Wi-Fi).
- 🔒 Регион аккаунта (токены для
Mainland Chinaне работают с серверами других регионов).8. Частые ошибки и их решения
При работе с токенами пользователи сталкиваются с типичными проблемами. Вот самые распространённые и способы их решения:
Ошибка Причина Решение Invalid tokenНеверный токен или регион аккаунта Проверьте токен на опечатки. Если аккаунт не Mainland China, используйте Способ 2 или 3.Device not foundПылесос не в сети или неправильный IP Проверьте подключение пылесоса к Wi-Fi. Найдите его IP через роутер или сканирование сети ( nmap -sn 192.168.1.0/24).UnauthorizedТокен устарел или устройство перепривязано Получите новый токен (после сброса или смены аккаунта токен меняется). Токен не отображается в Mi Home Аккаунт не Mainland ChinaИспользуйте Способ 2 (перехват трафика) или Способ 3 (скрипт). Если ни один из методов не сработал:
- 🔄 Обновите прошивку пылесоса до последней версии (через Mi Home).
- 📧 Свяжитесь с поддержкой Xiaomi (указывайте модель и регион аккаунта).
- 🛠️ Обратитесь на форумы Home Assistant или 4PDA — там часто выкладывают актуальные токены для популярных моделей.
FAQ: Ответы на популярные вопросы
❓ Можно ли использовать один токен для нескольких пылесосов?
Нет, токен уникален для каждого устройства. Даже если у вас два одинаковых пылесоса Xiaomi Mi Robot Vacuum S6, у каждого будет свой токен.
❓ Что делать, если токен сменился после обновления прошивки?
Обновление прошивки не всегда приводит к смене токена, но если это произошло, получите новый токен одним из описанных способов. Рекомендуем фиксировать версию прошивки перед обновлением (например, через
miio info).❓ Работают ли эти методы для пылесосов Roborock?
Да, Roborock (например, модели S5, S6, S7) используют тот же протокол
MiIO, поэтому все способы получения токена применимы. Исключение — новые модели 2023-2026 годов (например, Roborock S8 Pro Ultra), где Xiaomi внедрила дополнительное шифрование.❓ Можно ли получить токен без подключения к Wi-Fi?
Нет, токен генерируется серверами Xiaomi при первом подключении пылесоса к аккаунту через интернет. Без Wi-Fi вы сможете управлять пылесосом только через физические кнопки на корпусе.
❓ Законно ли извлекать токен таким образом?
С юридической точки зрения извлечение токена для личного использования не нарушает правила Xiaomi, так как вы работаете со своим устройством. Однако распространение токенов или их использование для взлома чужих пылесосов запрещено и может повлечь блокировку аккаунта.