You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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.
14
+
PhoneClaw 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.
16
15
17
16
## Quick Start
18
17
@@ -25,7 +24,7 @@ Got an old phone? Give it a new job.
25
24
26
25
The onboarding wizard walks you through all of this on first launch.
27
26
28
-
***Disclaimer: This app is a personal project not associated with the ZeroClaw Labs team. It might break.***
27
+
***Disclaimer: This app is a personal project not associated with the PhoneClaw Labs team. It might break.***
29
28
30
29
## Features
31
30
@@ -36,13 +35,13 @@ The onboarding wizard walks you through all of this on first launch.
36
35
-**Battery-optimized** -- `START_STICKY` foreground service with OEM battery killer detection, auto-restart on boot, network transition handling
37
36
-**Material You** -- dynamic color theming on Android 12+, adaptive navigation (bottom bar / rail / drawer), WCAG 2.2 AA accessibility
38
37
-**Auto-restart** -- your agents survive reboot, survive task kill, survive sleep. Exponential backoff on failures.
39
-
-**Rust core** -- ZeroClaw's router runs natively via UniFFI, with `catch_unwind` at every FFI boundary. No JNI crashes.
38
+
-**Rust core** -- PhoneClaw's router runs natively via UniFFI, with `catch_unwind` at 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.
44
+
The Terminal replaces the old Console with a command-line interface for interacting with the PhoneClaw daemon. Type natural language to chat with your agent, or use slash commands to access every gateway operation directly.
46
45
47
46
### How it works
48
47
@@ -61,7 +60,7 @@ Plain text (anything not starting with `/`) is routed as a chat message through
61
60
| Command | Description |
62
61
|---|---|
63
62
|`/status`| Show daemon status |
64
-
|`/version`| Show ZeroClaw version |
63
+
|`/version`| Show PhoneClaw version |
65
64
|`/health [component]`| Health summary or component detail |
66
65
|`/doctor`| Run diagnostic checks |
67
66
|`/cost`| Total cost summary |
@@ -206,7 +205,7 @@ Kotlin/Compose UI on top, Rust engine underneath, connected through Mozilla UniF
| OpenClaw | TypeScript-based AI agent platform |PhoneClaw is a Rust-native rewrite of the OpenClaw architecture |
234
+
|PhoneClaw-Android | This project | Android wrapper with native FFI |
236
235
237
-
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.
236
+
PhoneClaw-Android wraps the upstream PhoneClaw engine without modification. Nader Dabit has called PhoneClaw "insanely fast" -- this project brings that speed to Android as an always-on service.
238
237
239
238
</details>
240
239
@@ -258,8 +257,8 @@ ZeroClaw-Android wraps the upstream ZeroClaw engine without modification. Nader
The Gradle build invokes `cargo-ndk` via [Gobley](https://github.com/aspect-build/gobley) to cross-compile the Rust FFI library and generate UniFFI Kotlin bindings. No manual Rust build step needed.
283
282
284
-
### Project structure
285
-
286
-
```
287
-
ZeroClaw-Android/
288
-
app/ Android app (Kotlin/Compose)
289
-
lib/ Library module (AAR publishing)
290
-
zeroclaw/ Upstream ZeroClaw (git submodule)
291
-
zeroclaw-android/ Cargo workspace
292
-
zeroclaw-ffi/ UniFFI-annotated Rust facade
293
-
.github/workflows/ CI, upstream sync, release
294
-
```
295
-
296
283
</details>
297
284
298
285
<details>
299
286
<summary>FAQ</summary>
300
287
301
288
**Does this run AI models on the phone itself?**
302
-
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.
289
+
Not directly. PhoneClaw 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.
303
290
304
291
**How much battery does it use?**
305
292
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.
@@ -317,7 +304,7 @@ Yes, if you connect to a local Ollama instance or use the Synthetic provider for
317
304
Not yet. Distribution is via GitHub Releases for now. Google Play is on the roadmap, along with expanded plugin support and Tasker/automation integration.
318
305
319
306
**Can I run multiple agents simultaneously?**
320
-
Yes. ZeroClaw's router supports multiple agents with independent configurations, each connected to different providers if needed.
307
+
Yes. PhoneClaw's router supports multiple agents with independent configurations, each connected to different providers if needed.
321
308
322
309
</details>
323
310
@@ -329,5 +316,5 @@ This project is licensed under the MIT License. See [LICENSE](LICENSE) for detai
329
316
330
317
<!-- GitHub repo settings (not rendered):
331
318
About/Description: Run AI agents 24/7 on your Android phone. Native Rust core, 32+ providers (OpenAI, Claude, Gemini, Groq, DeepSeek, Ollama, LM Studio, vLLM, Novita, Telnyx), encrypted key storage, plugin browser, Material You UI. Self-hosted alternative to Mac Mini setups. MIT licensed.
0 commit comments