adb-controller
v1.0.0Control an Android device via ADB. Use when the user asks to control an Android device, tap, swipe, input text, or perform actions via adb. Automatically uses the adbServer configured in openclaw.json and takes screenshots.
Installation
ADB Controller
This skill allows you to execute ADB (Android Debug Bridge) commands on a connected Android device and automatically retrieve a screenshot of the result.
Configuration
The user can configure the target ADB device/server in their openclaw.json (this is automatically read by the script):
{
"skills": {
"entries": {
"adb-controller": {
"adbServer": "192.168.1.100:5555" // or device serial
}
}
}
}
Usage
To run an ADB command, execute the provided Python script:
python3 ~/.openclaw/workspace/skills/adb-controller/scripts/run_adb.py shell input tap x y
You can pass any standard ADB arguments to the script. For example:
- python3 .../run_adb.py shell input text "hello"
- python3 .../run_adb.py shell input keyevent 26 (Power button)
- python3 .../run_adb.py shell swipe 500 1000 500 500
Workflow (Mandatory)
- Understand the user's intent and determine the correct ADB command.
- Execute the user's requested action using the
run_adb.pyscript via theexectool. - The script will output the path to a newly captured screenshot.
- Send the Image: You MUST use the
messagetool (withaction="send"andmedia="<path-to-screenshot>") to send the resulting screenshot to the user, allowing them to see the outcome of the action. Do not just output the file path.