A
AidanPark/openclaw-android
Run OpenClaw on Android with a single command — no proot, no Linux
aiai-agentandroidhomelablow-powernodejsopenclawrepurpose-phoneself-hostedtermux
JavaMIT创建于 2026/2/11更新于 今天
README
由 Gemini 翻译整理
OpenClaw on Android
因为 Android 也值得拥有一个 shell。
无需安装 Linux 环境
在 Android 上运行 OpenClaw 的标准方法通常需要安装 proot-distro 和完整的 Linux 发行版，这会带来 700MB 到 1GB 的额外存储开销。本项目通过仅安装 glibc 动态链接器 (ld.so) 消除了这一负担，让您无需完整的 Linux 发行版即可运行 OpenClaw。
标准方法：在 Termux 中通过 proot-distro 安装完整的 Linux 发行版。
┌───────────────────────────────────────────────────┐
│ Linux Kernel │
│ ┌───────────────────────────────────────────────┐ │
│ │ Android · Bionic libc · Termux │ │
│ ┌───────────────────────────────────────────┐ │ │
│ │ │ proot-distro · Debian/Ubuntu │ │ │
│ │ │ ┌───────────────────────────────────────┐ │ │ │
│ │ │ │ GNU glibc │ │ │ │
│ │ │ │ Node.js → OpenClaw │ │ │ │
│ │ │ └───────────────────────────────────────┘ │ │ │
│ │ └───────────────────────────────────────────┘ │ │
│ └───────────────────────────────────────────────┘ │
└───────────────────────────────────────────────────┘
本项目：无需 proot-distro — 仅使用 glibc 动态链接器。
┌───────────────────────────────────────────────────┐
│ Linux Kernel │
│ ┌───────────────────────────────────────────────┐ │
│ │ Android · Bionic libc · Termux │ │
│ │ ┌───────────────────────────────────────────┐ │ │
│ │ │ glibc ld.so (linker only) │ │ │
│ │ │ ld.so → Node.js → OpenClaw │ │ │
│ │ └───────────────────────────────────────────┘ │ │
│ └───────────────────────────────────────────────┘ │
└───────────────────────────────────────────────────┘
| 特性 | 标准方案 (proot-distro) | 本项目 |
|---|---|---|
| 存储开销 | 1-2GB (Linux + 软件包) | ~200MB |
| 设置时间 | 20-30 分钟 | 3-10 分钟 |
| 性能 | 较慢 (proot 层) | 原生速度 |
| 安装步骤 | 安装发行版、配置 Linux、安装 Node.js、修复路径... | 运行一条命令 |
Claw App
我们也提供了一个独立的 Android 应用程序。它将终端模拟器和基于 WebView 的界面打包成一个单独的 APK，完全无需 Termux。
- 一键式设置：在应用内完成 bootstrap、Node.js 和 OpenClaw 的安装
- 内置控制面板：用于网关控制、运行时信息查看和工具管理
- 独立于 Termux：安装该应用不会影响现有的 Termux +
oa环境
请从 Releases 页面下载 APK。
系统要求
- Android 7.0 或更高版本（推荐 Android 10+）
- 约 1GB 可用存储空间
- Wi-Fi 或移动数据连接
功能说明
安装程序会自动处理 Termux 和标准 Linux 之间的差异。您无需手动进行任何操作，单行安装命令即可处理以下所有配置：
- glibc 环境 — 安装 glibc 动态链接器（通过 pacman 的 glibc-runner），使标准 Linux 二进制文件无需修改即可运行。
- Node.js (glibc) — 下载官方 Linux-arm64 版 Node.js，并使用 ld.so 加载脚本进行封装（无需 patchelf，避免在 Android 上触发段错误）。
- 路径转换 — 自动将标准 Linux 路径（如
/tmp,/bin/sh,/usr/bin/env）转换为 Termux 路径。 - 临时文件夹设置 — 为 Android 配置可访问的临时目录。
- 绕过服务管理器 — 在没有 systemd 的情况下配置正常运行环境。
- OpenCode 集成 — 如果选择，则通过 proot + ld.so 结合的方式为 Bun 独立二进制文件安装 OpenCode。
设置步骤（从新手机开始）
第 1 步：准备您的手机
配置开发者选项、保持唤醒、充电限制和电池优化。请参阅 保持进程存活指南 以获取详细步骤说明。
第 2 步：安装 Termux
重要：Play Store 版本的 Termux 已停止更新，无法正常使用。您必须从 F-Droid 安装。
- 打开手机浏览器，访问 f-droid.org
- 搜索
Termux，点击 Download APK 下载并安装- 系统提示时，允许“安装来自未知来源的应用”
第 3 步：Termux 初始设置
(后续内容参照原文档...)