字节笔记本
2026年2月20日
在 Android 手机上运行 OpenClaw 完全指南
本文是一篇详细的教程,介绍如何在 Android 手机上通过 Termux 和 proot-distro 安装运行 OpenClaw,让你无需 Mac Mini 也能拥有一个功能强大的 AI 助理。
前言
OpenClaw 是一个开源的 AI 智能代理框架,通常需要在服务器或电脑上运行。但通过 Termux 和 proot-distro,我们可以在 Android 手机上安装完整的 Linux 环境,从而运行 OpenClaw。
关键要点:所有在 Android 上运行 OpenClaw 的教程都基于 Termux,但成功的关键在于安装 proot-distro 这个插件,它让我们得以在 Termux 内安装完整的 Linux 发行版。
要求:Android 10.0 以上系统版本的手机
安装步骤
1. 安装 Termux
- 打开 F-Droid.org 下载并安装 F-Droid
- 在 F-Droid 中搜索 Termux 并安装
- 或者直接在 Google Play Store 搜索 Termux 安装(Pixel 6 Pro 测试通过)
2. 更新 Termux 包
pkg update && pkg upgrade -y作用说明:
pkg update:刷新 Termux 的软件包索引pkg upgrade -y:自动升级所有已安装软件到最新版本
3. 安装 proot-distro
pkg install proot-distro这是在 Android 里运行真实 Linux 环境的关键步骤。proot-distro 允许在 Termux 内安装完整的 Linux 发行版,不需要 root 权限。
4. 安装 Ubuntu
proot-distro install ubuntu这个命令会在 Termux 里安装 Ubuntu(真实的 Linux 发行版),OpenClaw 环境就能在 Ubuntu 下运行。
5. 登录 Ubuntu 环境
proot-distro login ubuntu进入刚才安装的 Ubuntu 系统,然后就可以像正常 Ubuntu 一样执行命令。
6. Ubuntu 系统更新
apt update && apt upgrade -y刷新 Ubuntu 的软件源并升级系统,确保软件和安全补丁是最新的。
7. 安装 curl
apt install -y curlcurl 是一个命令行下载工具,用于从网络下载脚本或文件。OpenClaw 安装脚本需要用它来获取 Node.js 设置脚本。
8. 添加 Node.js 官方软件源
curl -fsSL https://deb.nodesource.com/setup_22.x | bash -这个命令从 NodeSource 下载脚本并执行,让 Ubuntu 能安装 Node.js 22。Ubuntu 默认仓库里可能没有最新版本。
9. 安装 Node.js
apt install -y nodejs安装 Node.js 运行时,用来运行 OpenClaw 主程序。
10. 检查版本
node -v
npm -v检查 Node.js 与 npm 是否成功安装,版本是否可用。
11. 安装 git
apt install -y git安装 git,用于后续可能拉取插件仓库、更新脚本等。
12. 安装 OpenClaw
npm install -g openclaw@latest从 npm 安装 OpenClaw 框架全局运行版,将核心智能代理程序装到 Android Linux 环境中。
13. 网络接口修复脚本
cat <<EOF > /root/hijack.js
const os = require('os');
os.networkInterfaces = () => ({});
EOF
echo 'export NODE_OPTIONS="-r /root/hijack.js"' >> ~/.bashrc
source ~/.bashrc作用说明:Android Termux 里的网络接口行为与标准 Linux 不一样,这个脚本让 Node.js 绕过检测网络接口的逻辑错误,否则 OpenClaw 可能找不到本地网络地址。
14. 运行 OpenClaw 安装向导
openclaw onboard这个交互式命令会引导你完成 OpenClaw 的初始设置:
- Gateway 绑定地址
- API key 配置
- 端口、权限、默认设置等
向导可以自动生成配置文件。
15. 启动代理核心服务
openclaw gateway --verbose这个命令启动 OpenClaw 的后端服务守护进程(gateway 模块),它会监听本地请求(例如仪表盘、消息客户端通知、技能管理等)。
--verbose 表示显示详细输出,用于调试。这个命令成功启动后,就代表 OpenClaw 已经成功运行起来了。
结语
在手机上运行 OpenClaw 并不是炫技,也并非多此一举。虽然有一些插件无法在手机端使用,但运行在手机里的 OpenClaw 依然可以作为一个贴心的、功能强大的 AI 助理,帮我们完成很多工作,比如自动发布公众号。
不要再推高 Mac Mini 的销量了,谁还没有一台闲置的 Android 手机呢?