TUTU Smart Control Β· AI Phone Control Hub
SUB-BRAND Β· OpenClaw / MeowClaw
Built-in Full OpenClaw Runtime (2026.6.1)
The lobster way π¦
AI Phone Avatar β Create Your Own Phone Automation Skills with AI
MeowHub Γ OpenClaw (The lobster way π¦)
Built-in Full OpenClaw, One-Tap Install on Android.
No manual Termux setup, no git clone on phone, no npm install, no fragile shell scripts.
Official Website β’
δΈζζζ‘£ β’
Skill Development Guide β’
Skill Gallery β’
Contributing
---
## What is MeowHub?
MeowHub is an open-source Android app that turns your phone into an **AI-powered automation agent**. It serves as **the hands and feet of AI in the physical world** β enabling AI to truly "see" your screen, "tap" buttons, and "swipe" through apps to accomplish any task on your phone. MeowHub runs entirely on your device, is fully open-source, and uses a declarative **Skill Engine** so you can create and share automation skills in JSON β no coding required.
### Built-in OpenClaw, Not a Separate DIY Install
MeowHub now ships with a **fully integrated OpenClaw runtime** inside the app. This is not a "go install Termux, then run a few commands, then hope npm works" experience. Instead, MeowHub bundles the **complete OpenClaw-based MeowClaw stack** and can install it for users with **one tap**.
- **Built-in full OpenClaw** β bundled runtime, workspace, terminal, console, and Android bridge
- **One-tap install** β bootstrap, Node.js, npm, OpenClaw, workspace assets, and gateway are prepared automatically
- **No phone-side dependency hell** β no manual `git clone`, `npm install`, or package chasing on-device
- **More stable in bad network conditions** β key runtime assets are pre-packaged in the APK instead of fetched during first launch
- **Ready-to-use AI console** β terminal + web console are embedded directly in MeowHub
This matters because phone-side package installs are often the most fragile part of mobile AI-agent deployment: flaky network, broken mirrors, missing binaries, Android linker quirks, and inconsistent shell environments. MeowHub hides that complexity and delivers a **near out-of-box OpenClaw experience on Android**.
**Our vision:** Everyone can create and share their own phone AI avatar skills β giving AI the power to interact with the physical world.
### Why MeowHub? β A Fundamental Difference from Accessibility-Based Solutions
Most phone automation tools (Auto.js, Hamibot, etc.) rely on Android's **AccessibilityService**. This approach has critical flaws. MeowHub uses the **system-level ADB protocol**, solving these problems by design:
> **System-Level, Undetectable**
> Accessibility-based solutions run at the application layer. Major apps like WeChat, TikTok, Taobao, and Alipay actively detect Accessibility Services β triggering risk controls or even **account bans**. MeowHub operates through ADB at the system level, completely transparent to target apps, equivalent to real finger touches, **undetectable by any application**.
> **Stable & Reliable, One-Time Pairing**
> Accessibility permissions are fragile β broken by OS updates, inconsistent across OEM ROMs, auto-revoked or interrupted by system prompts. MeowHub uses the standard ADB protocol for consistent and stable behavior. Pair once, use permanently β no repeated authorization needed.
> **No Blind Spots**
> Accessibility can only interact with UI elements that have Accessibility nodes β games, Canvas, and WebView are out of reach. MeowHub supports touch, swipe, and key input at any screen position, completely framework-agnostic.
**In short:** Accessibility-based solutions are "sneaking around on someone else's turf" β always at risk of detection. MeowHub is "operating with system-level authority" β stable, secure, and undetectable.
---
### The Hands and Feet of AI β More Than Automation
MeowHub is not just another RPA tool. Through deep integration with Large Language Models (LLMs), it becomes **the bridge between AI and the physical world**:
- **AI can "See"** β Screenshots + vision analysis to understand anything on screen
- **AI can "Think"** β Intelligent decisions based on screen state and context
- **AI can "Act"** β ADB operations translate decisions into real touches, swipes, and inputs
- **AI can "Learn"** β Declarative Skill system enables capabilities to accumulate and evolve
MeowHub is one of the few open-source solutions that lets AI **truly reach physical devices and execute real-world actions**. It's not simulating, it's not calling APIs β it's using your phone, operating like a human.
---
### Key Features
- **TUTU AI Chat** β Chat directly with TUTU AI in natural language. Ask questions (with web search), control your phone, or run skills β all from a single conversation. **5x faster** than OpenClaw-based conversation, with real-time streaming responses.
- **Skill Engine** β A declarative JSON-based automation engine supporting 15+ step types: API calls, AI vision analysis, conditional branching, loops, user prompts, and more
- **AI-Powered Actions** β Leverages LLM (Large Language Model) to understand screenshots, locate UI elements, and make intelligent decisions
- **System-Level ADB** β Fully self-contained ADB implementation with mDNS discovery, TLS pairing (SPAKE2), and RSA key persistence β no PC required, zero detection risk
- **Built-in Full OpenClaw** β OpenClaw is embedded as a first-class capability inside MeowHub, not left to users as a separate manual install task
- **One-Tap MeowClaw Installation** β Pre-bundled bootstrap, Node.js, npm, OpenClaw runtime, workspace skills, and gateway configuration
- **Embedded Terminal + Console** β Switch between terminal output and OpenClaw web console directly inside the app
- **Skill Marketplace** β Browse, search, and run community-created skills with one tap
- **Overlay Control** β Floating panel for quick actions and real-time skill execution status
- **Open Ecosystem** β Create your own skills in JSON, contribute to the community, and build your personal phone AI avatar
### What's New in v1.1.0
**Device Control β Massively Expanded**
- TutuGui Server (scrcpy-server) upgraded to v0312: command count expanded from 27 to **36**
- 11 new Socket commands: `list_packages`, `get_app_info`, `force_stop_app`, `uninstall_app`, `install_apk`, `clear_app_data`, `send_sms`, `read_sms`, `get_device_info`, `execute_shell`, `call_state_event`
- 7 new HTTP Bridge endpoints for AI-driven app management and SMS β OpenClaw can now manage apps and send/read SMS via structured APIs
**AI & Chat Enhancements**
- Advanced Settings with model detection β verify your API configuration works before chatting
- Logged-in users auto-connect to TutuAI proxy β zero manual API setup needed
- AI messages now render **Markdown** with table zoom and long-press copy
- Smarter prompts: common apps map directly to package names (e.g., WeChat -> `com.tencent.mm`), reducing unnecessary queries
**Navigation & UX**
- Full navigation rewrite using Jetpack Navigation Compose β smoother transitions, correct back behavior
- ADB pairing now shows a setup notice dialog first
- Notification permission redirects to system settings page
### How It Works
```
ββββββββββββββββββββ
β MeowHub App β
β (Skill Engine) β
ββββββββββ¬ββββββββββ
β ADB Protocol (TLS)
βΌ
ββββββββββββββββββββ
β ADB Daemon β
ββββββββββ¬ββββββββββ
β shell: app_process
βΌ
ββββββββββββββββββββ βββββββββββββββ
β TutuGui Server βββββββΊβ AI Provider β
β (scrcpy-server) β β (LLM API) β
ββββββββββ¬ββββββββββ βββββββββββββββ
β JSON Socket
βΌ
ββββββββββββββββββββ
β Touch / Swipe / β
β Screenshot / UI β
ββββββββββββββββββββ
```
## Screenshots
| View | Description |
|------|-------------|
| **TUTU AI Chat** | Chat directly with TUTU AI β ask questions, get real-time web answers, or command your phone with natural language. **5x faster** than OpenClaw-based conversation. |
| Skill Marketplace | Browse and run built-in MeowHub skills to start AI-driven phone automation quickly |
| Terminal | Inspect Gateway / OpenClaw runtime logs and debug startup or execution flow |
## Getting Started
### Prerequisites
| Requirement | Version |
|------------|---------|
| Android | 9+ (API 28), recommended 11+ for wireless debugging |
| Java | 17 |
| Kotlin | 2.3.10 |
| Android Gradle Plugin | 9.0.1 |
| Gradle | 9.2.1 |
| NDK | 28.x (CMake 3.22.1) |
### Build
1. **Clone the repository**
```bash
git clone https://github.com/zhaojiaqi/MeowHub.git
cd MeowHub
```
2. **Configure secrets**
Copy the example configuration and fill in your API keys:
```bash
cp secrets.properties.example secrets.properties
```
Edit `secrets.properties` with your credentials:
```properties
DOUBAO_API_KEY=your_api_key_here
DOUBAO_BASE_URL=https://ark.cn-beijing.volces.com/api/v3
DOUBAO_MODEL_ID=your_model_id_here
TUTU_APP_ID=your_app_id_here
TUTU_APP_SECRET=your_app_secret_here
```
> **Doubao API key**: Obtain from [Volcengine](https://www.volcengine.com/product/doubao). The AI provider is pluggable β contributions for other LLM providers (OpenAI, Gemini, etc.) are welcome!
>
> **TUTU_APP_ID / TUTU_APP_SECRET**: Used to connect to TUTU Smart Control device services. Visit the [project official website](https://tutuai.me), log in, go to **User Center** β **TUTU API KEY**, and click "Apply for API KEY" to get your App ID and App Secret.
3. **Build and install**
```bash
./gradlew assembleDebug
./gradlew installDebug
```
### First Run
1. Enable **Wireless Debugging** in Developer Settings on your Android device
2. Open MeowHub and follow the pairing wizard
3. Tap to install the built-in **MeowClaw / OpenClaw** runtime
4. Wait for MeowHub to automatically prepare the bundled bootstrap, Node.js, npm, OpenClaw, workspace, and gateway
5. Once connected, open the embedded terminal or console, or browse the Skill Marketplace and run a skill from "My Skills"
> **Why we emphasize this so much:** the app includes a **complete built-in OpenClaw distribution** designed for Android deployment. Users do **not** need to manually set up Termux, clone repositories, install Node.js, or troubleshoot npm dependency failures on the phone.
## Skill Ecosystem
MeowHub's power comes from its **extensible Skill system**. Skills are defined in simple JSON files and can automate virtually anything on your phone.
### Built-in Skills (19+)
| Category | Skills |
|----------|--------|
| Social | WeChat Auto Reply, WeChat Moments Like, Check Messages, Add Friend |
| Entertainment | Browse TikTok, TikTok Skip Ads, Browse Xiaohongshu |
| Daily | Check Weather, Daily News, Set Alarm, SMS Summary |
| Shopping | Taobao Search, Meituan Food |
| Tools | Screen Translate, Photo Cleanup, Storage Cleanup, WiFi Diagnose, Phone Health Check, Eye Comfort |
### Create Your Own Skill
Skills are JSON files with a declarative step-by-step structure. Here's a minimal example:
```json
{
"name": "hello-world",
"display_name": "Hello World",
"version": "1.0.0",
"steps": [
{
"id": "check_screen",
"type": "ai_check",
"prompt": "Describe what you see on the screen",
"save_as": "screen_info"
},
{
"id": "report",
"type": "ai_summary",
"prompt": "Summarize: ${screen_info}",
"output": "result"
}
]
}
```
For the complete guide, see **[Skill Development Guide](docs/skill-development-guide.md)**.
### Contributing Skills
We encourage everyone to create and share skills! Submit your skills via Pull Request to the [`skills/`](skills/) directory. See [CONTRIBUTING.md](CONTRIBUTING.md) for details.
## Tech Stack
| Layer | Technology |
|-------|-----------|
| UI | Jetpack Compose + Material 3 |
| State | ViewModel + StateFlow / SharedFlow |
| Navigation | Navigation Compose |
| Network | Kotlinx Serialization JSON + Custom Socket Protocol |
| ADB | Self-implemented ADB v2 (TLS, SPAKE2 Pairing) |
| Native | CMake + C++ (BoringSSL SPAKE2) |
| AI | Pluggable AI Provider (Doubao / Custom) |
## Project Structure
```
app/src/main/java/com/tutu/meowhub/
βββ core/
β βββ adb/ # Wireless ADB protocol stack
β βββ auth/ # Token authentication
β βββ engine/ # Skill execution engine (core)
β βββ model/ # Data models
β βββ network/ # MeowHub API client
β βββ repository/ # Data repository
β βββ service/ # Foreground services
β βββ socket/ # TutuSocketClient (TCP)
βββ feature/
β βββ chat/ # TUTU AI Chat module
β βββ debug/ # Debug panel
β βββ engine/ # Skill engine ViewModel
β βββ market/ # Skill marketplace UI
β βββ myskills/ # My skills UI
β βββ navigation/ # Main navigation
β βββ overlay/ # Floating overlay
β βββ settings/ # Settings & ADB control
βββ ui/theme/ # Material 3 theme
```
## Acknowledgements
MeowHub stands on the shoulders of these amazing open-source projects:
- **[scrcpy](https://github.com/Genymobile/scrcpy)** β The brilliant screen mirroring tool that inspired our device control layer. MeowHub's TutuGui Server is built upon scrcpy-server.
- **[Shizuku](https://github.com/RikkaApps/Shizuku)** β Pioneered the approach of using ADB for app-level privilege elevation on Android, which greatly inspired our wireless ADB implementation.
Special thanks to the developers and communities behind these projects. Their work has made MeowHub possible.
## Author
**zivzhao** β [Official Website](https://tutuai.me) Β· [GitHub](https://github.com/zhaojiaqi) Β· [Email](mailto:zivzhao@icloud.com)
## License
MeowHub is licensed under the **GNU General Public License v3.0** β see the [LICENSE](LICENSE) file for details.
```
Copyright (C) 2025 zivzhao and MeowHub Contributors
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
```
### Help Wanted
We especially welcome contributions that improve the **Skill Engine's core algorithms**:
- **RPA Execution Efficiency** β Optimize step execution flow, reduce unnecessary waits, improve command batching
- **AI Analysis Accuracy** β Better prompt engineering for `ai_check`/`ai_act` steps, reduce hallucinations, improve UI element recognition
- **Token Consumption Optimization** β Balance between AI analysis quality and token cost, implement smarter screenshot strategies, reduce redundant AI calls
- **Error Recovery** β More robust failure handling and retry strategies
These are active areas where the current implementation has room for significant improvement. If you're interested in RPA automation or LLM-powered agents, this is a great project to dive into!
## Star History
[](https://www.star-history.com/#zhaojiaqi/MeowHub&type=date&legend=top-left)
---
Made with β€οΈ for the open-source community