Android Agent

# android-agent — AI-Powered Android Phone Control

> Plug your old Android phone into your Mac/PC. Now your AI assistant can use it.

Got an old Android in a drawer? Connect it to any machine running OpenClaw — your gateway, a Mac Mini, a Raspberry Pi. Your AI can now open apps, tap buttons, type text, and complete tasks on a real phone. Book a cab, order food, check your bank app — anything you'd do with your thumbs.

## How It Works

Your AI agent sees the phone screen (via screenshots), decides what to tap/type/swipe, and executes actions via ADB. Under the hood it uses [DroidRun](https://github.com/droidrun/droidrun) with GPT-4o vision.

```
┌─────────────┐    screenshots    ┌──────────────┐    ADB commands    ┌─────────────┐
│  GPT-4o     │◄─────────────────│  DroidRun    │──────────────────►│  Android    │
│  Vision     │─────────────────►│  Agent       │◄──────────────────│  Phone      │
│             │   tap/type/swipe  │              │    screen state    │             │
└─────────────┘                   └──────────────┘                    └─────────────┘
```

## Works Two Ways

### Direct Mode
Phone plugged into your OpenClaw gateway machine via USB. Zero networking required.

```
[Gateway Machine] ──USB──► [Android Phone]
```

### Node Mode
Phone plugged into a Mac Mini, Raspberry Pi, or any OpenClaw node. The gateway controls it over the network.

```
[Gateway] ──network──► [Mac Mini / Pi node] ──USB──► [Android Phone]
```

For Node mode, connect ADB over TCP/WiFi so the node can forward commands.

## Quick Start (3 steps)

### 1. Enable USB Debugging
On your Android phone:
- Go to **Settings → About Phone**
- Tap **Build Number** 7 times to enable Developer Options
- Go to **Settings → Developer Options**
- Enable **USB Debugging**

### 2. Connect & Install
```bash
# Plug phone in via USB, then:
pip install -r requirements.txt
adb devices  # verify phone shows up — authorize on phone if prompted
```

### 3. Run Your First Task
```bash
export OPENAI_API_...