Your old phone in a drawer is a better AI server than you think.
ZeroClaw-Android turns your Android phone into an always-on AI agent host. Not a Termux hack. Not a WebView. Native Rust compiled to ARM. Connect to 32+ providers -- OpenAI, Claude, Gemini, Groq, DeepSeek, Ollama, LM Studio, vLLM, Novita, Telnyx, and more -- and run autonomous agents around the clock with encrypted API key storage (AES-256-GCM) and a battery-optimized foreground service. No server required. No cloud bills. Just your phone.
Got an old phone? Give it a new job.
- Download the latest APK from GitHub Releases
- Add a provider -- paste your API key or point to a local Ollama instance
- Create an agent -- pick a model and configure its behavior
- Tap Start -- the daemon launches as a foreground service and runs until you stop it
The onboarding wizard walks you through all of this on first launch.
Disclaimer: This app is a personal project not associated with the ZeroClaw Labs team. It might break.
- 32 providers -- OpenAI, Anthropic, Gemini, Groq, DeepSeek, Mistral, Ollama, LM Studio, vLLM, LocalAI, OpenRouter, Together AI, Cohere, Perplexity, xAI, Novita, Telnyx, and more. Plus custom OpenAI-compatible and Anthropic-compatible endpoints.
- Terminal REPL -- command-line interface with slash commands for every gateway operation, powered by a Rhai scripting engine in Rust. Autocomplete, command history, image attachments, and raw Rhai expressions for power users.
- Plugin browser -- extend agents with tools for web search, code execution, file access, MQTT, and webhooks
- Encrypted key storage -- AES-256-GCM via Android Keystore, hardware-backed on StrongBox devices, biometric unlock to reveal
- Battery-optimized --
START_STICKYforeground service with OEM battery killer detection, auto-restart on boot, network transition handling - Material You -- dynamic color theming on Android 12+, adaptive navigation (bottom bar / rail / drawer), WCAG 2.2 AA accessibility
- Auto-restart -- your agents survive reboot, survive task kill, survive sleep. Exponential backoff on failures.
- Rust core -- ZeroClaw's router runs natively via UniFFI, with
catch_unwindat every FFI boundary. No JNI crashes.
The Terminal replaces the old Console with a command-line interface for interacting with the ZeroClaw daemon. Type natural language to chat with your agent, or use slash commands to access every gateway operation directly.
You type: /cost daily 2026 2 27
Kotlin: translates to Rhai expression "cost_daily(2026, 2, 27)"
Rust (FFI): eval_repl() evaluates the expression in the Rhai engine
Rhai engine: calls the registered cost_daily() function
Result: JSON string returned to Kotlin for rich terminal rendering
Plain text (anything not starting with /) is routed as a chat message through the agent, same as before.
| Command | Description |
|---|---|
/status |
Show daemon status |
/version |
Show ZeroClaw version |
/health [component] |
Health summary or component detail |
/doctor |
Run diagnostic checks |
/cost |
Total cost summary |
/cost daily <y> <m> <d> |
Cost for a specific day |
/cost monthly <y> <m> |
Cost for a specific month |
/budget <amount> |
Check spend against budget |
/events [limit] |
Show recent events |
/cron |
List all cron jobs |
/cron add <expr> <cmd> |
Add a recurring job |
/cron oneshot <delay> <cmd> |
Add a one-shot delayed job |
/cron get/pause/resume/remove <id> |
Manage individual jobs |
/skills |
List installed skills |
/skills install/remove/tools <arg> |
Manage skills |
/tools |
List available tools |
/memories [category] |
List memories |
/memory recall <query> |
Search memories |
/memory forget <key> |
Delete a memory |
/memory count |
Total memory count |
/help |
Show available commands |
/clear |
Clear terminal history |
Attach images through the input bar to send vision messages. Staged images appear as text labels (terminal aesthetic), and the attached files are passed to the vision API alongside your message.
Power users can type Rhai expressions directly for scripting:
let x = cost_daily(2026, 2, 27); x.total
The Rhai engine has access to all 33 gateway functions, so any combination of calls works.
- JetBrains Mono font for readability
- Dark surface (
surfaceContainerLowest) even in light theme - Braille spinner (
⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏) while awaiting responses, with static fallback in battery saver mode - Autocomplete popup filters commands as you type
- Command history persisted in Room, accessible by swiping up on the input field
- Screen reader support with semantic annotations on all terminal blocks, live regions for status changes, and linearized content descriptions
- Font scaling to 200% without clipping (all sizing in
sp, no fixed-height containers)
You already carry a computer with a multi-core ARM chip, 8GB RAM, always-on connectivity, and a built-in battery backup. Why buy another one?
Phones are designed to stay on. They handle push notifications, background services, and power management better than any Raspberry Pi. Add a cellular fallback and WiFi, and you have an always-connected edge device in your pocket.
Best for:
- Routing calls to cloud providers (OpenAI, Claude, Gemini)
- Running lightweight local models via Ollama on your network
- IoT agent hubs that need always-on connectivity
- Personal automation that runs while your laptop sleeps
Not ideal for:
- Running large local models on-device (use a desktop GPU or Ollama server)
- Workloads that need >8GB RAM
- Latency-critical applications under 100ms
| Old Android Phone | Mac Mini M4 | |
|---|---|---|
| Cost | $0 (you already own it) | $499+ |
| Power draw | 2-5W idle | 10-25W idle |
| Battery backup | Built in | Requires UPS ($50+) |
| Cellular fallback | Built in | Requires hotspot or dongle |
| Always-on design | Yes (it's a phone) | Yes (but no battery) |
| Local inference | Limited (API routing) | Strong (16-32GB unified memory) |
| Setup time | 5 minutes | 30+ minutes |
| Also a phone | Yes | No |
API keys are stored in EncryptedSharedPreferences backed by Android Keystore with AES-256-GCM encryption. On devices with a hardware security module (StrongBox), the master key is hardware-backed and never leaves the secure enclave.
- Keys are masked by default (last 4 characters visible)
- Biometric authentication required to reveal full keys
- Encrypted export/import with Argon2 key derivation
- Rust core uses memory-safe FFI -- no buffer overflows, no use-after-free
- The app is not distributed through third-party marketplaces. Builds are reproducible from source.
Your API keys never leave your device unencrypted. Not to a cloud. Not to a marketplace. Not to us.
OpenAI, Anthropic (Claude), Google Gemini, Ollama, LM Studio, vLLM, LocalAI, OpenRouter, Groq, DeepSeek, Mistral, xAI (Grok), Together AI, Fireworks AI, Perplexity, Cohere, GitHub Copilot, Amazon Bedrock, Cloudflare AI, Novita AI, Telnyx, and more. Any OpenAI-compatible or Anthropic-compatible endpoint works via the custom provider options.
Full Provider Matrix
| Provider | Auth Type | Category |
|---|---|---|
| OpenAI | API Key | Primary |
| Anthropic | API Key | Primary |
| Google Gemini | API Key | Primary |
| OpenRouter | API Key | Primary |
| Ollama | URL only | Primary |
| LM Studio | URL + optional key | Primary |
| vLLM | URL + optional key | Primary |
| LocalAI | URL + optional key | Primary |
| Groq | API Key | Ecosystem |
| Mistral | API Key | Ecosystem |
| xAI / Grok | API Key | Ecosystem |
| DeepSeek | API Key | Ecosystem |
| Together AI | API Key | Ecosystem |
| Fireworks AI | API Key | Ecosystem |
| Perplexity | API Key | Ecosystem |
| Cohere | API Key | Ecosystem |
| GitHub Copilot | API Key | Ecosystem |
| Venice | API Key | Ecosystem |
| Vercel AI | API Key | Ecosystem |
| Moonshot / Kimi | API Key | Ecosystem |
| MiniMax | API Key | Ecosystem |
| GLM / Zhipu | API Key | Ecosystem |
| Qianfan / Baidu | API Key | Ecosystem |
| Cloudflare AI | URL + optional key | Ecosystem |
| Amazon Bedrock | URL + optional key | Ecosystem |
| Novita AI | API Key | Ecosystem |
| Telnyx | API Key | Ecosystem |
| Synthetic | None | Ecosystem |
| OpenCode Zen | API Key | Ecosystem |
| Z.AI | API Key | Ecosystem |
| Custom OpenAI-compatible | URL + optional key | Custom |
| Custom Anthropic-compatible | URL + optional key | Custom |
Kotlin/Compose UI on top, Rust engine underneath, connected through Mozilla UniFFI. The Android foreground service manages the daemon lifecycle while Compose renders the management interface.
Architecture Details
FFI surface -- 34 functions cross the Rust-Kotlin boundary. The core lifecycle functions:
| Function | Description |
|---|---|
start_daemon(config, dataDir, host, port) |
Start the ZeroClaw daemon with TOML config |
stop_daemon() |
Signal shutdown and wait for all components |
get_status() |
Returns JSON health snapshot |
send_message(msg) |
Send a message to the gateway, returns response |
get_version() |
Returns native library version string |
eval_repl(expression) |
Evaluate a Rhai expression against the engine |
Plus 28 additional functions for cost tracking, cron scheduling, events, health diagnostics, memory, skills, tools, and vision. The Terminal REPL's eval_repl function wraps all of these behind a single Rhai scripting engine entry point.
Key implementation details:
catch_unwindwraps every FFI export to prevent Rust panics from crashing the JVM- The daemon runs on a dedicated Tokio multi-thread runtime
- Shutdown uses a
watchchannel (upstreamdaemon::run()blocks onctrl_c(), which is unsuitable for FFI) - Room database for persistent storage (agents, plugins, logs, activity events)
- DataStore for user preferences, EncryptedSharedPreferences for secrets
Ecosystem / Related Projects
| Project | Description | Relationship |
|---|---|---|
| ZeroClaw | Rust-native AI agent framework | Upstream core (git submodule) |
| OpenClaw | TypeScript-based AI agent platform | ZeroClaw is a Rust-native rewrite of the OpenClaw architecture |
| ZeroClaw-Android | This project | Android wrapper with native FFI |
ZeroClaw-Android wraps the upstream ZeroClaw engine without modification. Nader Dabit has called ZeroClaw "insanely fast" -- this project brings that speed to Android as an always-on service.
Building from Source
| Tool | Version | Notes |
|---|---|---|
| JDK | 17 | Eclipse Adoptium recommended |
| Android SDK | API 35 | Via Android Studio or sdkmanager |
| Android NDK | r27c | sdkmanager "ndk;27.2.12479018" |
| Rust | stable (1.85+) | rustup.rs |
| cargo-ndk | 4.x | cargo install cargo-ndk |
# Install Rust Android targets
rustup target add aarch64-linux-android x86_64-linux-android
# Clone with submodules
git clone --recursive https://github.com/Natfii/ZeroClaw-Android.git
cd ZeroClaw-Android
# Set environment (adjust paths for your system)
export JAVA_HOME="/path/to/jdk-17"
export ANDROID_HOME="/path/to/Android/Sdk"# Debug build (compiles Rust via cargo-ndk automatically)
./gradlew :app:assembleDebug
# Run tests
./gradlew :app:testDebugUnitTest :lib:testDebugUnitTest
# Lint checks
./gradlew spotlessCheck detektThe Gradle build invokes cargo-ndk via Gobley to cross-compile the Rust FFI library and generate UniFFI Kotlin bindings. No manual Rust build step needed.
ZeroClaw-Android/
app/ Android app (Kotlin/Compose)
lib/ Library module (AAR publishing)
zeroclaw/ Upstream ZeroClaw (git submodule)
zeroclaw-android/ Cargo workspace
zeroclaw-ffi/ UniFFI-annotated Rust facade
.github/workflows/ CI, upstream sync, release
FAQ
Does this run AI models on the phone itself? Not directly. ZeroClaw-Android runs the agent router -- it manages which models to call, handles tool execution, and orchestrates multi-step workflows. Inference happens on the provider's servers (OpenAI, Claude, etc.) or on a local Ollama instance on your network.
How much battery does it use? The foreground service is idle most of the time, waking only when an agent needs to act. Typical usage is 2-5% battery per day. The app detects battery saver mode and reduces animations and non-essential work.
Will my phone manufacturer kill the service? Some OEMs (Xiaomi, Samsung, Huawei, OnePlus) aggressively kill background services. The app detects these manufacturers and shows a one-time banner linking to dontkillmyapp.com with device-specific instructions.
What Android versions are supported? Android 8.0 (API 26) and above. Material You dynamic theming requires Android 12+, but the app works with a static color scheme on older versions.
Can I use this without an API key? Yes, if you connect to a local Ollama instance or use the Synthetic provider for testing. Most cloud providers require an API key.
Is there a Google Play release? Not yet. Distribution is via GitHub Releases for now. Google Play is on the roadmap, along with expanded plugin support and Tasker/automation integration.
Can I run multiple agents simultaneously? Yes. ZeroClaw's router supports multiple agents with independent configurations, each connected to different providers if needed.
This project is licensed under the MIT License. See LICENSE for details.
