原帖发布于
【亲测有效!手把手教你在 Android 手机上运行 OpenClaw 🦞】
被网上错误的文章误导,经过几个小时的折腾,OpenClaw 终于成功运行在我的 Pixel 6 Pro (Android 16)上了🎉🎉🎉,所以本篇文章就是为了给大家一个正确的教程,跟着做绝对能成功跑起来!
前言
原文地址:https://github.com/AbuZar-Ansarii/Clawbot
所有在 Android 上运行 OpenClaw 的教程都是基于 Termux ,但这是唯一一篇最终让我成功运行的,我看了 N 篇不靠谱的文章后,这篇教程最关键的差别在于安装 proot-distro,这个插件让我们得以在 Termux 内安装完整的 Linux 发行版,这是在 Android 里运行真实 Linux 环境的关键步骤。
为了成功构建,你需要一台至少能运行 Android 10.0 以上系统版本的手机
本文由 兔子API 友情赞助,兔子 API 有全品类的各种大模型接入,价格非常友好,大家可以用我的链接注册 https://api.tu-zi.com/register?aff=Itmf
安装步骤
1. 安装 Termux
1. 打开 F-Droid.org
1. 下载并安装 F-Droid
1. 在 F-Droid 中搜索 Termux
1. 安装 Termux
1. 打开 Termux
我的手机是 Pixel 6 Pro,可以直接在Google Play Store 里搜索 termux 并安装。目前用下来没发现问题。
2. 更新 Termux 包
所有的命令都是在 Termux 这个应用中输入的,后面不再赘述
pkg update && pkg upgrade -y
作用说明:
• pkg update:刷新 Termux 的软件包索引(类似 apt update)。
• pkg upgrade -y:自动升级所有已安装软件到最新版本。
用于确保系统环境是最新的。
3. 安装 proot-distro
这是在 Android 里运行真实 Linux 环境的关键步骤。
pkg install proot-distro
作用说明:
• 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 的软件源并升级系统。
确保 Ubuntu 内的软件和安全补丁是最新。
7. 安装 curl
apt install -y curl
作用说明:
• curl 是一个命令行下载工具,用于从网络下载脚本或文件。
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
作用说明:
在 Ubuntu 里安装 Node.js 运行时,用来运行 OpenClaw 主程序。
Node.js 是 JavaScript 的服务器端引擎。
10. 检查版本
node -v
npm -v
作用说明:
检查 Node.js 与 npm 是否成功安装,版本是否可用(常见测试步骤)。
11. 安装 git
apt install -y git
作用说明:
安装 git,用于后续可能拉取插件仓库、更新脚本等。
12. 安装 OpenClaw
npm install -g openclaw@latest
作用说明:
从 npm 安装 OpenClaw 框架全局运行版(类似 npm install -g clawdbot)。
这一步是将核心智能代理程序装到 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 可能找不到本地网络地址。
它通过 Node 扩展参数 加载修补逻辑。
14. 运行 OpenClaw 安装向导
openclaw onboard
作用说明:
运行安装 “向导”(wizard)。
这个交互式命令会引导你完成 OpenClaw 的初始设置:
✔ Gateway 绑定地址
✔ API key 配置
✔ 端口、权限、默认设置等
向导可以自动生成配置文件。
15. 启动代理核心服务
openclaw gateway --verbose
作用说明:
这个命令启动 OpenClaw 的后端服务守护进程(gateway 模块),它会监听本地请求(例如仪表盘、消息客户端通知、技能管理等)。
--verbose 表示显示详细输出,用于调试。
这个命令成功启动后,就代表你的 openclaw 已经成功运行起来了
结语
在手机上运行 OpenClaw 并不是炫技,也并非多此一举,的确有一些插件无法在手机端使用,但运行在手机里的小龙虾依然可以作为一个贴心的,功能强大的 AI 助理,帮我们完成很多工作,比如自动发布公众号,我已经测试跑通了,非常之爽。
不要再推高 Mac Mini 的销量了,谁还没有一台闲置的 Android 手机呢🤣