aidanpark/openclaw-android
Run OpenClaw on Android with a single command — no proot, no Linux
OpenClaw on Android – 快速概览
它是什么 – 一个轻量安装程序，让你无需完整的 Linux 发行版即可在 Android 手机上运行 OpenClaw AI 代理平台。它附带 glibc 动态链接器、基于 glibc 构建的 Node.js 二进制文件，以及一组将标准 Linux 路径转换为 Termux 文件系统的脚本，因此常规的 OpenClaw 二进制文件可以原生运行。
为什么重要
| 传统方式（proot-distro） | 本项目 |
|---|---|
| 安装整个 Debian/Ubuntu rootfs（约 1-2 GB） | 仅安装 ld.so（约 200 MB） |
| 20-30 分钟设置，额外的 proot 层 → 更慢 | 3-10 分钟一键安装，原生速度 |
| 需要在 Termux 内管理 Linux 环境 | 直接在 Termux 中工作（或通过可选的 Claw 应用） |
结果是 更小的体积、更快的执行速度，以及为任何想在手机上运行 OpenClaw 代理的人提供 更简单的用户体验。
主要组件
| 组件 | 功能 |
|---|---|
| glibc ld.so | 提供 GNU C 库加载器，使标准 Linux 二进制文件能在 Android 的 Bionic/Termux 环境中运行。 |
| Node.js（arm64，glibc） | 运行 OpenClaw JavaScript 运行时；通过一个小型加载器脚本包装，无需 patchelf。 |
oa CLI |
用于安装、更新、备份、恢复和工具管理的辅助命令（oa --install、oa --update、oa --backup 等）。 |
| Claw Android 应用（可选） | 捆绑终端模拟器和 WebView UI；一键引导、仪表板和工具安装器 – 完全独立于 Termux 工作。 |
| 附加工具 | tmux、ttyd、dufs、Android 特定实用程序、Playwright、Claude-Code、Gemini-CLI、Codex-CLI（通过 oa --install 安装）。 |
安装步骤（Termux）
- 从 F-Droid 安装 Termux（Play Store 版本已失效）。
- 升级并安装 curl：
pkg upgrade -y && pkg install -y curl - 运行一键安装程序：
安装 glibc 加载器、Node.js 和 OpenClaw，约 200 MB。curl -sL https://myopenclawhub.com/install | bash && source ~/.bashrc - 完成 OpenClaw 引导：
openclaw onboard - 启动网关（提供 Web 仪表板的长期运行进程）：
在单独的 Termux 标签页中运行；按openclaw gatewayCtrl+C停止。
使用可选的 Claw 应用
- 从 Releases 页面下载 APK。
- 应用启动终端，运行相同的安装程序，然后提供图形仪表板（http://127.0.0.1:18789）和 设置 → 安装与更新 屏幕，该屏幕在底层调用
oa --update。 - 它可以安装额外工具、管理备份并显示运行时信息，而不会影响任何现有的 Termux 安装。
管理你的安装（oa 命令）
| 命令 | 用途 |
|---|---|
oa --update |
拉取固定的 OpenClaw、Node.js 和可选工具；创建更新前备份；验证可用空间。 |
oa --install |
安装可选附加组件（tmux、code-server、AI CLI 等）。 |
oa --uninstall |
从设备中移除 OpenClaw 和 glibc 加载器。 |
oa --backup / oa --restore |
使用安全检查将 ~/.openclaw（包括 SQLite 数据库）打包为 tar 归档；仅恢复数据，不恢复二进制文件。 |
oa --status |
显示哪些组件存在以及硬链接补丁是否激活。 |
所有命令都可以安全地重新运行；它们会锁定以避免并发更新。
数据安全与备份
- 备份存储在
~/.openclaw-android/backup/中，并且是 私有的（chmod 600）。它们包含 API 密钥和对话历史 – 切勿分享。 - 在任何版本更改之前，安装程序会自动创建更新前备份（保留最近三个）。
- 恢复会重写可能在 Termux 安装和 Claw 应用之间移动数据后残留的任何过时绝对路径。
性能与限制
- 命令可能感觉比在桌面上慢，因为它们读取手机存储上的许多文件。
- 网关必须 直接在 Termux 中运行，而不是通过 SSH；否则 SSH 会话结束时它会停止。
- 一些重型工具（code-server、Chromium）目前无法从应用安装，但可以通过终端手动添加。
谁应该使用这个？
- AI 代理开发者，他们想在移动设备上试验 OpenClaw。
- 高级用户，他们需要一个便携、低开销的 OpenClaw 节点用于测试或移动调试。
- 任何想要在 Android 上 一键、无需 Linux 发行版 设置的人。
快速参考备忘单
# 安装（Termux）
curl -sL https://myopenclawhub.com/install | bash && source ~/.bashrc
# 首次引导
openclaw onboard
# 运行网关（在标签页中保持运行）
openclaw gateway
# 更新所有内容
oa --update && source ~/.bashrc
# 安装额外工具（tmux、AI CLI 等）
oa --install
# 备份数据
oa --backup
# 恢复备份
oa --restore
底线： OpenClaw on Android 移除了重量级的 proot-distro 要求，为你提供一个轻量级（约 200 MB）的原生安装，让完整的 OpenClaw 代理生态系统直接在你的手机上运行，并通过 Claw 应用提供可选的 GUI 支持。
相关
- 项目
- 项目
- 项目
- 项目