如何在10分钟内跑通OpenClaw on Android:面向新手的快速开始教程(F-Droid Termux到openclaw gateway)

原创2026-10-10 14:00:571,994 阅读
文章标签:移动开发终端模拟器AI Agent

如何在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 安装。

  1. 用手机浏览器打开 F-Droid 官网
  2. 搜索 Termux,点击 Download APK 下载并安装
  3. 系统弹出"允许安装未知来源应用"时,选择允许

安装完成后打开 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 on Android 新手引导界面,openclaw onboard 安全确认提示

向导会先展示一段安全须知(OpenClaw 是一个具备文件读写和执行能力的 AI 智能体,请理解其风险),确认继续后按屏幕提示完成模型与网关的初始配置即可。

第四步:启动 openclaw gateway 网关

⚠️ 关键:openclaw gateway 必须直接在 Termux App 里运行,不要通过 SSH 会话运行——SSH 断开会连带停掉网关。

网关会独占当前终端,所以先开一个新标签页:点击 Termux 底部菜单栏的汉堡菜单(☰),或从屏幕左缘(菜单栏上方)向右滑动,选择 NEW SESSION。在新标签页中执行:

openclaw gateway

看到网关持续输出日志即代表运行成功。以后想停止网关时按 Ctrl+C 即可,不要用 Ctrl+Z(那只会挂起进程而不会结束它)。

进阶:从电脑浏览器访问 Dashboard

手机只是"服务器",真正的操作界面在电脑浏览器里。按 Termux SSH 指南 打通链路:

  1. 在 Termux 执行 pkg install -y openssh 并设置密码(passwd)
  2. 新开一个 Termux 标签页运行 sshd 启动 SSH 服务
  3. 用 ifconfig 找到 wlan0 下的 inet 地址,就是手机 IP:

Termux 中运行 ifconfig 查看 wlan0 的 inet 手机 IP 地址

  1. 电脑终端连接(注意端口是 8022):
ssh -p 8022 <手机IP>
  1. 再开一个终端做端口转发,把 Dashboard 映射到本地:
ssh -N -L 18789:127.0.0.1:18789 u0_a321@<手机IP>

浏览器打开 http://localhost:18789/,即可看到 OpenClaw Dashboard。如果提示 token 或 unauthorized,在 Termux 中打印 token 并填入页面认证框即可,具体见故障排查文档。

通过 SSH 隧道访问 OpenClaw on Android 的 openclaw dashboard 网关控制面板

保持进程常驻:别让 Android 杀掉你的网关

如果看到 [Process completed (signal 9) - press Enter],说明进程被系统强杀了。这是 Android 12+ 的 Phantom Process Killer(PPK) 在捣乱。解决方法(一次性,重启后依然生效):

  1. 下拉通知栏,在 Termux 通知上点击 Acquire wakelock 获取唤醒锁
  2. 开启开发者选项中的无线调试(Wireless debugging)
  3. 在 Termux 中按 PPK 禁用指南 完成 adb pair 配对并执行:
adb shell "settings put global settings_enable_monitor_phantom_procs false"

返回 false 即禁用成功,openclaw gateway、sshd 等后台进程再也不会无故消失:

adb 成功禁用 Phantom Process Killer 关闭信号9杀进程

另外建议把充电上限设为 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 智能体服务器 🐾

登录后查看全文
openclaw-android