使用droidrun库实现AI控制安卓手机

---

介绍

DroidRun 是一个框架，通过LLM代理控制 Android 设备。它允许您使用自然语言命令自动化 Android 设备交互。

安装环境

安装源码依赖

git clone https://github.com/droidrun/droidrun.git
cd droidrun
conda create --name droidrun python=3.11 -y
conda activate droidrun
pip install -e .

安装 ADB

• Install ADB

  • macOS:

  • brew install android-platform-tools
    

  • Windows: 下载 Android SDK Platform Tools 平台工具并解压 ZIP 文件

• 验证安装

  • (droidrun) ➜  droidrun git:(main) adb version
    Android Debug Bridge version 1.0.41
    Version 35.0.2-12147458
    Installed as /opt/homebrew/bin/adb
    Running on Darwin 24.4.0 (arm64)
    (droidrun) ➜  droidrun git:(main)
    

安装 DroidRun Portal 应用

• 下载地址

安装到手机

这里我使用的安卓虚拟机

droidrun setup --path=/Users/hejh/Desktop/droidrun-portal-v0.1.0.apk

(droidrun) ➜  droidrun git:(main) ✗ droidrun devices
Found 1 connected device(s):• emulator-5554
(droidrun) ➜  droidrun git:(main) ✗ droidrun setup --path=/Users/hejh/Desktop/droidrun-portal-v0.1.0.apk
Using device: emulator-5554
Set DROIDRUN_DEVICE_SERIAL to: emulator-5554
Step 1/2: Installing APK: /Users/hejh/Desktop/droidrun-portal-v0.1.0.apk
Installation successful!
Step 2/2: Enabling accessibility service
Accessibility service enabled successfully!Setup complete! The DroidRun Portal is now installed and ready to use.

设置 API 密钥

• 项目根目录创建一个 .env 文件或设置环境变量

# Choose at least one of these based on your preferred provider
export OPENAI_API_KEY="your_openai_api_key_here"
export ANTHROPIC_API_KEY="your_anthropic_api_key_here"
export GEMINI_API_KEY="your_gemini_api_key_here"

可以只设置OPENAI_API_KEY

验证设置

# Should list your connected device and show portal status
droidrun status

运行Demo

• droidrun "打开设置" --provider openai --model gpt-4.1-mini
  

• droidrun "打开Chrome，访问 www.baidu.com， 然后搜索 Weather" --provider openai --model gpt-4o