android-adb

android-adb

Управление Android-устройствами с помощью ADB-команд с поддержкой анализа интерфейса (uiautomator) и визуальной проверки (screencap).

Установка и настройка

clawhub install staticai/android-adb

Если CLI не установлен:

npx clawhub@latest install staticai/android-adb

Или с использованием OpenClaw CLI:

openclaw skills install staticai/android-adb

Что делает этот скилл

Скилл позволяет удалённо управлять Android-устройствами через ADB. Поддерживается анализ структуры интерфейса через uiautomator для определения координат элементов, а также создание скриншотов для проверки текущего состояния экрана.

Работает как по USB, так и по беспроводному соединению (Android 11+).

Решение объединяет анализ интерфейса, взаимодействие с элементами и визуальную проверку в одном ADB-ориентированном процессе — без необходимости исходного кода приложения, тестовой сборки или эмулятора. :

Когда использовать

• Автоматизация повторяющихся действий внутри приложений
• UI-тестирование на реальных устройствах без доступа к исходному коду
• Создание скриншотов в рамках сценариев тестирования
• Запуск приложений по package name
• Определение координат UI-элементов для точных нажатий

Подключение устройств

Подключение по USB

• Включите режим разработчика и USB Debugging на устройстве
• Подключите устройство через USB
• Проверьте подключение командой:

adb devices

Беспроводное подключение (Android 11+)

• Включите Wireless Debugging в настройках разработчика
• Найдите IP, порт и код сопряжения
• Выполните:

adb pair : 

Подключение:

adb connect :

Проверьте подключение:

adb devices

Типовые сценарии

Запуск приложения

adb shell monkey -p  -c android.intent.category.LAUNCHER 1

Анализ интерфейса

adb shell uiautomator dump /sdcard/view.xml && adb pull /sdcard/view.xml ./view.xml

Далее можно искать элементы по тексту или resource ID и извлекать координаты вида [x1,y1][x2,y2].

Взаимодействие с элементами

• Тап:

adb shell input tap  

• Ввод текста:

adb shell input text "text"

• Нажатие клавиши:

adb shell input keyevent 

• Свайп:

adb shell input swipe     

Визуальная проверка

adb shell screencap -p /sdcard/screen.png && adb pull /sdcard/screen.png ./screen.png

Пример рабочего процесса

Запрос пользователя: открыть настройки и сделать скриншот экрана Wi-Fi.

Действия агента:

• Проверить подключение устройства через adb devices
• Запустить приложение настроек через monkey
• Получить структуру UI через uiautomator
• Найти пункт Wi-Fi и выполнить тап по координатам
• Сделать скриншот и сохранить его локально

Результат: сохранённый файл screen.png с экраном настроек Wi-Fi. :