本连机学

An open Android AI agent runtime that can see the screen, control apps, build tools, remember context, and route its own skills.

MobileClaw is an experimental Android app for running LLM agents on a real phone. It sits at the intersection of Android automation, mobile AI agents, accessibility-based phone control, on-device Python tools, multi-agent workflows, and VPN/proxy operations.

The idea is simple: a mobile agent should not just chat about your device. It should be able to observe the screen, choose the right tools, act through Android capabilities, create new workflows, and keep enough memory to improve across tasks.

中文 README

</div>

---

Build

Requirements:

• Android Studio Ladybug or newer
• JDK 21
• Android 11+ device or emulator
• An OpenAI-compatible chat endpoint and API key

git clone https://github.com/eggbrid2/mobileClaw.git
cd mobileClaw
./gradlew :app:assembleDebug

Debug APK:

app/build/outputs/apk/debug/app-debug.apk

The app uses Kotlin 2.2, Jetpack Compose, Room, DataStore, WebView, OkHttp, Gson, Jsoup, SnakeYAML, Chaquopy Python 3.11, LiteRT-LM, mihomo, and hev-socks5-tunnel.

Common Use Cases

• Android AI agent for phone control and app automation.
• VLM-style screen reading with coordinate-based tapping and scrolling.
• AI assistant that can operate real Android apps through AccessibilityService.
• Mobile agent runtime with task planning, role routing, and scoped tool injection.
• Multi-agent group chat with long-running tasks and interruptible work.
• AI-generated mini apps and native Android pages.
• Optional on-device local model runtime with downloadable Gemma LiteRT models.
• Clash/Mihomo subscription import and Android VPN control.
• Embedded Python execution and dynamic skill creation on Android.

Real Device Demo

Captured from a Xiaomi device running the debug build. These are real agent runs, not mockups: MobileClaw created and opened a WebView MiniAPP, created a native AI Page, kept a multi-agent group chat with stickers, manages on-device models with vision packs, and exposes its skill/VPN/runtime surfaces.

<p align="center"> <img src="docs/media/mobileclaw_pocket_synth.gif" alt="MobileClaw creates and runs an interactive Pocket Synth MiniAPP" width="360" /> <img src="docs/media/mobileclaw_real_ai_page.gif" alt="MobileClaw real chat to native AI Page flow" width="360" /> </p>

<p align="center"> <img src="docs/media/mobileclaw_fun_gallery.jpg" alt="MobileClaw real capabilities on device" width="820" /> </p>

Local And LAN APIs

• A loopback API server exposes skills, dynamic skill install/delete, memory, and config to local HTTP skills.
• A LAN console server exposes a browser UI, SSE task events, session/message APIs, skill export/import APIs, memory/config APIs, and a downloadable OpenClaw CLI script.
• The console page can be edited by the agent through console_editor.