如何在10分钟内跑通OpenClaw on Android:面向新手的快速开始教程(F-Droid Termux到openclaw gateway)
如何在10分钟内跑通OpenClaw on Android:面向新手的快速开始教程(F-Droid Termux到openclaw gateway)
OpenClaw on Android 让你免 proot、免完整 Linux 发行版,一条命令就能把 OpenClaw AI 智能体平台跑在安卓手机上:从 F-Droid 安装 Termux,到执行 openclaw gateway 启动网关,全程只要 3–10 分钟,占用约 200MB 存储。本教程面向完全的新手,带你一步步从零跑通,并教会你保持后台常驻和用电脑访问 Dashboard 的两个关键技巧。
为什么选择 OpenClaw on Android?
传统方式要在 Termux 里用 proot-distro 装一整套 Debian/Ubuntu,额外吃掉 700MB–1GB 空间、折腾 20–30 分钟,还多一层性能损耗。这个项目只安装 glibc 动态链接器(ld.so),让标准 Linux 二进制直接运行,效果对比一目了然:
| 对比项 | 传统 proot-distro 方案 | OpenClaw on Android |
|---|---|---|
| 额外存储 | 1–2 GB(完整 Linux + 软件包) | 约 200 MB |
| 配置时间 | 20–30 分钟 | 3–10 分钟 |
| 性能 | 较慢(proot 模拟层) | 原生速度 |
| 操作步骤 | 装发行版、配 Linux、装 Node.js、修路径…… | 跑一条命令 |
一条安装命令会自动处理完所有"安卓与 Linux 的差异":glibc 环境、glibc 版 Node.js、路径转换(/tmp、/bin/sh 等)、临时目录、无 systemd 的服务管理器兼容等,全程零手动配置。安装脚本核心逻辑在 bootstrap.sh 与 install.sh 中,想深入了解可以看 README.md。
安装前检查:3 项最低要求 ✅
| 要求 | 说明 |
|---|---|
| 系统版本 | Android 7.0+(推荐 Android 10+) |
| 存储空间 | 约 2 GB(2000 MB),安装前会自动检测 |
| 网络 | Wi-Fi 或移动数据,推荐 Wi-Fi |
另外强烈建议提前按进程保活指南配置好开发者选项、充电时保持唤醒(Stay Awake)、关闭 Termux 的电池优化——这些设置能避免安卓把网关当成后台进程杀掉,是"跑起来"和"一直跑着"的分水岭。
第一步:从 F-Droid 安装 Termux
⚠️ 重要:Google Play 商店里的 Termux 已停止维护,无法正常使用,必须从 F-Droid 安装。
- 用手机浏览器打开 F-Droid 官网
- 搜索
Termux,点击 Download APK 下载并安装 - 系统弹出"允许安装未知来源应用"时,选择允许
安装完成后打开 Termux,你会看到一个黑底绿字的命令行窗口——恭喜,你的手机现在有一台"口袋 Linux"了。
第二步:初始化 Termux 并一键安装 OpenClaw
首次打开 Termux 时,建议先升级系统包并安装 curl(安装脚本的依赖):
pkg upgrade -y && pkg install -y curl
小提示:
- 如果提示选择软件源镜像,选地理距离近的即可
- 升级过程若询问配置文件
(Y/I/N/O/D/Z),直接回车采用默认值 - 不要跳过
pkg upgrade:全新 Termux 直接装 curl 可能出现CANNOT LINK EXECUTABLE "curl"报错,详见故障排查文档
接着,把这条"主角命令"粘贴进 Termux:
curl -sL myopenclawhub.com/install | bash && source ~/.bashrc
耐心等待 3–10 分钟,脚本会自动完成 glibc 环境、Node.js、OpenClaw 本体、兼容补丁(patches/glibc-compat.js 等)的全部安装,并对可选工具(tmux、code-server、Claude Code 等)逐个询问是否安装,按需输入 y/n 即可。完成后终端会显示 OpenClaw 版本号和下一步指引。
💡 嫌手机打字累?可以先按 Termux SSH 指南 让电脑直接"接管"手机终端,之后所有命令都用电脑键盘敲。
第三步:运行 openclaw onboard 完成初始配置
按照安装输出的提示,执行:
openclaw onboard
向导会先展示一段安全须知(OpenClaw 是一个具备文件读写和执行能力的 AI 智能体,请理解其风险),确认继续后按屏幕提示完成模型与网关的初始配置即可。
第四步:启动 openclaw gateway 网关
⚠️ 关键:
openclaw gateway必须直接在 Termux App 里运行,不要通过 SSH 会话运行——SSH 断开会连带停掉网关。
网关会独占当前终端,所以先开一个新标签页:点击 Termux 底部菜单栏的汉堡菜单(☰),或从屏幕左缘(菜单栏上方)向右滑动,选择 NEW SESSION。在新标签页中执行:
openclaw gateway
看到网关持续输出日志即代表运行成功。以后想停止网关时按 Ctrl+C 即可,不要用 Ctrl+Z(那只会挂起进程而不会结束它)。
进阶:从电脑浏览器访问 Dashboard
手机只是"服务器",真正的操作界面在电脑浏览器里。按 Termux SSH 指南 打通链路:
- 在 Termux 执行
pkg install -y openssh并设置密码(passwd) - 新开一个 Termux 标签页运行
sshd启动 SSH 服务 - 用
ifconfig找到wlan0下的inet地址,就是手机 IP:
- 电脑终端连接(注意端口是 8022):
ssh -p 8022 <手机IP>
- 再开一个终端做端口转发,把 Dashboard 映射到本地:
ssh -N -L 18789:127.0.0.1:18789 u0_a321@<手机IP>
浏览器打开 http://localhost:18789/,即可看到 OpenClaw Dashboard。如果提示 token 或 unauthorized,在 Termux 中打印 token 并填入页面认证框即可,具体见故障排查文档。
保持进程常驻:别让 Android 杀掉你的网关
如果看到 [Process completed (signal 9) - press Enter],说明进程被系统强杀了。这是 Android 12+ 的 Phantom Process Killer(PPK) 在捣乱。解决方法(一次性,重启后依然生效):
- 下拉通知栏,在 Termux 通知上点击 Acquire wakelock 获取唤醒锁
- 开启开发者选项中的无线调试(Wireless debugging)
- 在 Termux 中按 PPK 禁用指南 完成
adb pair配对并执行:
adb shell "settings put global settings_enable_monitor_phantom_procs false"
返回 false 即禁用成功,openclaw gateway、sshd 等后台进程再也不会无故消失:
另外建议把充电上限设为 80%(设置 → 电池保护),7×24 插电挂机更保护电池,详细步骤见保活指南。
常用管理命令速查(oa CLI)
安装完成后,oa 命令是你日常的管理入口(定义于 oa.sh):
| 命令 | 作用 |
|---|---|
oa --status |
查看安装状态与所有组件(含 hard-link 补丁状态) |
oa --update && source ~/.bashrc |
一键更新 OpenClaw、code-server、AI CLI 工具等全部组件 |
oa --install |
补装可选工具(tmux、code-server、Claude Code 等) |
oa --backup / oa --restore |
完整备份 / 从备份恢复 ~/.openclaw 数据 |
oa --uninstall |
干净卸载 OpenClaw on Android |
oa --version |
查看当前版本 |
关于更新有两点值得记住:
- 只允许用
oa --update升级——openclaw update被刻意锁定,因为项目要把 OpenClaw 固定在经过验证的版本 - 当更新改变了固定版本时,
oa --update会先检查 2000 MB 空间、要求网关停止,并自动在~/.openclaw-android/backup/pre-update/做一次数据备份,安全得很
新手常见问题速答
| 现象 | 大概率原因与解法 |
|---|---|
CANNOT LINK EXECUTABLE "curl" |
全新 Termux 没先 pkg upgrade,参考故障排查 |
| 网关运行几小时后消失 | 未禁用 Phantom Process Killer / 未关电池优化,见上文保活章节 |
| Dashboard 要求 token | 属正常鉴权,打印 token 填入即可,token 务必保密 |
| CLI 命令比电脑慢 | 手机存储读取慢,属正常现象;网关跑起来后 AI 响应速度与电脑无异 |
| 想多设备统一管理 | 用 Dashboard Connect 工具在电脑端保存各设备的 IP/token/端口 |
遇到问题时,docs/troubleshooting.md 覆盖了绝大多数场景;想折腾本地 LLM、浏览器自动化(Chromium/Playwright)等高级玩法,可继续翻 README.md 的开发者章节。
总结回顾:F-Droid 装 Termux → pkg upgrade → 一条 curl 命令安装 → openclaw onboard → 新标签页 openclaw gateway → SSH 隧道访问 Dashboard。整个流程 10 分钟内完成,你的手机就变成了一台随时在线的 AI 智能体服务器 🐾



