自动化
adb-controller avatar

adb-controller

通过 ADB 控制 Android 设备,直接在工作流程中执行点击、滑动、输入文本与截屏。

简介

adb-controller 技能提供了一个通过 Android Debug Bridge (ADB) 与 Android 设备交互的接口。它专为开发人员、质量测试人员及自动化爱好者设计,旨在桥接 AI 代理推理与移动设备执行之间的差距。通过基于脚本的架构,代理可以将自然语言指令转换为精确的 shell 操作,从而实现对实体或模拟设备的免手动控制。

  • 执行 shell 指令,例如 input tap(点击)、swipe(滑动)、keyevent(按键事件)及文本输入。

  • 为每个动作自动进行截屏,使代理能够进行视觉验证。

  • 与 openclaw.json 无缝整合,方便进行个别设备或服务器的连接设定。

  • 支持标准 ADB 协议,确保与任何已连接的设备或网络可访问的 ADB 服务器兼容。

  • 具备反馈循环设计,视觉输出会直接传送回对话界面。

  • 用户必须在 openclaw.json 配置文件中配置 adbServer(设备序列号或 IP:port)。

  • 此技能依赖 exec 工具来执行 python 脚本;请确保环境具有适当的 ADB 权限,且设备已通过 USB 调试进行授权。

  • 最适合用于涉及 UI 导航、自动化测试或在 Android 上执行重复性手势的任务。

  • 始终确保设备处于屏幕开启且已解锁的状态,如果设备需要凭证输入或受限于系统级输入限制,ADB 指令可能会失败。

  • 视觉输出对代理来说至关重要;请确保代理使用带有 media 参数的 message 工具,以正确显示结果截屏。

仓库统计

Star 数
4,450
Fork 数
1,213
Open Issue 数
7
主要语言
Python
默认分支
main
同步状态
空闲
最近同步时间
2026年4月30日 08:24
在 GitHub 查看