Как получить токен робота-пылесоса Xiaomi: 5 рабочих способов (обновлено 2026)

Токен робота-пылесоса Xiaomi — это уникальный цифровой ключ, который открывает доступ к расширенным функциям устройства: интеграции с Home Assistant, Node-RED, сторонними приложениями или даже созданию собственных скриптов автоматизации. Без него вы ограничены стандартным функционалом Mi Home, а с ним — управляете пылесосом через голосовых помощников, планировщики задач или кастомные панели управления.

Проблема в том, что Xiaomi не предоставляет токен открыто. Его нужно извлечь из трафика приложения, перехватить через отладочные инструменты или получить обходными путями. В этой статье — актуальные методы на 2026 год, работающие для всех моделей: от Mi Robot Vacuum 1S до DreameBot Z10 Pro. Мы разберём способы разной сложности: от простых (через Mi Home) до продвинутых (с использованием Python и Wireshark).

Важно: токен привязан к аккаунту Xiaomi и устройству. Если вы сбросите пылесос к заводским настройкам или измените регион аккаунта, токен станет недействительным. Также Xiaomi периодически обновляет протоколы безопасности — некоторые методы могут перестать работать. Мы следим за актуальностью и обновляем инструкции.

1. Что такое токен робота-пылесоса и зачем он нужен

Токен (или device token) — это 32-значный алфавитно-цифровой код, который идентифицирует ваше устройство в экосистеме Xiaomi. Он генерируется при первом подключении пылесоса к аккаунту и используется для авторизации запросов к облачным серверам компании. Без токена сторонние системы не смогут отправлять команды пылесосу, даже если знают его DID (уникальный идентификатор устройства).

Примеры использования токена:

• 🏠 Интеграция с Home Assistant: управление пылесосом через дашборды, автоматизации по расписанию или триггерам (например, запуск уборки при уходе из дома).
• 🤖 Скрипты на Python: создание кастомных алгоритмов уборки (зональная очистка, обход препятствий, динамическое изменение мощности).
• 📱 Альтернативные приложения: Valetudo, DreameHome или Mi Home Lite с расширенными функциями.
• 🔧 Отладка и ремонт: диагностика ошибок через API, сброс настроек без физического доступа к устройству.

Без токена вы ограничены официальным приложением Mi Home, где функционал часто урезан (например, нет возможности настроить уборку по координатам или изменить параметры карты). С токеном вы получаете полный контроль над устройством, включая доступ к недокументированным командам (например, включение тестового режима двигателей или сброс счётчика работы щёток).

⚠️ Внимание: Не передавайте свой токен третьим лицам! С ним можно не только управлять пылесосом, но и получить доступ к другим устройствам в вашем аккаунте Xiaomi, если они используют тот же регион серверов. Храните токен в защищённом месте (например, в менеджере паролей).

2. Подготовка: что нужно перед извлечением токена

Прежде чем приступать к получению токена, выполните обязательные шаги:

Убедитесь, что пылесос подключён к Wi-Fi (2.4 ГГц)

Обновите приложение Mi Home до последней версии

Включите отладку по USB на смартфоне (для методов с перехватом трафика)

Создайте резервную копию настроек пылесоса в Mi Home

Проверьте, что аккаунт Xiaomi привязан к региону "Mainland China" (для некоторых методов)

-->

Самый надёжный способ — использовать аккаунт с регионом Китай (Mainland China). Дело в том, что Xiaomi разделяет серверы для разных регионов, и токены, полученные в европейской или российской версии Mi Home, могут не работать со сторонними сервисами. Чтобы сменить регион:

1. Откройте Mi Home → нажмите на аватарку → Настройки аккаунта.
2. Выберите Страна/Регион → Mainland China (Китай).
3. Выйдите из аккаунта и войдите заново.
4. Подключите пылесос к аккаунту повторно (он появится в списке устройств).

Если вы не хотите менять регион, токен всё равно можно получить, но некоторые команды API могут работать нестабильно. Также учтите, что для методов с перехватом трафика (HTTP-сервер или Fiddler) потребуется root-доступ на Android или jailbreak на iOS, либо использование эмулятора.

Mi Robot Vacuum 1/1S/1C

Mi Robot Vacuum-Mop 2/2S/2 Pro

DreameBot (D9, Z10, L10 и др.)

Viomi (SE, V3 и др.)

Другой (указать в комментариях)

-->

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

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

Шаги для Android:

1. Скачайте и установите приложение Mi Home Backup (неофициальное, но проверенное сообществом).
2. Откройте Mi Home Backup и нажмите Login with Xiaomi Account.
3. Введите логин/пароль от вашего аккаунта Xiaomi (регион должен быть Mainland China).
4. После авторизации выберите ваш пылесос в списке устройств.
5. Нажмите Backup Device Data — токен отобразится в поле Token.

Шаги для iOS:

На iPhone процесс сложнее из-за ограничений системы. Вам потребуется:

1. Установить Mi Home на компьютер с macOS через эмулятор (например, Xcode + iPadian).
2. Использовать mitmproxy или Charles Proxy для перехвата трафика (инструкция ниже в способе 4).
3. Или воспользоваться скриптом для Python, который эмулирует авторизацию.

Если Mi Home Backup не показывает токен, попробуйте:

• 🔄 Перезапустить приложение и повторить авторизацию.
• 📱 Удалить кэш Mi Home в настройках телефона.
• 🌐 Сменить регион аккаунта на Mainland China (если ещё не сделали).

4. Способ 2: Перехват токена через HTTP-сервер (для продвинутых)

Этот метод требует навыков работы с Python и терминалом, но даёт 100% результат. Мы будем эмулировать сервер Xiaomi, чтобы приложение Mi Home отправило на него токен.

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

• 💻 Компьютер с Python 3.8+ и библиотекой mitmproxy.
• 📱 Смартфон с Mi Home и доступом к Wi-Fi.
• 🔌 Пылесос, подключённый к тому же Wi-Fi, что и компьютер.

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

1. Установите mitmproxy через терминал:

   pip install mitmproxy

2. Запустите прокси-сервер:

   mitmweb --mode transparent --showhost

   (откроется веб-интерфейс на http://127.0.0.1:8081)

3. На смартфоне подключитесь к Wi-Fi, где работает mitmproxy, и настройте прокси:
   • Адрес: IP вашего компьютера (узнать через ipconfig или ifconfig).
   • Порт: 8080.

Пример ответа сервера с токеном:

{
"code": 0,
"message": "ok",
"result": {
"ssecurity": "5f4dcc3b5aa765d61d8327deb882cf99", // ← это токен
"location": "CN",
"userId": 123456789
}
}

⚠️ Внимание: Если вы используете Mi Home версии новее 6.0.100, Xiaomi может блокировать несертифицированные прокси. В этом случае попробуйте откатиться на более старую версию приложения (например, 5.9.54) или используйте способ с Packet Capture (описан ниже).

5. Способ 3: Использование Packet Capture (без root)

Если предыдущие методы не сработали, попробуйте перехватить токен с помощью приложения Packet Capture (доступно для Android). Этот способ не требует root-прав, но нужна осторожность — не все версии Mi Home совместимы.

Инструкция:

1. Скачайте Packet Capture из Google Play.
2. Откройте приложение, нажмите Start Capture и выберите HTTP/HTTPS.
3. Вернитесь в Mi Home, войдите в аккаунт и дождитесь загрузки списка устройств.
4. Остановите захват трафика в Packet Capture и найдите запрос к api.io.mi.com.
5. В ответе сервера ищите поле "token" или "ssecurity".

Если токен не отображается, попробуйте:

• 🔍 Фильтровать трафик по ключевому слову miio или vacuum.
• 📵 Отключить другие приложения, которые могут мешать захвата (VPN, антивирусы).
• 🔄 Повторить авторизацию в Mi Home несколько раз.

6. Способ 4: Извлечение токена из файлов Mi Home (для Android с root)

Если у вашего телефона есть root-доступ, токен можно извлечь напрямую из файлов Mi Home. Этот метод надёжен, но требует осторожности — неверные действия могут привести к сбою приложения.

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

1. Установите файловый менеджер с поддержкой root (например, Root Explorer или FX File Explorer).
2. Перейдите по пути:

   /data/data/com.xiaomi.smarthome/databases

   Ищите файл miio_device.db или com.xiaomi.smarthome_preferences.xml.

3. Откройте файл miio_device.db в текстовом редакторе и найдите строку с вашим пылесосом. Токен будет в поле token рядом с did (ID устройства).
4. Если файла нет, проверьте папку:

   /data/data/com.xiaomi.smarthome/shared_prefs

   Здесь может лежать файл device_token.xml с нужной информацией.

Пример содержимого miio_device.db:

⚠️ Внимание: Изменение файлов в папке /data/data/ может привести к краху Mi Home. Перед редактированием сделайте резервную копию файла. Также не передавайте токен через незащищённые каналы (например, в открытых чатах или форумах) — его можно использовать для управления вашим пылесосом!

7. Способ 5: Альтернативные методы (для специфических случаев)

Если ни один из вышеописанных способов не сработал, попробуйте эти варианты:

• 🔧 Через Mi Home для ПК: Установите десктопную версию Mi Home и используйте Fiddler или Wireshark для перехвата трафика. Токен будет в запросе к api.io.mi.com/miot-spec/v2/instance.
• 🤖 Для роботов Dreame: В приложении DreameHome токен хранится в открытом виде. Используйте ADB для извлечения:

  adb shell "cat /data/data/com.dreame.vacuum/files/device_token.txt"

• 📡 Через Mi Cloud Tokens Extractor: Онлайн-сервис mi.tokens.extractor (неофициальный) позволяет получить токен по логину/паролю от аккаунта Xiaomi. Риск! Вводите данные только если доверяете ресурсу.
• 🔄 Сброс и повторная привязка: Если пылесос ранее был привязан к другому аккаунту, выполните сброс через кнопку на корпусе (зажмите Reset на 5 секунд), затем привяжите заново и повторите извлечение токена.

Для моделей Viomi (например, Viomi V3) токен можно получить через приложение Viomi Home, используя тот же метод с mitmproxy. Главное — убедиться, что регион аккаунта установлен на China, иначе API-запросы будут идти на другие серверы.

vacuum:
- platform: xiaomi_miio
host: IP_ПЫЛЕСОСА
token: ВАШ_ТОКЕН

После перезагрузки Home Assistant пылесос появится в интерфейсе как управляемое устройство.-->

8. Частые ошибки и их решения

При извлечении токена пользователи сталкиваются с типичными проблемами. Вот как их решить:

Если вы получаете ошибку Invalid token при использовании токена в Home Assistant или других системах, убедитесь, что:

• 🔗 Токен скопирован без пробелов и лишних символов.
• 🌍 Регион аккаунта совпадает с регионом серверов в настройках интеграции.
• 🔄 Вы не сбрасывали пылесос после получения токена (это сбрасывает токен!).

FAQ: Ответы на частые вопросы

from miio import Vacuum
vacuum = Vacuum(ip="IP_ПЫЛЕСОСА", token="ВАШ_ТОКЕН")
print(vacuum.status())