OpenClaw on Android

安卓手机不仅仅是通讯工具，它们也是被低估的高性能计算节点。与其让抽屉里的旧手机落灰，或者购买昂贵的迷你主机，不如将其转化为一台 7x24 小时运行的 OpenClaw 服务器。

传统方案通常需要在安卓上通过 proot-distro 安装完整的 Ubuntu 系统，这不仅带来了 700MB 到 1GB 的存储开销，还因模拟层导致性能损耗。OpenClaw on Android 项目打破了这一限制：它通过直接修补兼容性差异，让你能在纯 Termux 环境中原生运行 OpenClaw。

无需 proot，无需 Ubuntu，只需一条命令。

为什么选择安卓作为 OpenClaw 宿主？

• 性能过剩： 即使是几年前的中端机型，其 CPU 和内存也完全足以胜任 OpenClaw 网关任务。
• 极致能效： 手机架构专为低功耗设计，配合内置电池，天然具备 UPS（不间断电源）功能，断电也能持续运行。
• 数据隔离与安全： 使用一台恢复出厂设置、未登录任何个人账号的旧手机作为专用服务器，从物理层面杜绝了个人数据泄露风险。
• 轻量级部署： 相比传统方案，本项目仅需约 50MB 空间，启动速度更快，无模拟层性能损耗。

方案对比

前置要求

• 设备： Android 7.0 或更高版本（推荐 Android 10+），闲置旧手机最佳。
• 存储： 至少 500MB 可用空间。
• 网络： 稳定的 Wi-Fi 或移动数据连接。

从零开始：分步部署指南

本指南假设你从一部全新的（或已重置的）手机开始操作。

第一步：硬件与系统准备

作为服务器运行，稳定性至关重要。安卓系统默认会在息屏后杀后台或降频，我们需要规避这些机制。

1. 启用开发者选项

• 进入 设置 > 关于手机。
• 连续点击 版本号 7 次，直到提示“开发者模式已启用”。
• 注：部分机型需在 软件信息 子菜单中寻找版本号。

2. 充电时保持唤醒

• 进入 设置 > 开发者选项。
• 开启 充电时保持屏幕唤醒。
• 作用： 只要连接电源，屏幕将常亮，防止系统进入深度睡眠杀死进程。

3. 设置充电保护（关键）

24 小时满电充电会导致电池鼓包甚至安全隐患。务必限制充电上限。

• 三星： 设置 > 电池 > 电池保护 > 选择 最大 80%。
• Pixel/其他： 寻找 电池保护、优化充电 或类似选项并开启。
• 若无此功能，建议配合智能插座定时断电，或定期人工干预。

第二步：安装 Termux

⚠️ 重要警告： Google Play 商店中的 Termux 版本已停止维护，无法使用。
必须从 F-Droid 下载：

1. 访问 f-droid.org 搜索 Termux。
2. 下载并安装 APK（需允许“安装未知来源应用”）。

第三步：Termux 初始化与保活

打开 Termux，依次执行以下操作：

1. 更新源并安装基础工具：

   pkg update -y && pkg upgrade -y && pkg install -y curl
   

   若提示选择镜像源，任选一个即可（推荐地理位置近的）。

2. 获取唤醒锁（防止后台被杀）：

   termux-wake-lock
   

   执行后，通知栏会出现常驻通知，这是正常的，它告诉系统不要杀掉 Termux。

3. 关闭电池优化：
   • 进入安卓 设置 > 电池 > 电池优化（或 应用启动管理）。
   • 找到 Termux，设置为 不优化 或 允许后台活动。

第四步：一键安装 OpenClaw

为了方便输入，建议先配置 SSH（可选但推荐）：

pkg install -y openssh && passwd && sshd
# 记录显示的端口（通常8022）和密码，之后可从电脑 ssh -p 8022 <手机IP> 连接

核心安装命令：
在 Termux 中粘贴并运行：

curl -sL https://raw.githubusercontent.com/AidanPark/openclaw-android/main/bootstrap.sh | bash && source ~/.bashrc

脚本将自动完成：

• 平台识别配置（让安卓被识别为 Linux）。
• 网络错误预防补丁。
• 路径自动转换（Linux 路径 ↔ Termux 路径）。
• 临时目录与服务管理器绕过配置。

过程约需 3-10 分钟，完成后终端会显示 OpenClaw 版本及后续指引。

第五步：初始化与启动

1. 初始设置：
   运行向导完成配置：

   openclaw onboard
   

2. 启动网关（重要）：
   ⚠️ 注意： 请直接在手机 Termux 应用界面运行此命令，不要通过 SSH 运行。SSH 会话断开会导致网关停止。

   openclaw gateway
   

   停止服务请按 Ctrl + C，勿用 Ctrl + Z（那是挂起）。

第六步：从电脑访问仪表盘

要在电脑浏览器管理 OpenClaw，需建立 SSH 隧道：

1. 获取手机 IP：
   在 Termux 输入 ifconfig，找到 wlan0 下的 inet 地址（如 192.168.1.5）。
2. 建立隧道（在电脑终端执行）：

   ssh -N -L 18789:127.0.0.1:18789 -p 8022 <手机IP地址>
   

   输入之前在 Termux 设置的密码。

3. 访问：
   打开电脑浏览器，访问 http://localhost:18789/。
   如需带令牌的完整链接，可在手机端运行 openclaw dashboard 查看。

进阶功能与管理

多设备管理

如果你有多台旧手机运行 OpenClaw，可以使用项目提供的仪表盘连接工具（基于浏览器本地存储）：

• 保存多台设备的 IP、令牌和端口。
• 一键生成 SSH 隧道命令。
• 隐私安全： 所有连接信息仅存于你的浏览器本地，绝不上传服务器。

额外福利：原生 AI 命令行工具

由于本项目修复了 Termux 的构建环境，你现在可以直接在安卓上安装并运行主流 AI CLI 工具，无需额外配置：

请先安装 OpenClaw 以应用必要的补丁，然后再安装上述工具。

🔄 更新与卸载

更新环境：

curl -sL https://raw.githubusercontent.com/AidanPark/openclaw-android/main/update.sh | bash && source ~/.bashrc

安全幂等操作，可多次运行以同步最新补丁。

完全卸载：

bash ~/.openclaw-android/uninstall.sh

这将移除程序和补丁，但保留 ~/.openclaw 中的数据配置。

常见问题与性能说明

Q: 命令行操作感觉比电脑慢？

A: 像 openclaw status 这类命令需要读取大量小文件，受限于手机闪存速度和安卓的安全沙箱机制，确实会有轻微延迟。

但是，一旦 gateway 进程启动，它常驻内存，AI 推理和响应速度与电脑端完全一致，因为核心计算是在云端或外部模型完成的，手机仅作为高效的中继网关。

Q: 遇到网络错误或崩溃怎么办？

A: 安装脚本已自动应用了网络错误预防补丁和路径转换逻辑。若仍遇问题，请参考项目的 [故障排除指南]，通常与特定机型的省电策略有关。