Configuration Android

ZeroClaw peut publier un binaire précompilé expérimental pour les appareils Android.

Architectures prises en charge

Les cibles de publication précompilées stables (issues du workflow de publication) sont :

aarch64-apple-darwin
aarch64-unknown-linux-gnu
aarch64-unknown-linux-musl
arm-unknown-linux-gnueabihf
armv7-unknown-linux-gnueabihf
x86_64-apple-darwin
x86_64-pc-windows-msvc
x86_64-unknown-linux-gnu
x86_64-unknown-linux-musl

aarch64-linux-android est la seule cible Android. Son binaire de version est expérimental : il est joint lorsque cette compilation réussit, mais sa disponibilité n’est pas garantie pour chaque version. S’il est absent, compilez à partir des sources (voir ci-dessous). Android 32 bits (armv7-linux-androideabi) n’est actuellement pas publié sous forme de binaire précompilé.

Installation via Termux

La manière la plus simple d’exécuter ZeroClaw sur Android est via Termux.

1. Installez Termux

Téléchargez depuis F-Droid (recommandé) ou les versions de GitHub.

⚠️ Remarque : La version du Play Store est obsolète et non prise en charge.

2. Télécharger ZeroClaw

sh

# Vérifiez votre architecture
uname -m
# aarch64 = 64 bits (un binaire précompilé expérimental est peut-être disponible)
# armv7l/armv8l = 32-bit (build from source — no prebuilt binary)

# Télécharger éventuellement le binaire expérimental 64 bits (aarch64).
# A 404 means this release did not build it; use the source build below instead.
if curl -fLO https://github.com/zeroclaw-labs/zeroclaw/releases/latest/download/zeroclaw-aarch64-linux-android.tar.gz; then
  tar xzf zeroclaw-aarch64-linux-android.tar.gz
else
  echo Échec du téléchargement. Si GitHub a renvoyé une erreur 404, compilez à partir des sources ci-dessous. Sinon, vérifiez l’erreur et réessayez.
fi

Ne passez à l’étape suivante qu’une fois l’archive extraite avec succès. Sinon, compilez à partir des sources si l’artefact est manquant, ou corrigez l’erreur de téléchargement et réessayez.

3. Installer et exécuter

sh

chmod +x zeroclaw
mv zeroclaw $PREFIX/bin/

# Vérifier l'installation
zeroclaw --version

# Exécuter la configuration
zeroclaw quickstart

Installation directe via ADB

Pour les utilisateurs avancés qui souhaitent exécuter ZeroClaw en dehors de Termux :

sh

# Depuis votre ordinateur avec ADB
adb push zeroclaw /data/local/tmp/
adb shell chmod +x /data/local/tmp/zeroclaw
adb shell /data/local/tmp/zeroclaw --version

⚠️ L’exécution en dehors de Termux nécessite un appareil rooté ou des autorisations spécifiques pour une fonctionnalité complète.

Limitations sur Android

Aucun systemd : Utilisez termux-services de Termux pour le mode daemon
Accès au stockage : Nécessite les autorisations de stockage Termux (termux-setup-storage)
Réseau : Certaines fonctionnalités peuvent nécessiter l’autorisation VPN d’Android pour la liaison locale.

Compilation à partir des sources

Pour construire pour Android vous-même :

sh

# Installer le NDK Android
# Add targets
rustup target add armv7-linux-androideabi aarch64-linux-android

# Définir le chemin du NDK
export ANDROID_NDK_HOME=/path/to/ndk
export PATH=$ANDROID_NDK_HOME/toolchains/llvm/prebuilt/linux-x86_64/bin:$PATH

# Construire
cargo build --release --target armv7-linux-androideabi
cargo build --release --target aarch64-linux-android

chmod +x zeroclaw

« introuvable » ou erreurs de l’éditeur de liens

Assurez-vous d’avoir téléchargé la bonne architecture pour votre appareil.

Android ancien / 32 bits

Il n’existe pas de binaire Android 32 bits précompilé. Sur un appareil 32 bits, ajoutez la cible armv7-linux-androideabi et compilez depuis les sources comme indiqué ci-dessus.

ZeroClaw Docs