WebDroid Agent

WebDroid Agent 是一个以浏览器为核心的 Android 手机 Agent 实验项目。静态部署时它完全在前端运行；Docker 部署时会额外启用一个本地 Node API 代理，让模型请求通过容器转发而不是从浏览器直接跨域请求。它在浏览器中通过 WebUSB/WebADB 连接 Android 设备，截取手机屏幕并发送给 OpenAI 兼容的视觉模型，再把模型返回的受控动作解析、校验并通过 ADB 执行。 - 静态部署纯前端运行，适合本地实验、Cloudflare Pages 等静态站点部署。 - Docker 部署内置同源本地 API 代理，可避免模型服务浏览器 CORS 限制。 - 通过 WebADB 在浏览器中连接已开启 USB 调试的 Android 设备。 - 截取手机屏幕，并把截图、当前 App、设备状态、完整已安装应用列表和历史步骤发送给视觉模型。 - 支持 WebDroid JSON 系列动作协议和 canonical JSON 动作格式：webdroid_json 使用截图像素，webdroid_normalized_json 使用 Vision-Pointer 风格 0-1000 归一化坐标。 - 自动解析、规范化并校验模型返回的下一步动作。 - 通过 ADB 执行启动应用、点击、滑动、输入文本、返回、Home、长按、双击、等待等操作，支持模型显式配置等待时间。 - 支持输入前清空文本、动作后固定等待、瞬时模型 API 错误/模型空回复重试和非敏感执行失败的有限自动恢复。 - 支持可编辑 App Cards、本地 Custom Tools，以及只向模型暴露 ID/标签的安全 Secret 输入。 - 发送聊天消息后默认自动执行，也保留单步计划等高级调试能力。 - 支持敏感动作确认、完全无限制模式、最大步数限制、停止运行，以及高级区中的上下文重置和运行日志导出。 - 页面配置持久化到本机浏览器 localStorage，Agent thread/turn 历史持久化到 IndexedDB。 - 操作台快捷键：Cmd/Ctrl+K 聚焦输入框、Cmd/Ctrl+B 开关配置面板、Cmd/Ctrl+J 开关运行日志、Esc 停止运行；手机预览与聊天区之间的分隔条可拖拽调整宽度并记住比例（双击复位）。 - 验证 OpenAI 兼容视觉模型是否能理解真实手机界面。 - 调试手机 Agent 的 JSON 动作格式、坐标映射和自动执行流程。 - 在本地安全环境中做 Android UI 自动化原型实验。 - 想快速体验 WebUSB + ADB + 多模态模型闭环的开发者。 WebDroid Agent is the open-source project yeahhe365/WebDroid-Agent (https://github.com/yeahhe365/WebDroid-Agent) by yeahhe365, released under MIT. Ion packages it unmodified from commit 6ef50805d0f4, adding only a manifest, an icon and a storage compatibility script.

Written by yeahhe365, published to Oikou by Ben Grande.

• ★ 113 stars on GitHub
• Licence: MIT
• Upstream version v0.2.0
• Built from commit 6ef50805d0f4

View the repository on GitHub

Not rated. Nobody has said who this app is suitable for, so Personal Clouds and the Oikou app treat it as 18+.

Internet

It asks to reach these hosts, and no others:

• api.openai.com
• dashscope.aliyuncs.com
• generativelanguage.googleapis.com
• api.moonshot.cn

Personal Cloud tools

• Keep a database of its own on your Personal Cloud ion.db

Notifications

It does not send push notifications.

Storage

Up to 16 MB on your Personal Cloud.

Sign in to add this web app to a Personal Cloud of yours. It runs there, on your own computer, and you open it from there; nothing is installed on your phone.

Sign in to add