adb-claw
Your eyes, hands, and ears on Android. See the screen (screenshot + indexed UI tree), interact (tap, swipe, scroll, type, clear-field), navigate via deep links (bypass CJK text input limits), wait for UI state changes instead of polling, monitor live UI text via accessibility framework (works during…
Install / Use
npx skills add LeoYeAI/openclaw-master-skills --skill adb-clawInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
OperationsSupported Platforms
Tags
Our assessment of adb-claw
adb-claw scores 90/100 on our quality scale, 319th of 745 Operations skills we index (top 43%).
Its SKILL.md is 26 KB long, well organised into 58 sections with 38 code examples: a thorough specification that gives an agent plenty to work with.
With 2,149 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 4 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
- Our last check on 2026-10-02 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 98/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-09-30. Automated pattern scan on 2026-09-30. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
adb-claw compared with similar skills
All 4 of these similar skills score higher than adb-claw; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| adb-claw (this skill)by LeoYeAI | 90 | 2.1k | 4mo ago | SKILL.md |
| x402by browser-use | 100 | 121.0k | 3d ago | SKILL.md |
| algorithmic-artby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| pptxby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| designby nextlevelbuilder | 100 | 149.0k | 6d ago | SKILL.md |
Frequently asked questions
- How do I install adb-claw?
- Run
npx skills add LeoYeAI/openclaw-master-skills --skill adb-claw. The install tabs above show the steps for each supported agent. - Which AI agents does adb-claw work with?
- It is written for Zed, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is adb-claw safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 98/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is adb-claw still maintained?
- The repository was last updated about 4 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
Skill content
View source on GitHubname: adb-claw version: 1.6.1 description: "Your eyes, hands, and ears on Android. See the screen (screenshot + indexed UI tree), interact (tap, swipe, scroll, type, clear-field), navigate via deep links (bypass CJK text input limits), wait for UI state changes instead of polling, monitor live UI text via accessibility framework (works during video playback), capture system audio (Android 11+, WAV stream for piping to ASR tools), manage full app lifecycle (install/uninstall/clear), control screen (on/off/unlock/rotation), run shell commands, and transfer files. Agent-optimized: structured JSON output, indexed element targeting, and App Profiles with pre-built deep links and layouts for popular apps." homepage: https://github.com/llm-net/adb-claw metadata: { "openclaw": { "emoji": "📱", "version": "1.6.1", "os": ["darwin", "linux"], "tags": ["android", "adb", "mobile", "automation", "ui-testing", "device-control", "deep-link", "screenshot", "accessibility", "monitoring"], "requires": { "bins": ["adb-claw", "adb"] }, "install": [ { "id": "adb-claw-darwin-arm64", "kind": "download", "url": "https://github.com/llm-net/adb-claw/releases/latest/download/adb-claw-darwin-arm64", "bins": ["adb-claw"], "os": "darwin", "label": "Download adb-claw (macOS Apple Silicon)", }, { "id": "adb-claw-darwin-amd64", "kind": "download", "url": "https://github.com/llm-net/adb-claw/releases/latest/download/adb-claw-darwin-amd64", "bins": ["adb-claw"], "os": "darwin", "label": "Download adb-claw (macOS Intel)", }, { "id": "adb-claw-linux-amd64", "kind": "download", "url": "https://github.com/llm-net/adb-claw/releases/latest/download/adb-claw-linux-amd64", "bins": ["adb-claw"], "os": "linux", "label": "Download adb-claw (Linux x86_64)", }, { "id": "adb-claw-linux-arm64", "kind": "download", "url": "https://github.com/llm-net/adb-claw/releases/latest/download/adb-claw-linux-arm64", "bins": ["adb-claw"], "os": "linux", "label": "Download adb-claw (Linux ARM64)", }, { "id": "adb-brew", "kind": "brew", "formula": "android-platform-tools", "bins": ["adb"], "label": "Install ADB (brew)", }, ], }, }
ADB Claw — Android Device Control
Your eyes, hands, and ears on Android. See what's on screen, tap any element, scroll through content, open deep links, wait for UI changes, capture system audio, manage apps, and more — all through a single CLI with structured JSON output.
Why ADB Claw
Superpowers — What You Can't Get Elsewhere:
- Live stream intelligence —
monitorconnects to Android's accessibility framework, reading all UI text in real-time — even during video playback and live streams whereuiautomator dumphangs. Chat messages, captions, dynamic overlays — data no other tool exposes to agents. - System audio capture —
audio capturerecords device audio via REMOTE_SUBMIX (Android 11+); streams WAV to stdout for piping to ASR tools. Combined withmonitor, you get full sensory coverage: visual text + audio.
Core Strengths:
- Observe → Act → Verify loop —
observereturns screenshot + indexed UI tree in one call; use element indices to target precisely across any screen size - Deep links bypass CJK limits —
adb input textcan't type Chinese/Japanese/Korean;adb-claw open 'app://search?keyword=中文'can - Wait, don't poll —
wait --text "Done"blocks until the UI element appears, replacing fragile sleep/observe loops - Smart scroll — auto-calculates swipe coordinates from screen size; supports direction, page count, and scrolling within specific elements
- App Profiles — pre-built knowledge (deep links, layouts, known issues) for popular apps like Douyin; load once, skip trial-and-error
- Full app lifecycle — install, launch, stop, uninstall, clear data — no raw
adbneeded - Agent-optimized JSON — every command returns
{ok, command, data, error, duration_ms}with actionablesuggestionon errors - Minimal device footprint — nearly all operations are pure ADB commands; only
monitorandaudio capturepush temporary ~7KB helpers that auto-exit
Actively Evolving — new capabilities ship regularly. Each release expands what you can perceive and control on Android devices.
Getting Started
Claude Code
Install the plugin, then just talk to Claude — no slash commands needed:
claude plugin add llm-net/adb-claw
The plugin auto-downloads the adb-claw binary on first session. Make sure adb is installed and a device is connected via USB with debugging enabled.
Then simply ask Claude to interact with your Android device:
"Take a screenshot of my phone"
"Open Douyin and search for 猫咪"
"Tap the Login button"
"Monitor the live stream chat for 30 seconds"
Claude reads the Triggers list below and automatically activates this skill when your message matches — no explicit invocation required.
OpenClaw
Install from ClawHub:
claw install adb-claw
Same natural-language triggers apply. Ask your agent to control an Android device and it will invoke adb-claw commands.
Triggers
These patterns tell the agent when to activate this skill:
- User asks to control, interact with, or automate an Android device
- User asks to test a mobile app or UI on Android
- User mentions tapping, swiping, scrolling, screenshots, or app management on Android
- User wants to open a URL, deep link, or specific app screen on a connected device
- User wants to wait for UI elements to appear/disappear on Android
- User wants to manage screen state (on/off/unlock/rotation) on Android
- User wants to push/pull files to/from an Android device
- User wants to monitor live stream chat or read UI text during video playback on Android
- User wants to capture or record audio from an Android device
- User wants to grab shopping cart products from a Douyin live stream
- User wants to run shell commands on an Android device
Binary
The adb-claw binary is located at ${CLAUDE_PLUGIN_ROOT}/bin/adb-claw.
The binary is installed automatically via the SessionStart hook. If adb-claw is not available, inform the user that the plugin needs to be reinstalled — do not attempt to download or install it yourself.
Setup
Requires two binaries:
- adb-claw — the control CLI
- adb — Android Debug Bridge (from Android SDK Platform-Tools)
Install adb-claw
Installed automatically by the plugin. For manual installation, see GitHub Releases.
Install adb
# macOS
brew install android-platform-tools
# Linux (Debian/Ubuntu)
sudo apt install android-tools-adb
Connect device
The Android device must have USB debugging enabled and be connected via USB. This is the most common blocker — most users haven't turned it on. When a user first asks to control their phone, always check connection first (adb-claw doctor) and if it fails, walk them through the setup steps below before attempting any other commands.
How to enable USB debugging (guide the user through this)
- Open Settings on the Android phone
- Go to About phone (some phones: Settings → My device)
- Tap Build number (or MIUI version) 7 times — a toast confirming Developer Mode is enabled will appear
- Go back to Settings → Additional settings → Developer options (path varies by brand):
- Xiaomi/Redmi: Settings → Additional settings → Developer options
- Samsung: Settings → Developer options
- Pixel/Stock: Settings → System → Developer options
- OPPO/Vivo: Settings → System management → Developer options
- Enable USB debugging toggle
- Connect phone to computer via USB cable
- A dialog "Allow USB debugging?" will appear on the phone — tap Allow (check "Always allow from this computer" for convenience)
Verify connection
adb-claw doctor # Checks adb, device connection, and capabilities
If doctor reports no device, ask the user to:
- Check the USB cable (some cables are charge-only, no data)
- Try a different USB port
- Re-authorize USB debugging on the phone (revoke and re-allow)
- On some phones, change USB mode from "Charging" to "File Transfer" in the notification shade
Quick Start
The core loop is observe → decide → act → observe:
# 1. See what's on screen
adb-claw observe --width 540
# 2. Act on what you see (use element index from observe output)
adb-claw tap --index 3
# 3. Verify the result
adb-claw observe --width 540
For CJK apps, use deep links to bypass text input limits:
# Search in Douyin (Chinese TikTok) — no manual typing needed
adb-claw open 'snssdk1128://search/result?keyword=猫咪'
# Wait for results to load
adb-claw wait --text "综合" --timeout 5000
App Profiles
App Profiles are pre-built knowledge bases for specific apps — deep links, UI layouts, device-specific behavior, and known issues. They dramatically reduce the trial-and-error needed to automate an app.
Available Profiles: skills/apps/ directory
| App | File | Key Content |
|-----|------|-------------|
| Douyin (抖音) | douyin.md | Search/user/live deep links, feed/search/profile layouts, Phone vs Pad differences, live stream chat monitoring |
| Meituan (美团) | meituan.md | Search/waimai deep links, homepage/menu/search layouts, WebView workarounds, popup chain handling |
Usage:
adb-claw app current→ get foreground app package name- Check
skills/apps/for a matching Profile - Has Profile → use deep links and known layouts (fast path)
- No Profile →
observe+ explore (slow path) - Check device form factor:
adb-claw device info→ short edge < 1200px = Phone, >= 1200px = Pad
Profiles are plain Markdown files. New app support = drop a .md file into skills/apps/.
Global Flags
| Flag | Short | Description | Default |
|------|-------|-------------|---------|
| --serial | -s | Target device serial (when multiple devices connected) | auto-detect |
| --output | -o | Output format: json, text, quiet | json |
| --timeout | | Command timeout in milliseconds | 30000 |
| --verbose | | Enable debug output to stderr | false |
Commands
observe — Screenshot + UI Tree (Primary Command)
Captures screenshot and UI element tree in one call. Always use this before and after actions.
adb-claw observe # Default
adb-claw observe --width 540 # Scale screenshot width
Returns: base64 PNG screenshot, indexed UI elements with text/id/bounds/center coordinates.
screenshot — Capture Screen
adb-claw screenshot # Returns base64 PNG in JSON
adb-claw screenshot -f output.png # Save to file
adb-claw screenshot --width 540 # Scale down
tap — Tap UI Element
Tap by element index (preferred), resource ID, text, or coordinates:
adb-claw tap --index 5 # Tap element #5 from observe output
adb-claw tap --id "com.app:id/btn" # Tap by resource ID
adb-claw tap --text "Submit" # Tap by visible text
adb-claw tap 540 960 # Tap coordinates (x y)
Always prefer --index over coordinates. Index values come from observe output.
long-press — Long Press
adb-claw long-press 540 960 # Default duration
adb-claw long-press 540 960 --duration 2000 # 2 seconds
swipe — Swipe Gesture
adb-claw swip
Truncated for display — read the full file on GitHub.
Related Skills
x402
121.0kSet up Browser Use Cloud payments with x402 — pay per request from a crypto wallet (USDC on Base mainnet), no signup or API key.
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
pptx
177.9kUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an em…
design
149.0kComprehensive design skill: brand identity, design tokens, UI styling, logo generation (55 styles, Gemini, Atlas Cloud, or MuAPI AI), corporate identity program (50 deliverables, CIP mockups), HTML presentations (Chart.js), banner design (22 styles, social/ads/web/print), icon design (15 styles, SVG…
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
