duoplus-agent

# DuoPlus CloudPhone Agent
Control Android cloud phones remotely through ADB broadcast commands. The target device must be running **DuoPlus CloudPhone**.

For more information about our product and services, visit [DuoPlus Official Website](https://www.duoplus.net/).

## Connection

Before any operation, connect to the device:

```bash
# List available devices
adb devices -l

# Connect to remote device (if needed)
adb connect <IP>:<PORT>
```

All subsequent commands use `-s <DEVICE_ID>` to target a specific device.

## Environment Check

This skill only works on DuoPlus cloud phones with Service version >= 2.0.0. Before using any commands, verify the device is compatible:

```bash
# Check if device is a supported DuoPlus cloud phone
scripts/check_env.sh <DEVICE_ID>

# Or without device ID (uses default connected device)
scripts/check_env.sh
```

The script checks `/data/misc/dplus/version` on the device. If the file doesn't exist or the version is below 2.0.0, the device is not supported.

You can also check manually:
```bash
adb -s <DEVICE_ID> shell cat /data/misc/dplus/version
```

## How Commands Work

Commands are sent as Base64-encoded JSON via ADB broadcast:

```bash
# 1. Build JSON payload
JSON='{"task_type":"ai","action":"execute","task_id":"TASK_ID","md5":"MD5","action_name":"ACTION","params":{...}}'

# 2. Base64 encode
BASE64=$(echo -n "$JSON" | base64 -w 0)

# 3. Send broadcast
adb -s <DEVICE_ID> shell am broadcast -a com.duoplus.service.PROCESS_DATA --es message "$BASE64"
```

Generate a unique task_id per session (e.g. `openclaw-$(date +%s)`). Use a fixed md5 like `openclaw-md5`.

## Response Model

There are two types of commands with different response behaviors:

### Query command (synchronous response)
`get_ui_state` is the only query command. The broadcast receiver returns a JSON response directly in the broadcast result data, containing UI element descriptions and a Base64-encoded screenshot. You can read the response from the broadcast output....

# DuoPlus CloudPhone Agent

📱 OpenClaw skill for controlling Android cloud phones via ADB broadcast commands.

## Installation

### From ClawHub
```bash
clawhub install duoplus/duoplus-agent
```

### Local Install (Testing)
```bash
# 复制到 OpenClaw 的 skills 目录
cp -r android-rpa ~/.openclaw/skills/duoplus-agent
```

Or use workspace-level:
```bash
mkdir -p ./skills
cp -r android-rpa ./skills/duoplus-agent
```

## Prerequisites

- `adb` installed and in PATH
- Target Android device running `StandardSoftwareService`

## Usage

Just tell OpenClaw what you want to do:

```
Connect to device 192.168.1.100:5555 and open WeChat
```

```
Take a screenshot of the current screen on device emulator-5554
```

```
Click the "Login" button on the Android device
```

The agent will use ADB broadcast commands to control the device.

## How It Works

Commands are sent as Base64-encoded JSON via ADB broadcast to `com.duoplus.service.PROCESS_DATA`. The Android system service receives and executes operations (tap, swipe, type, screenshot, etc.).

## License

MIT