xiaomi-home

xiaomi-home

Инструмент xiaomi-home — это специализированный навык для управления устройствами экосистемы Xiaomi (Mi Home) напрямую через локальную сеть. Он позволяет выполнять контроль на уровне кода, используя утилиту miiocli, без постоянной зависимости от облачных API.

Обзор

Навык предоставляет возможность взаимодействовать с умными устройствами Xiaomi — от розеток до бытовой техники — с минимальной задержкой и высокой надежностью. Основные операции включают проверку состояния, включение и выключение устройств, а также изменение параметров через протокол MIOT. :

Ключевые возможности

• Локальное управление: прямая работа через LAN без необходимости обращаться к облаку.
• Проверка состояния: быстрый доступ к текущим параметрам устройств.
• Управление питанием: включение и выключение приборов.
• Работа с MIOT: изменение свойств устройств (например, режимов работы).
• Поддержка популярных устройств: розетки, увлажнители, рисоварки и другие.

Особенности реализации

Навык использует библиотеку python-miio и работает через локальную сеть, обеспечивая более быстрый отклик по сравнению с облачными решениями. В комплект также входит скрипт для извлечения токенов устройств, необходимых для авторизации и управления. :

• Встроенный механизм получения IP и токенов устройств
• Готовые сценарии для типовых устройств
• Автоматическое устранение конфликтов зависимостей
• Интеграция с экосистемой OpenClaw

Установка

openclaw skills install xiaomi-home

Альтернативно можно выполнить установку вручную через Git или воспользоваться инструментами ClawHub. :

Быстрый старт

• Запустите скрипт для получения токенов:

python3 scripts/token_extractor.py

• Добавьте устройства в конфигурационный файл
• Используйте команды для управления, например:

«Включи водонагреватель» или «Проверь статус увлажнителя»

Примеры команд

Навык сопоставляет пользовательские команды с вызовами miiocli. Например:

miiocli miotdevice --ip  --token  raw_command set_properties '[{"siid":2,"piid":1,"value":true}]'

Таким образом можно управлять устройствами напрямую, без дополнительных посредников. :

Преимущества

• Высокая скорость отклика благодаря локальной работе
• Независимость от облачных сервисов
• Гибкость управления на уровне команд
• Поддержка множества устройств Xiaomi

Заключение

xiaomi-home — это мощный инструмент для разработчиков и энтузиастов умного дома, позволяющий получить полный контроль над устройствами Xiaomi. Он сочетает в себе простоту использования, гибкость и высокую производительность за счет локального управления.

---