在安卓手机上搭建 OpenClaw - 完整教程
在安卓手机上搭建 OpenClaw
> 家里的旧手机，放着也是放着，既然现在 OpenClaw 这么火，就把旧手机利用起来呗，搭建一个在线的手机版 OpenClaw。
一、前置准备
1. 核心容器：Termux
是什么： Android 上最强大的终端模拟器，它无需 Root 就能让你拥有一个迷年的 Linux 环境。
在本教程中的作用： 它是所有程序的"地基"。我们的 Ubuntu 系统、OpenClaw 项目都将运行在 Termux 之上。
2. 灵魂桥梁：Termux:API
是什么： 这是一套"软硬结合"的组件。
- 手机上的 App： 负责像普通应用一样，向安卓系统申请"拍照"、"发短信"、"读取位置"的权限
- 终端里的 Package： 负责在代码层面发送指令
为什么必须装： 为了能让 OpenClaw 调用手机硬件。普通的 Linux 程序是无法直接调用安卓摄像头的，Termux:API 就是这个桥梁。
流程： OpenClaw (代码) → Termux 终端命令 → Termux:API (App) → 安卓系统 → 摄像头
3. 兼容性救星：Ubuntu (proot-distro)
是什么： 通过 proot 技术在 Termux 内部运行的一个完整的 Ubuntu 22.04/24.04 操作系统。
为什么不用原生 Termux 跑？ 原生 Termux 是安卓环境（Bionic Libc），很多 AI 依赖库（如 PyTorch, Numpy, 甚至 bun）无法直接安装或报错。
> ⚠️ 重要：SystemError 13 问题
>
> 由于 Android 10/11 之后的隐私保护机制，在安装好 OpenClaw 后可能会遇到 SystemError 13 错误。这是因为：
>
> Node.js 启动时习惯性地调用底层的 uv_interface_addresses 函数，试图读取 /proc/net/ 目录下的文件。为了防止流氓 APP 通过读取唯一的 MAC 地址来追踪用户，在 Android 10+ 的内核中彻底封锁了普通应用读取这些底层网络信息的权限。
>
> 解决方
---
二、Termux 和 Ubuntu 的安装
1. 安装 Termux
GitHub 官方下载地址：https://github.com/termux/termux-app/releases/tag/v0.118.3
根据手机 CPU 型号选择对应版本，例如：
- 红米 Turbo 5 Max：termux-app_v0.118.3+github-debug_arm64-v8a.apk
> 📌 注意： 网传千万不要从 Google Play 上进行安装，说是早已不在 Google Play 上更新
安装完成后，请给予 Termux "后台弹出界面"、"自启动" 和 "无限制省电策略" 权限。
2. 安装 Termux:API
GitHub 官方下载地址：https://github.com/termux/termux-api/releases/tag/v0.53.0
下载：termux-api-app_v0.53.0+github.debug.apk
核心配置：手动授予权限
操作 应用设置 → 应用路径：设置 →管理 → 搜索 API → 找到 Termux:API
权限全开：把相机、麦克风、位置信息、存储等所有你希望 OpenClaw 能调用的权限，全部改为"始终允许"或"仅在使用中允许"。
3. 更新系统并安装核心组件
<h2 class="wp-block-heading">更新所有软件包</h2>
pkg update -y && pkg upgrade -y
<h2 class="wp-block-heading">安装 Ubuntu 管理器、API 桥接工具和常用工具</h2>
pkg install proot-distro termux-api -y
- proot-distro: 我们在安卓上跑 Ubuntu 的神器
- termux-api: 命令行端的接口，配合手机上装的 APP 使用（软硬件连接）
4. 安装 Ubuntu
步骤 3.1：一键安装 Ubuntu
proot-distro install ubuntu
系统会自动下载 Ubuntu 的文件系统（Rootfs），解压并配置。这个过程取决于网速，通常 1-3 分钟即可完成。
步骤 3.2：登录 Ubuntu
proot-distro login ubuntu
观察提示符变化：
- 登录前（Termux）：~ $
- 登录后（Ubuntu）：root@localhost:~#
只要看到 root@localhost，恭喜你，你已经处于 Ubuntu 系统内部了！
---
三、Ubuntu 内部环境配置
步骤 4.1：更新 Ubuntu 的软件源
apt update && apt upgrade -y
步骤 4.2：安装 Node.js 和基础工具
<h2 class="wp-block-heading">安装 Node.js, npm, git, 以及编译需要的工具链</h2>
apt install curl git build-essential python3 -y
<h2 class="wp-block-heading">添加 Node.js 源（Ubuntu 自带的通常是比较旧的版本）</h2>
curl -fsSL https://deb.nodesource.com/setup_24.x | bash -
<h2 class="wp-block-heading">正式安装 Node.js</h2>
apt install nodejs -y
步骤 4.3：验证安装
node -v
npm -v
如果输出了版本号（例如 v24.x.x 或更高），说明环境准备就绪。
进阶小技巧：设置快捷指令
每次打开 Termux 都要输入 proot-distro login ubuntu 太麻烦了。设置一个快捷指令：
<h2 class="wp-block-heading">退出到 Termux 原生界面</h2>
exit
<h2 class="wp-block-heading">创建快捷方式</h2>
echo "alias u='proot-distro login ubuntu'" >> ~/.bashrc
source ~/.bashrc
现在只需要输入 u 就能瞬间穿越到 Ubuntu 系统了！
---
四、安装 OpenClaw 小龙虾
npm install -g openclaw@2026.02.19
> ⚠️ 安装完成不要运行 openclaw onboard！因为配置到最后会遇到 SystemError 13 权限问题。
---
五、解决 SystemError 13 问题
这是整个教程最核心的地方。由于 Android 10+ 禁止普通应用读取 /proc/net（网络接口信息），OpenClaw 启动时会直接报错崩溃。我们需要创建一个"假的"接口信息来骗过它。
步骤 5.1：创建补丁文件
<h2 class="wp-block-heading">创建配置目录</h2>
mkdir -p /root/.openclaw
<h2 class="wp-block-heading">创建并编辑补丁文件</h2>
nano /root/.openclaw/bionic-bypass.js
步骤 5.2：写入补丁代码
在 nano 编辑器中，完整复制以下代码并粘贴进去：
const os = require('os');
const originalNetworkInterfaces = os.networkInterfaces;
os.networkInterfaces = function() {
try {
const interfaces = originalNetworkInterfaces.call(os);
if (interfaces && Object.keys(interfaces).length > 0) {
return interfaces;
}
} catch (e) {}
return {
lo: [{
address: '127.0.0.1',
netmask: '255.0.0.0',
family: 'IPv4',
mac: '00:00:00:00:00:00',
internal: true,
cidr: '127.0.0.1/8'
}]
};
};
保存：Ctrl+O → 回车 → Ctrl+X
步骤 5.3：配置环境变量（让补丁永久生效）
<h2 class="wp-block-heading">将环境变量写入 .bashrc</h2>
echo 'export NODE_OPTIONS="--require /root/.openclaw/bionic-bypass.js"' >> ~/.bashrc
<h2 class="wp-block-heading">让配置立即生效</h2>
source ~/.bashrc
---
六、启动 OpenClaw
<h2 class="wp-block-heading">启动 openclaw 配置</h2>
openclaw onboard
配置完成之后，如果卡在 completed 界面，按 Ctrl+C，然后输入：
openclaw gateway --verbose
配对聊天软件
设置好聊天软件的 BOT 后，只要配对就行了。
Termux 多开技巧：
- 按 Ctrl+B 再按 "
- 下面会多出一个窗口
- 打开的新窗口需要输入前面设置好的 u 进入 Ubuntu 系统
- 输入配对指令，如 openclaw pairing telegram XXXX
完成配对后就可以愉快的对话啦！
---
七、常见问题
模型用什么？
推荐 GLM、Minimax 的 coding plan，量大管饱。
有没有白嫖的模型？
有的！GitHub Copilot 免费体验 Pro 版 1 个月，可以体验最新模型，包括 Claude Opus 4.6、GPT 5.2、Gemini 3 Pro。
> 不知道是不是 BUG，1月20日免费体验1个月，到1月底的时候基本就用完了（量一般），但是2月1日重置了使用量，所以约等于是可以白嫖2个月。
手机问题
只要是能跑安卓系统的都行（Android 11 以上）
安装的时候遇到问题怎么办？
复制 → 粘贴 → 问 AI
Termux 耗电量
Termux 耗电量不大，基本排名靠后。
---
八、进阶玩法
既然是 Ubuntu 系统了，当然还能装 OpenCode、Claude Code 之类的编程 CLI 了。同时 OpenClaw 里有个 Skill 叫 coding-agent，就是专门调用这几个编程 CLI 的。
npm i -g opencode-ai@latest
能调用摄像头、电话就很有搞头了，很多时候都可以充当家里摄像头了！
---
参考文章： https://www.cnbugs.com/
