如何用DroidRun实现Android设备自动化？3分钟入门AI语音控制黑科技 🤖

DroidRun是一款革命性的Android设备自动化工具，它让你用自然语言命令就能轻松操控手机，支持OpenAI、Anthropic、Gemini等主流AI模型。无论是自动化测试、重复任务处理，还是为长辈设计简易操作流程，DroidRun都能让复杂操作变得像说话一样简单！

🚀 两种超简单安装方式（新手必看）

方法一：PyPI一键安装（推荐）

pip install droidrun

方法二：源码编译安装

git clone https://gitcode.com/gh_mirrors/dr/droidrun
cd droidrun
pip install -e .

📱 准备工作：3步完成环境配置

1. 安装ADB调试工具

• Windows：下载Android SDK Platform Tools并解压
• macOS：brew install android-platform-tools
• Linux：sudo apt install adb（Ubuntu/Debian）

验证安装是否成功：

adb version

2. 启用手机USB调试模式

1. 进入「设置 → 关于手机」连续点击版本号7次开启开发者模式
2. 进入「开发者选项」勾选「USB调试」并允许电脑调试授权

3. 安装DroidRun Portal应用

这是实现手机与AI通信的关键组件：

droidrun setup --path=/path/to/droidrun-portal.apk

或手动通过ADB安装：

adb install -r /path/to/droidrun-portal.apk

🔑 AI密钥配置：3行代码搞定

在终端执行以下命令（选择任意一个AI提供商）：

# OpenAI配置
export OPENAI_API_KEY="你的API密钥"

# Anthropic配置
export ANTHROPIC_API_KEY="你的API密钥"

# Google Gemini配置
export GEMINI_API_KEY="你的API密钥"

💻 3种实用操作方法（附示例）

基础命令模式

# 打开系统设置
droidrun "打开设置应用"

# 检查电池电量
droidrun "告诉我当前电池百分比"

指定AI模型执行

# 使用GPT-4o-mini打开计算器
droidrun "打开计算器并计算25*4" --provider openai --model gpt-4o-mini

# 使用Gemini安装应用
droidrun "安装并打开Instagram" --provider gemini --model gemini-2.0-flash

Python脚本高级控制

创建test_droidrun.py文件：

#!/usr/bin/env python3
import asyncio
import os
from droidrun.agent.react_agent import ReActAgent
from droidrun.agent.llm_reasoning import LLMReasoner
from dotenv import load_dotenv

load_dotenv()  # 加载.env文件中的API密钥

async def main():
    llm = LLMReasoner(
        llm_provider="gemini",
        model_name="gemini-2.0-flash",
        api_key=os.environ.get("GEMINI_API_KEY"),
        temperature=0.2
    )
    agent = ReActAgent(
        task="打开设置应用并检查Android版本",
        llm=llm
    )
    steps = await agent.run()
    print(f"执行完成，共 {len(steps)} 步")

if __name__ == "__main__":
    asyncio.run(main())

运行脚本：

python test_droidrun.py

🎯 5个实战应用场景

1. 自动化UI测试：droidrun/agent/droid/模块提供设备控制核心功能
2. 老年人辅助工具：用语音命令替代复杂操作
3. ** repetitive任务自动化**：如每日健康打卡、消息推送
4. 远程协助：技术支持人员可通过自然语言指导操作
5. 教学演示：自动展示APP功能，适合制作教程

📚 官方资源快速导航

• 完整文档：docs/
• 配置示例：droidrun/config_example.yaml
• 提示词模板：droidrun/config/prompts/
• 命令行工具：droidrun/cli/main.py

❓ 常见问题解决

Q: 设备连接失败怎么办？
A: 执行droidrun devices检查设备列表，确保ADB已识别设备，或使用droidrun connect 设备IP通过WiFi连接

Q: 如何切换不同AI模型？
A: 使用--provider参数指定模型提供商，如--provider anthropic切换到Claude

现在你已经掌握了DroidRun的核心用法！这款工具正在重新定义人与手机的交互方式，无论是普通用户还是开发者，都能从中找到提升效率的新方法。立即尝试用自然语言控制你的Android设备吧！ 🚀