android-agent
开源安卓设备自动化框架,AI驱动手机操控
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:android-agent。 它的用途是:开源安卓设备自动化框架,AI驱动手机操控 完整的 Skill 内容见:https://321skill.com/skills/android-agent/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'连接我桌上的Pixel 6手机,打开计算器,输入123+456,然后截图保存结果'。它会自动通过ADB连接设备,依次执行打开应用、点击按钮、输入数字、截图等操作,最后将截图返回给你。整个过程无需编写任何脚本,只需自然语言描述即可。
介绍
这个项目解决了AI代理无法直接操作实体手机的问题。在实际开发中,开发者经常需要让AI自动完成手机上的测试、数据采集、应用操作等任务,但传统方法需要编写复杂的ADB脚本或依赖UI自动化框架,集成门槛高。Ghost in the Droid提供了一套完整的工具链,让任何LLM代理都能通过MCP协议控制真实手机,实现屏幕读取、点击、滑动、输入等操作。
使用方式很简单,你只需要在电脑上安装并运行服务端,通过USB或Wi-Fi连接一台Android手机。之后就可以通过自然语言指令来让AI操控手机,例如“打开设置,将Wi-Fi关闭”或“帮我截图当前页面”。它内置了62个MCP工具,覆盖了设备控制、截图、文字输入、应用管理等常见操作,并支持通过Vue仪表盘实时查看手机画面。
它非常适合需要自动化测试、移动端AI应用开发、批量设备管理或远程协助的团队。尤其是那些已经使用Claude Code、Cursor、LangChain等AI编码工具的开发者,可以无缝集成,让AI直接操作手机完成验证、调试或数据采集任务。
建议在需要频繁进行手机端回归测试、多设备并发操作或AI驱动的移动端流程自动化时统一使用此工具。需要注意的是,它主要依赖ADB协议,需要手机开启开发者模式并授权USB调试;对于iOS设备,则需要额外配置Appium和WebDriverAgent。另外,AI模型需具备调用MCP工具的能力,本地模型可通过Ollama或vLLM集成。
常见问题
是否需要root手机才能使用?
不需要。Android设备只需开启开发者选项并授权USB调试即可,无需root。iOS设备则需通过WebDriverAgent进行桥接,无需越狱。
支持哪些AI模型或客户端?
支持任何兼容MCP协议的客户端,如Claude Code、Codex、Cursor、OpenCode等;模型方面支持Anthropic API、OpenRouter、Ollama本地模型、vLLM,甚至可在手机端运行llama.cpp或MLX。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/android-agent/raw/index.md 读取 android-agent 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/android-agent/raw/index.md(查看排版版本)