对于希望在家中部署轻量级服务器的用户而言,闲置的安卓手机往往是一个被忽视的选择。OpenClaw on Android 项目提供了一种创新的解决方案,让用户能够直接在 Termux 环境中运行 OpenClaw,无需安装 proot-distro 或配置完整的 Linux 系统,即可将旧手机转变为低功耗、全天候运行的服务器节点。
相比传统方案需要在 Ubuntu 容器中额外占用 700MB 至 1GB 存储空间,该项目通过直接修补兼容性问题,实现了纯 Termux 环境下的原生运行,存储开销仅约 50MB,且性能更接近原生速度。
核心优势与适用场景
将安卓手机用作 OpenClaw 服务器载体具有多重独特优势:
硬件利用 —— 即使是数年前的旧机型,其性能也足以流畅运行 OpenClaw,让抽屉中的闲置设备重获价值,无需额外购置迷你主机。
能效与稳定性 —— 手机 7×24 小时运行的功耗远低于传统 PC,且内置电池天然构成不间断电源(UPS),可在断电时维持系统运行。
数据安全 —— 建议在恢复出厂设置、未登录任何个人账户的手机上安装,设备中不存储任何个人敏感数据,实现物理隔离。
方案对比 —— 传统 proot-distro 方案需要 1 至 2GB 存储空间,安装耗时 20 至 30 分钟,且存在性能损耗;而本项目仅需约 50MB 空间,3 至 10 分钟即可完成部署,运行速度为原生级别。
系统要求与前期准备
- Android 7.0 或更高版本(推荐 Android 10+)
- 约 500MB 可用存储空间
- Wi-Fi 或移动数据网络连接
开发者选项配置 —— 由于 OpenClaw 以服务器模式运行,屏幕关闭可能导致系统限制或终止后台进程。需前往「设置 > 关于手机」连续点击「版本号」7 次以启用开发者模式,然后在「开发者选项」中开启「保持唤醒状态」,确保充电时屏幕常亮。
电池保护设置 —— 长期保持 100% 电量可能导致电池鼓包。建议将充电上限限制在 80%:三星设备路径为「设置 > 电池 > 电池保护 > 最大 80%」,Google Pixel 为「设置 > 电池 > 电池保护 > 开启」。如设备不支持此功能,建议使用智能插座手动管理充电。
安装与部署流程
安装 Termux —— 务必从 F-Droid 下载安装 Termux,Google Play 版本已停止维护无法使用。安装后需允许「安装未知来源应用」权限。
初始环境配置 —— 首次启动 Termux 后,执行以下命令更新软件源、安装 curl 并启用后台防杀:
pkg update -y && pkg upgrade -y && pkg install -y curl && termux-wake-lock
执行 termux-wake-lock 后,状态栏将显示常驻通知,防止 Android 系统终止 Termux 进程。此外,需前往「设置 > 电池 > 电池优化」,将 Termux 设置为「不优化」或「无限制」模式。
一键安装 OpenClaw —— 在 Termux 中粘贴执行以下命令:
curl -sL https://raw.githubusercontent.com/AidanPark/openclaw-android/main/bootstrap.sh | bash && source ~/.bashrc
该命令将自动完成所有依赖安装与环境配置,耗时约 3 至 10 分钟,建议使用 Wi-Fi 网络。安装完成后,系统将显示 OpenClaw 版本信息,并提示执行初始化命令。
初始化与启动 —— 依次执行以下命令:
openclaw onboard —— 按照屏幕提示完成初始配置。
openclaw gateway —— 启动网关服务。注意:必须在手机本地的 Termux 应用中直接运行此命令,而非通过 SSH 远程执行,否则 SSH 断开后网关将停止。
远程管理与多设备控制
PC 端访问仪表盘 —— 首先需在 Termux 中配置 SSH 服务。执行 pkg install -y openssh && passwd && sshd 设置密码并启动 SSH 服务,然后在 PC 端使用 ssh -p 8022 <手机IP> 连接。
在 Termux 中执行 ifconfig 查看 wlan0 下的 inet 地址(如 192.168.0.100),然后在 PC 端新建终端建立 SSH 隧道:
ssh -N -L 18789:127.0.0.1:18789 -p 8022 <手机IP>
最后在 PC 浏览器中访问 http://localhost:18789/ 即可管理 OpenClaw。也可在手机端执行 openclaw dashboard 获取包含完整 token 的访问地址。
多设备统一管理 —— 当在同一网络中运行多台 OpenClaw 设备时,可使用 Dashboard Connect 工具集中管理。该工具支持保存各设备的连接信息(IP、token、端口)、自动生成 SSH 隧道命令与仪表盘链接,且所有数据仅存储在浏览器本地,不会上传至任何服务器。
维护与故障排除
更新 —— 如需应用最新补丁与环境更新,执行:
curl -sL https://raw.githubusercontent.com/AidanPark/openclaw-android/main/update.sh | bash && source ~/.bashrc
该轻量级更新脚本可安全多次执行,仅刷新环境变量与补丁,无需重装全部组件。
卸载 —— 执行 bash ~/.openclaw-android/uninstall.sh 可移除 OpenClaw 软件包、补丁、环境变量及临时文件。用户数据目录 ~/.openclaw 可选择性保留。
性能说明 —— openclaw status 等 CLI 命令在手机上运行可能比 PC 略慢,原因在于手机存储读取速度较慢且 Android 安全机制增加了处理开销。但网关启动并常驻内存后,性能与 PC 无异,AI 响应均由外部服务器处理,速度保持一致。
技术原理
安装程序通过自动修补解决 Termux 与标准 Linux 环境的差异,单条命令即可完成以下 5 项核心适配:
- 平台识别 —— 配置 Android 被识别为 Linux 系统
- 网络错误规避 —— 自动处理 Android 特有的网络相关崩溃
- 路径转换 —— 将标准 Linux 路径自动转换为 Termux 路径
- 临时目录配置 —— 为 Android 设置可访问的临时文件夹
- 服务管理器绕过 —— 无需 systemd 即可正常运行
项目采用 MIT 许可证开源,源码托管于 GitHub,用户可自由查看、修改与分发。
