Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

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

AltStyle ใซใ‚ˆใฃใฆๅค‰ๆ›ใ•ใ‚ŒใŸใƒšใƒผใ‚ธ (->ใ‚ชใƒชใ‚ธใƒŠใƒซ) /