用 Agent 远程控制你的手机:通过 ADB 控制安卓手机,不必亲自动手,甚至可以实现无线远程控制——只要装上 Tailscale,无论你把手机带到哪里,都能用电脑上的 Agent 来操控它。这一个 Skill 就完全够用了。分享给大家,感兴趣的同学可以自行安装。

robbin/android-adb-control

来源:https://github.com/robbin/android-adb-control

Android ADB 控制

让 Agent 通过 ADB 操控安卓手机:观察界面、执行一步、验证结果,再决定下一步。

一个纯指令型的 Agent Skill,用于通过 ADB 控制安卓手机。

作者:范凯 and Agent(Friday) · MIT License

用来做什么

• 打开 App、查找页面、点击、滑动、长按和输入文字。
• 查看授权范围内的界面信息、处理有限列表、复现测试操作。
• 准备消息草稿;在明确授权后执行指定的发送动作。

这是给已有 Agent 加载的技能,不是独立程序、MCP Server 或后台服务。基础操作只需 ADB 和已授权的设备;自绘界面需要截图工具与视觉模型,中文输入可选 ADBKeyboard。

不用于绕过锁屏、验证码、支付验证或企业策略,也不提供无人值守监控、自动交易或无限重试。

适用 Agent

这里指的是技能格式与加载方式兼容,不代表已在四个宿主上完成真机验收。Agent 必须能够执行本机 ADB;需要视觉能力时,还必须能把截图交给模型。云端会话或远程容器不会自动获得本地 USB 设备。

安装

以下为 macOS / Linux 的 Bash 示例;Windows 请使用官方 Platform-Tools,并相应调整路径、引号和截图输出方式。

1. 准备 ADB

先检查一下,避免重复安装:

command -v adb
adb version

缺失时安装 Android SDK Platform-Tools(https://developer.android.com/tools/releases/platform-tools)。macOS 可以使用:

brew install --cask android-platform-tools

2. 安装技能

请先审阅本仓库。Pi、Codex、OpenCode 可以共用同一份:

mkdir -p "$HOME/.agents/skills"
git clone https://github.com/robbin/android-adb-control.git \
  "$HOME/.agents/skills/android-adb-control"

只用 Claude Code 时,把目标目录改为 ~/.claude/skills/android-adb-control。如果已经安装了共享版本,可以给 Claude Code 建一个兼容链接:

mkdir -p "$HOME/.claude/skills"
ln -s "$HOME/.agents/skills/android-adb-control" \
  "$HOME/.claude/skills/android-adb-control"

目标目录已存在时先检查,不要直接覆盖。OpenCode 也会扫描 .claude/skills,兼容链接可能会引起同名告警;请确认最终的加载路径,不要再安装第二份副本。

只想在项目内使用时,安装到项目的 .agents/skills/android-adb-control/;Claude Code 使用 .claude/skills/android-adb-control/。不要无意中在用户级和项目级重复安装技能。父项目已有 Git 时,按团队规范处理嵌套仓库或子模块。

安装后,Pi 执行 /reload;其他宿主如果没发现技能,检查技能权限并重开会话。OpenCode 的技能不一定注册为同名斜杠命令。

3. 连接手机

在你自己的手机上开启开发者选项和 USB 调试,用数据线连接,手动解锁并确认电脑的 RSA 授权,然后运行:

adb devices -l

设备应显示为 device。有多个设备时要明确指定目标;遇到 unauthorized、offline 或 Linux 上的 no permissions,先解决连接问题。

无线调试是可选项,见连接与故障处理。不要把 ADB 端口暴露到公网。

使用

从低风险任务开始,按照上表使用对应宿主的调用方式,例如 Pi:

/skill:android-adb-control 打开系统设置首页,确认页面,不修改设置。

也可以用自然语言请求加载技能,然后描述目标和边界:

使用 android-adb-control,在指定测试联系人的会话里输入"我稍后回复",
停在发送之前。不要点击发送,也不要按可能触发发送的回车。

查看这个测试列表的前 20 个项目,只记录名称和可见编号。
同名项目不要直接合并;到 20 个或预算用完就停止。

默认最多执行 30 个设备状态变更动作、耗时 5 分钟,并为恢复操作预留预算。长时间任务请提前约定有限的预算和检查点。发送状态不明确时不会自动重发。

安全与限制

• 只操作获授权的设备、Android 用户和 App。发送、购买、删除、安装、导出个人资料以及修改安全/网络设置,都需要明确授权。
• 截图和 UI XML 可能包含私人内容,交给云端模型之前请确认数据与日志策略;不要提交到本仓库或公开的 Issue 中。
• ADBKeyboard 的部分实现允许其他本地应用发送控制广播。优先在可信的测试设备上使用,不要用于凭据输入;使用前说明风险,结束后恢复本次改动的输入法状态。
• 默认不修改休眠时间、不切换 VPN、不安装辅助 App。无法验证或恢复时,停止并报告。
• 技能规则不是技术沙箱,仍然需要宿主的权限控制与人工监督。

本版本已完成文档审查和静态检查,尚未完成修订版的真机端到端验收。不同 ROM、App、输入法版本和视觉链路仍需测试。

文档与检查

• SKILL.md:Agent 执行入口。
• ADB 命令参考:设备/用户选择、输入、捕获和恢复。
• 故障处理:USB、OEM、无线连接与 VPN。
• DroidClaw 蒸馏笔记:脱敏后的设计背景与历史经验。
• 验证清单:检查方法和真机验收步骤。

静态检查不需要连接手机,需要 Bash、Git 和 uv:

uv run --no-project python scripts/check_docs.py

更新前请检查安装目录中的本地修改,确认可接受上游变更后再运行 git pull --ff-only,然后刷新 Agent 会话。

来源与许可

方法受到 DroidClaw(https://github.com/unitedbyai/droidclaw)启发,本项目不是其官方产品或运行时,也不分发任何第三方 APK。

参考:ADB(https://developer.android.com/tools/adb) · ADBKeyboard(https://github.com/senzhk/ADBKeyBoard) · Agent Skills(https://agentskills.io/specification) · Pi(https://github.com/earendil-works/pi/blob/main/packages/coding-agent/docs/skills.md) · Codex(https://learn.chatgpt.com/docs/build-skills) · Claude Code(https://code.claude.com/docs/en/skills) · OpenCode(https://opencode.ai/docs/skills/)

本仓库采用 MIT License,作者为范凯 and Agent(Friday)。第三方项目遵循各自的许可证。