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.

1. Install Termux

Download from F-Droid (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+.