Android 上的 OpenClaw

한국어 | 中文

因为 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 之间的差异。你无需手动操作，单条安装命令即可处理以下事项：

1. glibc 环境 — 安装 glibc 动态链接器（通过 pacman 的 glibc-runner），使标准 Linux 二进制文件无需修改即可运行
2. Node.js (glibc) — 下载官方 Node.js linux-arm64 版本，并使用 ld.so 加载脚本进行封装（无需使用会在 Android 上导致段错误的 patchelf）
3. 路径转换 — 自动将标准 Linux 路径（/tmp, /bin/sh, /usr/bin/env）转换为 Termux 路径
4. 临时文件夹设置 — 为 Android 配置可访问的临时文件夹
5. 绕过服务管理器 — 在没有 systemd 的情况下配置正常运行
6. OpenCode 集成 — 如果选择安装，将通过 proot + ld.so 组合安装 OpenCode，支持 Bun 独立二进制文件

分步设置指南（从新手机开始）

1. 准备您的手机
2. 安装 Termux
3. 初始化 Termux 设置
4. 安装 OpenClaw — 只需一条命令
5. 启动 OpenClaw 设置
6. 启动 OpenClaw (网关)

第 1 步：准备您的手机

配置开发者选项、保持唤醒、充电限制和电池优化。请参阅 保持进程活跃指南 以获取详细的操作说明。

第 2 步：安装 Termux

重要：Play Store 版本的 Termux 已停止维护且无法工作。您必须从 F-Droid 安装。

1. 打开手机浏览器并访问 f-droid.org
2. 搜索 Termux，点击 Download APK 下载并安装
   • 提示时允许“从未知来源安装”

第 3 步：初始化 Termux 设置

...