🦀 ZeroClaw Android

Your phone. Your AI. Always on.

💡 Why This Project Exists

This is a personal project built out of curiosity — to see how far I can push Android as a platform for running AI agents.

🤔 Can a phone run an AI service 24/7? → Yes, with watchdog recovery and Doze awareness.

🤔 Can it serve as an API server? → Yes, on port 8088 — any OpenAI-compatible app can connect.

🤔 Can it run AI offline? → Yes, via LiteRT LM — Gemma 4 with 32K context, streaming, and thinking mode.

🤔 Can it talk to 11 different chat platforms? → Yes, each with its own protocol quirks.

🤔 Can agents auto-monitor websites and push updates? → Yes, with change detection and scheduled delivery.

Every feature started as a question like these. Many didn't work on the first try — the BUGS.md has the full history.

I use Claude as a coding tool the same way I'd use docs or Stack Overflow — to move faster on implementation so I can focus on architecture, debugging real device behavior, and figuring out what Android actually allows.

🦀 What is ZeroClaw?

An Android app that runs AI in the background 24/7. It connects to your chat apps, gives you 30 AI tools, and lets you set up agents that automatically monitor things and send you updates. Everything is modular — you turn on only what you want.

📱 You → Pick your chat apps (Telegram / Discord / Slack / WhatsApp / ...)
                ↓
   🔧 ZeroClaw Service (runs in background)
                ↓
   🤖 AI Router → picks the best AI (Gemini, OpenAI, Anthropic, Ollama...)
                ↓
   🧰 Your enabled tools (web search, translate, image gen, RSS...)
                ↓
   ⚡ Optional add-ons:
       ├── 🕷️ Agents — auto-monitor websites & APIs, send you updates
       ├── 🧪 Playground — test any tool before using it
       ├── 🧠 Memory — AI remembers your conversations
       ├── 🔒 Security — biometric lock, audit log, rate limits
       └── 🔌 Integrations — Composio, MCP servers, A2A protocol
                ↓
   💬 Reply → your chat apps

📸 Screenshots

Home	Settings	API Keys

Model Catalog (Gemma 4)	All Models	Chat + Token Stats

Agents	Info & Setup Guide

✨ Features

🕷️ Autonomous Agents

Set up agents that monitor things for you and send updates to your chat apps automatically.

🧪 Tool Playground

Test any tool live before using it in real conversations.

• 🎛️ Enable/disable each tool individually
• 🧩 Pick which AI model to use for testing
• 📋 All test results logged on Home Screen

💬 11 Messaging Channels

All opt-in — enable only what you use.

🧰 30 AI Tools

🤖 Multi-Provider AI Support

Add unlimited API keys. If one fails, it automatically tries the next.

• 🔑 Unlimited API keys with priority ordering
• 📋 cURL import — paste a cURL to add a key
• 🧪 Test any key with one tap
• 📊 Usage stats per key
• 🎯 Smart routing — use hint:reasoning, hint:fast, hint:code etc. to pick the best AI

☁️ Cloudflare Tunnel

Access your ZeroClaw from anywhere in the world — not just your local network.

Settings → Cloudflare Tunnel → Quick Tunnel (default)
Your public URL appears in Live Logs → Server Address dialog.

📖 See our Cloudflare Tunnel on Android Guide for the full technical story — every problem we hit and how we solved it.

🌐 API Server

Any app that works with OpenAI can connect to ZeroClaw with zero code changes.

Works with: Continue.dev, Cursor, Open WebUI, LangChain, AutoGen, CrewAI, Aider, and any OpenAI SDK app.

from openai import OpenAI

client = OpenAI(
    base_url="http://<DEVICE_IP>:8088/v1",
    api_key="zc-no-key-needed"
)

response = client.chat.completions.create(
    model="zeroclaw",
    messages=[{"role": "user", "content": "Search the web for today's top tech news"}]
)
print(response.choices[0].message.content)

import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: 'http://<DEVICE_IP>:8088/v1',
  apiKey: 'zc-no-key-needed'
});

const response = await client.chat.completions.create({
  model: 'zeroclaw',
  messages: [{ role: 'user', content: 'Translate "hello" to Japanese, Spanish, and French' }]
});
console.log(response.choices[0].message.content);

🧠 Memory & Smart Search

🤖 Advanced AI

🔒 Infrastructure

🎨 Configuration & UX

🔌 Integrations

💡 All integrations are disabled by default — enable only what you need.

📴 Offline AI — Gemma 4 On-Device

Run Google Gemma 4 and other models 100% on your phone. No internet, no cloud, no data leaves your device.

Available models (one-tap download):

💡 You can also import your own .bin or .litertlm model files via the file picker.

🏗️ Architecture

app/src/main/java/ai/zeroclaw/android/
│
├── 📱 ui/                  → Screens (Home, Agents, Playground, Settings...)
├── 🕷️ agents/              → Agent system + 21 free API sources
├── 🧰 tools/               → 30 AI tools
├── 🤖 data/                → LLM routing, API keys, settings
├── 🧠 ai/                  → Multi-agent, workflows, thinking mode
├── 💾 memory/              → Vector search, cache, session tracking
├── 🔒 infra/               → Hooks, plugins, security, recovery
├── 💬 channels/            → 11 messaging channel implementations
├── ⚙️ service/             → Background daemon + boot receiver
└── 🌐 webchat/             → HTTP API server (port 8088)

🚀 Getting Started

What You Need

• 📱 Android 8.0+ device (or emulator)
• 🔧 Android Studio
• 🔑 At least one AI API key (Gemini, OpenAI, etc.)

Build & Run

git clone https://github.com/ashokvarmamatta/ZeroClawAndroid.git
cd ZeroClawAndroid
# Open in Android Studio → Run

First-Time Setup

1. 📖 Tap info on home screen for the setup guide
2. 🔑 Go to Settings → Manage API Keys → add your key
3. 🧪 Tap Test Key → Check All Models
4. 💬 Add your chat app tokens (Telegram, Slack, etc.)
5. 🧰 Enable tools you want in Settings → AI Tools
6. ▶️ Tap Start — done!

🛠️ Tech Stack

⚠️ Work in Progress

This project is actively being developed. Some features may not work perfectly yet. I'm continuously fixing bugs and adding improvements.

Status	What it means
	Working and tested
	Being worked on — may have issues
	Has known issues tracked in BUGS.md

Found a bug? Check BUGS.md first — it might already be tracked. If not, open an issue and I'll look into it.

Feature not working? Some features depend on specific API keys or device capabilities. Check the in-app Info Guide (tap ℹ️ on any Settings section) for setup instructions.

🤝 Contributing

Contributions welcome! Fork the repo, create a feature branch, and open a Pull Request.

📄 License

MIT License — see LICENSE for details.

🙏 Acknowledgements

Built on ZeroClaw by ZeroClaw Labs. Advanced features inspired by NullClaw and OpenClaw.

🦀 Built to run on your pocket supercomputer

Built by Ashok Varma Matta