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 外部运行需要已 root 的设备或特定权限才能实现完整功能。

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

故障排除

“权限被拒绝”

sh

chmod +x zeroclaw

“未找到”或链接器错误

确保您为您的设备下载了正确的架构。

旧版 / 32 位 Android

没有预构建的 32 位 Android 二进制文件。在 32 位设备上，请添加 armv7-linux-androideabi 目标并按上述方式从源码构建。

Keyboard shortcuts

ZeroClaw Docs