Skip to content

Deadendev/PocketClaw

 
 

Repository files navigation

PocketClaw

PocketClaw is an open-source AI assistant for Android that provides persistent memory, on-device inference, and extensive tool integration.

Overview

PocketClaw combines a conversational interface with a suite of capabilities, including customizable AI personality, multi‑service fallback, and a secure Linux sandbox for executing commands and scripts.

Installation

Build the APK from source or use a pre‑released binary.

# Debug build
./gradlew :androidApp:assembleFossDebug

# Release build (unsigned)
./gradlew :androidApp:assembleFossRelease

The signed release APK is generated by the GitHub Action when a tag matching v* is pushed. Required repository secrets are KEYSTORE_B64, KEY_ALIAS, and KEYSTORE_PASSWORD.

Core Features

  • Persistent memory – retains context and learned facts across sessions.
  • Customizable AI personality – edit the system prompt to define the assistant’s behavior.
  • Multi‑service fallback – utilizes 24 LLM providers with automatic failover.
  • On‑device inference – runs models locally via LiteRT, eliminating network dependence.
  • Tool execution – supports web search, notifications, calendar events, shell commands, and more.
  • MCP server support – integrates with any Model Context Protocol service.
  • Autonomous heartbeat – periodic self‑checks (every 30 minutes) that surface pending tasks.
  • Settings export/import – backup and restore configurations as JSON.
  • Encrypted local storage – conversations are stored securely on the device.
  • Text‑to‑speech – audible responses for hands‑free usage.
  • Linux sandbox – a sandboxed Alpine Linux environment for running commands, scripts, and tools.

Linux Sandbox

PocketClaw includes a lightweight Alpine Linux environment (≈3 MB) launched via proot. It provides:

  • Package installation – one‑tap install of bash, curl, wget, git, jq, python3, pip, node.
  • Interactive terminal – run commands manually alongside the AI.
  • Secure execution – all processes run in a sandbox with no host access.

Enable the sandbox in Settings → Linux Sandbox.

Usage Workflow

  1. Chat – user sends a message; the AI processes the request, invoking tools as needed.
  2. Memory – facts, preferences, and learnings are stored; high‑utility memories (5+ hits) can be promoted to the system prompt.
  3. Heartbeat – background self‑check runs every 30 minutes (08:00‑22:00). If attention is required, a notification is sent; otherwise, the process remains silent.

Supported Services

PocketClaw integrates with a wide range of LLM providers and external services:

  • Anthropic, OpenAI, Gemini, DeepSeek, Mistral, xAI, OpenRouter, Groq, NVIDIA, Cerebras, Ollama Cloud, LongCat, Together AI, Hugging Face, Venice AI, Moonshot AI, Z.AI, MiniMax, AIHubMix, Deep Infra, Fireworks AI, OpenCode, and others.
  • Free MCP servers such as Fetch, DeepWiki, Sequential Thinking, Context7, Globalping, CoinGecko, Manifold Markets, and Find‑A‑Domain.

Integrations

Splinterlands Auto‑Battle

Configure one or more LLM services, add your Hive account, and start auto‑play. PocketClaw will find matches, select strategies, and submit moves on‑chain, falling back to a simple picker if needed. Access via Settings → Integrations.

Supported Languages

Afrikaans, Albanian, Amharic, Arabic, Belarusian, Bengali, Bulgarian, Chinese (Simplified), Chinese (Traditional), Croatian, Czech, Danish, Dutch, English, Estonian, Filipino, Finnish, French, German, Greek, Gujarati, Hebrew, Hindi, Hungarian, Indonesian, Italian, Japanese, Kazakh, Korean, Latvian, Lithuanian, Malay, Marathi, Norwegian, Persian, Polish, Portuguese, Punjabi, Romanian, Romansh, Russian, Serbian, Slovak, Slovenian, Spanish, Swahili, Swedish, Tamil, Telugu, Thai, Turkish, Ukrainian, Urdu, Vietnamese, Zulu.

Building

Requires JDK 21 and the Android SDK.

# Debug build
./gradlew :androidApp:assembleFossDebug

# Release build (unsigned)
./gradlew :androidApp:assembleFossRelease

The resulting APKs are located in androidApp/build/outputs/apk/foss/<buildType>/.

Credits

About

OpenClaw alternative in your pocket

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Kotlin 100.0%