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

移动开发AI 应用CLI开发工具【免费下载链接】openclaw-androidRun OpenClaw on Android with a single command — no proot, no Linux项目地址https://gitcode.com/gh_mirrors/op/openclaw-android点击查看免费下载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 GB2000 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报错详见故障排查文档接着把这条主角命令粘贴进 Termuxcurl -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看到网关持续输出日志即代表运行成功。以后想停止网关时按CtrlC即可不要用CtrlZ那只会挂起进程而不会结束它。进阶从电脑浏览器访问 Dashboard手机只是服务器真正的操作界面在电脑浏览器里。按 Termux SSH 指南 打通链路在 Termux 执行pkg install -y openssh并设置密码passwd新开一个 Termux 标签页运行sshd启动 SSH 服务用ifconfig找到wlan0下的inet地址就是手机 IP电脑终端连接注意端口是 8022ssh -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 KillerPPK在捣乱。解决方法一次性重启后依然生效下拉通知栏在 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 Androidoa --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 智能体服务器 赞分享移动开发AI 应用CLI开发工具【免费下载链接】openclaw-androidRun OpenClaw on Android with a single command — no proot, no Linux项目地址https://gitcode.com/gh_mirrors/op/openclaw-android点击查看免费下载相关推荐如何在5分钟内快速开始使用Orchest新手教程如何在5分钟内快速开始使用Orchest新手教程 想要快速构建数据科学管道但不想学习复杂框架Orchest正是你需要的工具这款基于Kubernetes的C如何在10分钟内开始使用XMPPFramework快速入门教程如何在10分钟内开始使用XMPPFramework快速入门教程 想要为你的iOS或macOS应用添加即时通讯功能吗XMPPFramework是Objecti即时通讯如何在 10 分钟内开始使用 Tree-sitter快速入门教程如何在 10 分钟内开始使用 Tree sitter快速入门教程 Tree sitter 是一个强大的增量解析系统专为编程工具设计。它能够为源代码文件构建具开发工具创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考