核心功能与用法
DuoPlus CloudPhone Agent 是一个基于 ADB(Android Debug Bridge)的远程云手机自动化控制工具。它通过向目标设备发送 Base64 编码的 JSON 广播指令,实现对 Android 云手机的全面操控。
核心工作流程:
1. 使用 get_ui_state 获取当前屏幕状态(UI 元素描述 + 截图)
2. 发送执行指令(如 CLICK_ELEMENT、INPUT_CONTENT、SLIDE_PAGE)
3. 等待 1-3 秒让操作生效
4. 再次调用 get_ui_state 验证结果
5. 循环直至任务完成
主要指令类别:
- 查询类(有返回):
get_ui_state获取屏幕交互元素和截图;PAGE_SCREENSHOT截屏 - 导航类:返回、主页、打开应用
- 点击类:坐标点击、元素点击、长按、双击
- 输入类:文本输入、键盘按键
- 滑动类:指定方向滑动
- 等待类:固定时长等待、等待元素出现
坐标系统采用 0-1000 相对值,非像素坐标。
显著优点
1. 完整的自动化能力:覆盖点击、滑动、输入、截屏、应用启动等手机操作全场景
2. 双模响应机制:查询指令同步返回,执行指令异步处理,兼顾效率与灵活性
3. 结构化数据返回:get_ui_state 返回可解析的 UI 元素描述,便于 AI 理解屏幕内容
4. 相对坐标系统:0-1000 标准化坐标,适配不同分辨率设备
5. 任务生命周期管理:内置 END_TASK 标记,支持完整的任务流程控制
6. 多设备支持:通过 -s DEVICE_ID 参数可同时管理多台设备
潜在缺点与局限性
1. 强依赖前置服务:必须安装 StandardSoftwareService 系统级服务,无法通用
2. 无直接执行反馈:除查询指令外,动作指令均为 fire-and-forget,需自行轮询验证
3. ADB 网络暴露风险:远程连接依赖 adb connect IP:PORT,若网络未隔离存在未授权访问可能
4. Base64 编码开销:所有指令需编码传输,大指令存在性能损耗
5. 固定 MD5 校验:使用硬编码 openclaw-md5,实际安全性存疑
6. 云手机平台绑定:专为 DuoPlus 云手机设计,迁移成本较高
适合人群
- 云手机平台运维人员
- 移动端自动化测试工程师
- 需要批量管理 Android 虚拟设备的开发者
- 社交媒体矩阵运营、应用多开等场景的技术用户
常规风险
1. 网络层暴露:ADB 默认 5555 端口若暴露于公网,可被未授权利用
2. 权限过度:系统级服务拥有完整设备控制权,一旦攻破影响严重
3. 指令注入:若 params 内容未严格校验,可能存在命令注入风险
4. 隐私泄露:截图和 UI 数据回传包含敏感界面信息
5. 服务稳定性:依赖第三方云手机服务商的基础设施可用性