Configuración de Android

ZeroClaw puede publicar un binario precompilado experimental para dispositivos Android.

Arquitecturas compatibles

Los destinos de lanzamiento estables precompilados (derivados del flujo de trabajo de lanzamiento) son:

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 es el único destino de Android. Su binario de lanzamiento es experimental: se incluye cuando esa compilación se realiza correctamente, pero no se garantiza en todos los lanzamientos. Si no está presente, compílalo desde el código fuente (consulta más abajo). Android de 32 bits (armv7-linux-androideabi) no se publica actualmente como binario precompilado.

Instalación a través de Termux

La forma más fácil de ejecutar ZeroClaw en Android es a través de Termux.

1. Instalar Termux

Descarga desde F-Droid (recomendado) o las versiones de GitHub.

⚠️ Nota: La versión de Play Store está desactualizada y no es compatible.

2. Descargar ZeroClaw

sh

# Verifica tu arquitectura
uname -m
# aarch64 = 64 bits (es posible que haya un binario precompilado experimental disponible)
# armv7l/armv8l = 32-bit (build from source — no prebuilt binary)

# Descargar opcionalmente el binario experimental de 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 La descarga falló. Si GitHub devolvió un 404, compila desde el código fuente que aparece a continuación. De lo contrario, comprueba el error y vuelve a intentarlo.
fi

Continúe con el siguiente paso solo después de que el archivo se extraiga correctamente. De lo contrario, compile desde el código fuente cuando falte el recurso, o resuelva el error de descarga y vuelva a intentarlo.

3. Instalar y ejecutar

sh

chmod +x zeroclaw
mv zeroclaw $PREFIX/bin/

# Verificar la instalación
zeroclaw --version

# Ejecutar configuración
zeroclaw quickstart

Instalación directa mediante ADB

Para usuarios avanzados que deseen ejecutar ZeroClaw fuera de Termux:

sh

# Desde tu computadora con ADB
adb push zeroclaw /data/local/tmp/
adb shell chmod +x /data/local/tmp/zeroclaw
adb shell /data/local/tmp/zeroclaw --version

⚠️ Ejecutar fuera de Termux requiere un dispositivo rooteado o permisos específicos para una funcionalidad completa.

Limitaciones en Android

Sin systemd: Usa termux-services de Termux para el modo daemon
Acceso al almacenamiento: Requiere los permisos de almacenamiento de Termux (termux-setup-storage)
Red: Algunas funciones pueden requerir el permiso de VPN de Android para el enlace local

Compilación desde el código fuente

Para compilar para Android por tu cuenta:

sh

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

# Establecer la ruta del NDK
export ANDROID_NDK_HOME=/path/to/ndk
export PATH=$ANDROID_NDK_HOME/toolchains/llvm/prebuilt/linux-x86_64/bin:$PATH

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

chmod +x zeroclaw

“no encontrado” o errores del enlazador

Asegúrate de haber descargado la arquitectura correcta para tu dispositivo.

Android antiguo / de 32 bits

No hay un binario precompilado de Android de 32 bits. En un dispositivo de 32 bits, agregue el target armv7-linux-androideabi y compile desde el código fuente como se muestra arriba.

ZeroClaw Docs