zeroclaw 0.1.7

Zero overhead. Zero compromise. 100% Rust. The fastest, smallest AI assistant.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100

# Android Setup


ZeroClaw provides prebuilt binaries for Android devices.

## Supported Architectures


| Target | Android Version | Devices |
|--------|-----------------|---------|
| `armv7-linux-androideabi` | Android 4.1+ (API 16+) | Older 32-bit phones (Galaxy S3, etc.) |
| `aarch64-linux-android` | Android 5.0+ (API 21+) | Modern 64-bit phones |

## Installation via Termux


The easiest way to run ZeroClaw on Android is via [Termux](https://termux.dev/).

### 1. Install Termux


Download from [F-Droid](https://f-droid.org/packages/com.termux/) (recommended) or GitHub releases.

> ⚠️ **Note:** The Play Store version is outdated and unsupported.

### 2. Download ZeroClaw


```bash
# Check your architecture

uname -m
# aarch64 = 64-bit, armv7l/armv8l = 32-bit


# Download the appropriate binary

# For 64-bit (aarch64):

curl -LO https://github.com/zeroclaw-labs/zeroclaw/releases/latest/download/zeroclaw-aarch64-linux-android.tar.gz
tar xzf zeroclaw-aarch64-linux-android.tar.gz

# For 32-bit (armv7):

curl -LO https://github.com/zeroclaw-labs/zeroclaw/releases/latest/download/zeroclaw-armv7-linux-androideabi.tar.gz
tar xzf zeroclaw-armv7-linux-androideabi.tar.gz
```

### 3. Install and Run


```bash
chmod +x zeroclaw
mv zeroclaw $PREFIX/bin/

# Verify installation

zeroclaw --version

# Run setup

zeroclaw onboard
```

## Direct Installation via ADB


For advanced users who want to run ZeroClaw outside Termux:

```bash
# From your computer with ADB

adb push zeroclaw /data/local/tmp/
adb shell chmod +x /data/local/tmp/zeroclaw
adb shell /data/local/tmp/zeroclaw --version
```

> ⚠️ Running outside Termux requires a rooted device or specific permissions for full functionality.

## Limitations on Android


- **No systemd:** Use Termux's `termux-services` for daemon mode
- **Storage access:** Requires Termux storage permissions (`termux-setup-storage`)
- **Network:** Some features may require Android VPN permission for local binding

## Building from Source


To build for Android yourself:

```bash
# Install Android NDK

# Add targets

rustup target add armv7-linux-androideabi aarch64-linux-android

# Set NDK path

export ANDROID_NDK_HOME=/path/to/ndk
export PATH=$ANDROID_NDK_HOME/toolchains/llvm/prebuilt/linux-x86_64/bin:$PATH

# Build

cargo build --release --target armv7-linux-androideabi
cargo build --release --target aarch64-linux-android
```

## Troubleshooting


### "Permission denied"

```bash
chmod +x zeroclaw
```

### "not found" or linker errors

Make sure you downloaded the correct architecture for your device.

### Old Android (4.x)

Use the `armv7-linux-androideabi` build with API level 16+.