Android セットアップ

ZeroClaw は Android デバイス向けの実験的なビルド済みバイナリを公開できます。

対応アーキテクチャ

安定版の事前ビルドリリースの対象（リリースワークフローから派生）は次のとおりです:

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 は Android 用の唯一のターゲットです。そのリリースバイナリは実験的なもので、そのビルドが成功した場合に添付されますが、すべてのリリースで提供されることは保証されません。存在しない場合は、ソースからビルドしてください（以下を参照）。32 ビット Android（armv7-linux-androideabi）は、現在、ビルド済みバイナリとして公開されていません。

Termux経由のインストール

AndroidでZeroClawを実行する最も簡単な方法は Termux 経由です。

1. Termuxをインストール

F-Droid (推奨) またはGitHubリリースからダウンロードします。

⚠️ 注意: Play Storeバージョンは古く、サポートされていません。

2. ZeroClawをダウンロード

sh

# アーキテクチャを確認
uname -m
# aarch64 = 64 ビット（実験的なビルド済みバイナリを利用できる場合があります）
# armv7l/armv8l = 32-bit (build from source — no prebuilt binary)

# 必要に応じて、実験的な 64 ビット (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 ダウンロードに失敗しました。GitHub が 404 を報告した場合は、以下のソースからビルドしてください。それ以外の場合は、エラーを確認して再試行してください。
fi

アーカイブの展開が正常に完了した場合にのみ、次の手順に進んでください。それ以外の場合は、アセットが見つからないときはソースからビルドするか、ダウンロードエラーを解決して再試行してください。

3. インストールして実行

sh

chmod +x zeroclaw
mv zeroclaw $PREFIX/bin/

# インストールを確認
zeroclaw --version

# セットアップを実行
zeroclaw quickstart

ADB経由の直接インストール

Termux外でZeroClawを実行したい上級ユーザー向け:

sh

# コンピュータからADB経由で
adb push zeroclaw /data/local/tmp/
adb shell chmod +x /data/local/tmp/zeroclaw
adb shell /data/local/tmp/zeroclaw --version

⚠️ Termux外での実行にはルート化されたデバイスまたは完全な機能性のための特定の権限が必要です。

Android上の制限事項

systemdなし: デーモンモード用にTermuxの termux-services を使用
ストレージアクセス: Termuxストレージ権限が必要です (termux-setup-storage)
ネットワーク: 一部の機能はローカルバインディング用にAndroid VPN権限が必要な場合があります

ソースからのビルド

Android用に自分でビルドするには:

sh

# Android NDKをインストール
# Add targets
rustup target add armv7-linux-androideabi aarch64-linux-android

# NDKパスを設定
export ANDROID_NDK_HOME=/path/to/ndk
export PATH=$ANDROID_NDK_HOME/toolchains/llvm/prebuilt/linux-x86_64/bin:$PATH

# ビルド
cargo build --release --target armv7-linux-androideabi
cargo build --release --target aarch64-linux-android

トラブルシューティング

「Permission denied」

sh

chmod +x zeroclaw

「not found」またはリンカーエラー

デバイスに対して正しいアーキテクチャのダウンロードを確認してください。

旧式 / 32 ビット Android

32 ビット版の Android バイナリは事前ビルドされていません。32 ビットのデバイスでは、armv7-linux-androideabi ターゲットを追加し、上記のようにソースからビルドしてください。

Keyboard shortcuts

ZeroClaw Docs