Skip to content

HenryZ838978/pocketclaw

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

7 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿฆž PocketClaw

Your AI butler. In your pocket. No server required.

A serverless, mobile-native AI agent. One APK. Runs on your phone. Not in a datacenter.

Download APK Kotlin License: MIT


A butler locked in your datacenter is not a butler. A butler walks where you walk.



๐Ÿ“ฑ Android APP Released!

PocketClaw v0.4.1 is live on real hardware. Download the APK โ†’

One install โ€” no server, no Docker, no terminal, no API key required.

๐Ÿ’ฌ Chat + Add Skills โœจ Skills Dashboard โš™๏ธ Settings
"Add a websearch skill" โ†’ Done. Built-in + unlimited custom skills Local LLM โ†” Cloud API one-tap switch

๐Ÿค” Why

Most AI agents today live on your laptop โ€” Docker, Node.js, terminal. That's great if you're a developer at your desk.

But most of the time, you're not at your desk. You're on your phone.

PocketClaw is a different take: what if the agent lived in your pocket from day one?

 Desktop Agents                    PocketClaw
 โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€                     โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
 ๐Ÿ’ป Docker / Node.js               ๐Ÿ“ฑ One APK install
 ๐Ÿ”Œ Dies when you leave home       ๐Ÿšถ Walks with you
 ๐ŸŒ Needs a server                 ๐Ÿ“ด Runs locally, no server
 ๐Ÿ’ฐ $15-40/month API costs         ๐Ÿ†“ Free with on-device LLM
 ๐Ÿ‘จโ€๐Ÿ’ป Developers only                ๐Ÿ‘ค Anyone

โšก Quick Start

Option A โ€” Download APK (easiest)

Go to Releases, download PocketClaw-v0.4.1-debug.apk, install on your Android phone.

Option B โ€” Build from source

cd PocketClaw/android
./gradlew assembleDebug
adb install -r app/build/outputs/apk/debug/app-debug.apk

Uses on-device Qwen3 by default (free, offline). Toggle to Cloud API in Settings if you want.


๐Ÿ”ง What It Can Do

PocketClaw can act, not just chat. 16 built-in tools with 4-level security:

Category Tools Security
Files read ยท write ยท list ยท delete L0-L2
Clipboard read ยท write L0-L1
Web search (DuckDuckGo) L0
Schedule create ยท list reminders L0-L1
Apps launch any installed app L1
Messaging send via Telegram L2
Screen read ยท tap ยท swipe ยท input ยท back L0-L3 (experimental)

L0 = auto-approve ยท L1 = first-time grant ยท L2 = confirm every time ยท L3 = confirm + auto-revoke

Example

You:        "ๆœไธ€ไธ‹ๆ˜ŽๅคฉๅŒ—ไบฌ็š„ๅคฉๆฐ”"
PocketClaw: "ๆˆ‘ๆฅๅธฎไฝ ๆŸฅ๏ผ"
             โ†’ [T:web_search:ๅŒ—ไบฌ ๆ˜Žๅคฉ ๅคฉๆฐ”]
             โ†’ "ๆ˜ŽๅคฉๅŒ—ไบฌๆ™ด๏ผŒๆœ€้ซ˜ 22ยฐC๏ผŒๆœ€ไฝŽ 8ยฐC"

๐Ÿ›ก๏ธ Security

AI agents that can act on your behalf need to be trustworthy. PocketClaw uses 4 layers:

Layer What it does
PermissionGuard Every tool has a risk level (L0-L3). High-risk tools require explicit user confirmation via dialog.
PathSandbox File tools can only access /PocketClaw, /Download, /Documents. System paths blocked.
RateLimiter Max tool calls per turn. Cooldown between calls. Consecutive-fail circuit breaker.
AuditLog Every tool invocation is logged and viewable in Settings.

๐Ÿง  Dual-Mode Brain

Local Mode Cloud Mode
Model Qwen3-1.7B (Q8_0) MiniMax-M2.5
Runs on Your phone (llama.cpp) DashScope API
Privacy 100% offline Data sent to cloud
Cost Free ~ยฅ40/month
Switch One tap in Settings One tap in Settings

๐Ÿฆž Bond System โ€” It Remembers You

PocketClaw isn't stateless. It builds a memory of who you are:

  • Preferences โ€” "I like braised pork" โ†’ remembered
  • Habits โ€” "I always check news in the morning" โ†’ learned
  • Relationships โ€” "My mom's name is Li Wei" โ†’ stored
  • Facts โ€” "My office is in Zhongguancun" โ†’ noted

Your claw grows through 5 stages as you interact: Larva โ†’ Hatchling โ†’ Juvenile โ†’ Adult โ†’ Elder.


๐Ÿ—๏ธ Architecture

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚                  SINGLE APK                      โ”‚
โ”‚                                                  โ”‚
โ”‚  Input โ†’ SOUL Prompt โ†’ LLM โ†’ ToolParser         โ”‚
โ”‚          (Assembler)   (Local    (Parse [T:]     โ”‚
โ”‚                        or Cloud)  markers)       โ”‚
โ”‚                                      โ†“           โ”‚
โ”‚                              PermissionGuard     โ”‚
โ”‚                                      โ†“           โ”‚
โ”‚                              ToolExecutor        โ”‚
โ”‚                              (Execute + Audit)   โ”‚
โ”‚                                      โ†“           โ”‚
โ”‚                              Second-pass LLM     โ”‚
โ”‚                              (Final reply)       โ”‚
โ”‚                                                  โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

๐Ÿ—‚๏ธ Project Structure

PocketClaw/android/app/src/main/java/
โ”œโ”€โ”€ com/pocketclaw/
โ”‚   โ”œโ”€โ”€ app/                    # App layer (23 files)
โ”‚   โ”‚   โ”œโ”€โ”€ ui/                 # Chat ยท Memory ยท Skills ยท Settings
โ”‚   โ”‚   โ”œโ”€โ”€ messaging/          # Telegram ยท Discord ยท Feishu ยท Slack
โ”‚   โ”‚   โ”œโ”€โ”€ service/            # ScreenControl ยท TaskWorker
โ”‚   โ”‚   โ””โ”€โ”€ api/                # DashScopeProvider
โ”‚   โ””โ”€โ”€ claw/                   # Intelligence layer (27 files)
โ”‚       โ”œโ”€โ”€ tools/              # 16 tools + Parser ยท Executor ยท Registry
โ”‚       โ”œโ”€โ”€ security/           # PermissionGuard ยท AuditLog ยท PathSandbox
โ”‚       โ”œโ”€โ”€ prompt/             # SOUL ยท PromptAssembler ยท ContextBudget
โ”‚       โ”œโ”€โ”€ bond/               # BondEngine ยท Memory ยท Growth
โ”‚       โ””โ”€โ”€ skills/             # SkillRouter ยท CustomSkill
โ””โ”€โ”€ com/llmhub/llmhub/         # Engine layer (42 files, fork)
    โ””โ”€โ”€ inference ยท chat ยท model ยท TTS

๐ŸŒŠ Inspired By

PocketClaw stands on the shoulders of the open-source AI agent community:

  • OpenClaw (294Kโ˜…) โ€” pioneered the personal AI agent category
  • NanoClaw (20Kโ˜…) โ€” showed that security-first design matters
  • ZeroClaw (25Kโ˜…) โ€” proved Rust can build lightweight agents
  • LLM Hub โ€” provided the on-device inference engine we built upon

Our different bet: agents should be mobile-native and serverless from day one, not desktop-first with mobile as an afterthought.


๐Ÿ—บ๏ธ Roadmap

  • On-device LLM (Qwen3 via llama.cpp)
  • Cloud API mode (DashScope)
  • 16 built-in tools with 4-layer security
  • Bond growth system (5 stages)
  • Custom skills via chat
  • STT + TTS
  • 4-platform messaging bridge
  • Auto-download models (no ADB needed)
  • Home screen Widget
  • Vision (screenshot + multimodal)
  • APK size optimization (420MB โ†’ <200MB)
  • iOS companion

๐Ÿค Contributing

PocketClaw is in active development. We'd love help with:

  • Android โ€” better mobile agent UX
  • Prompts โ€” tuning SOUL prompts for different LLMs
  • Security โ€” auditing the permission/sandbox model
  • i18n โ€” the app supports 18 languages

๐Ÿ“œ License

MIT License. See LICENSE.


๐Ÿฆž Let your AI walk with you.

PocketClaw โ€” Project Carcinization

About

๐Ÿฆ€ Mobile-first AI agent framework. Your butler, in your pocket. OpenClaw alternative for 6.8B phone users.

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors