安卓手机安装 OpenClaw

本教程将指导您在安卓手机上通过 Termux 终端模拟器安装和运行 OpenClaw。这种方式让您无需电脑，随时随地使用 OpenClaw。

💡 提示: 安卓手机运行 OpenClaw 适合轻量级使用场景（个人测试、移动端调试）。如果需要长期稳定运行，建议使用电脑或服务器部署。

系统要求

在开始安装之前，请确保您的设备满足以下要求：

操作系统: Android 7.0 或更高版本
处理器: ARM64（大多数 2018 年后的手机均支持）
内存: 4 GB RAM 以上（推荐 6 GB+）
存储空间: 至少 2 GB 可用空间
网络: 稳定的 Wi-Fi 或移动数据连接

如何查看安卓版本：进入 设置 → 关于手机 → Android 版本。

安装 Termux

Termux 是一个安卓上的终端模拟器，提供完整的 Linux 环境，无需 root 权限。

⚠️ 重要: 请勿从 Google Play 商店安装 Termux，该版本已过时且不再维护。请使用 F-Droid 或 GitHub 下载最新版本。

方式一：通过 F-Droid 安装（推荐）

在浏览器中访问 F-Droid 官网，下载并安装 F-Droid 客户端
打开 F-Droid，搜索 Termux
点击安装，等待下载完成

方式二：通过 GitHub 下载 APK

访问 Termux GitHub Releases
下载最新版本的 termux-app_v*.apk（选择与您设备架构匹配的版本，通常为 arm64-v8a）
在手机上打开下载的 APK 文件进行安装
如果提示"不允许安装未知来源应用"，请在设置中允许浏览器安装应用

安装完成后，打开 Termux，您会看到一个命令行界面。首次启动会自动下载基础包，请耐心等待。

配置 Termux 环境

首次打开 Termux 后，需要更新软件包并安装必要的工具：

1. 更新软件包

bash

pkg update && pkg upgrade -y

此过程可能需要几分钟，中途如果提示是否更新配置文件，输入 y 确认即可。

2. 安装基础工具

bash

pkg install git curl wget openssh -y

3. 授予存储权限

如果需要访问手机存储中的文件：

bash

termux-setup-storage

系统会弹出权限请求，点击"允许"。之后可以通过 ~/storage/ 访问手机存储。

安装 Node.js

OpenClaw 依赖 Node.js 运行环境。在 Termux 中安装 Node.js：

bash

pkg install nodejs -y

安装完成后，验证版本：

bash

node --version
npm --version

确保 Node.js 版本 ≥ 18.0。如果版本过低，可以使用 nvm 安装指定版本：

bash

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc

# 安装 Node.js 18
nvm install 18
nvm use 18

安装 OpenClaw

下载并安装 OpenClaw：

bash

# 下载 OpenClaw 安装包
curl -LO https://openclaw.example.com/releases/latest/openclaw-android.tar.gz

# 解压
tar -xzf openclaw-android.tar.gz
cd openclaw

安装项目依赖：

bash

npm install

💡 提示: 如果 npm install 速度过慢，可以切换到国内镜像源：

bash

npm config set registry https://registry.npmmirror.com

如果安装过程中遇到编译错误，可能需要安装构建工具：

bash

pkg install build-essential python -y

配置环境变量

在项目根目录下创建并编辑 .env 配置文件：

bash

# 复制示例配置文件
cp .env.example .env

# 使用 nano 编辑器编辑配置
nano .env

修改以下关键配置项：

bash

# OpenClaw 基础配置
OPENCLAW_PORT=3000
OPENCLAW_HOST=0.0.0.0
OPENCLAW_ENV=development

# 数据库配置（安卓推荐使用 SQLite）
DATABASE_URL=sqlite://./data/openclaw.db

# 日志级别
LOG_LEVEL=info

编辑完成后，按 Ctrl+X，然后按 Y 确认保存，按 Enter 退出。

💡 注意: OPENCLAW_HOST 设置为 0.0.0.0 可以让同一局域网内的其他设备也能访问您的 OpenClaw 服务。如果只需要本机访问，可以设置为 localhost。

启动服务

初始化数据库并启动 OpenClaw：

bash

# 初始化数据库
npm run db:init

# 启动服务
npm run start

启动成功后，您会看到类似以下输出：

bash

OpenClaw server is running at http://0.0.0.0:3000

现在可以在手机浏览器中访问 http://localhost:3000 来使用 OpenClaw。

后台运行

默认情况下，关闭 Termux 窗口后服务会停止。以下方法可以让 OpenClaw 在后台持续运行：

方法一：使用 Termux 会话（简单）

Termux 支持多会话管理。启动服务后，从屏幕左侧向右滑动，点击 NEW SESSION 创建新会话，原会话中的服务会继续运行。

方法二：使用 nohup 命令

bash

# 后台启动
nohup npm run start > openclaw.log 2>&1 &

# 查看日志
tail -f openclaw.log

# 查看后台进程
jobs -l

方法三：使用 tmux（推荐）

tmux 是一个终端复用器，即使关闭 Termux 也能保持会话：

bash

# 安装 tmux
pkg install tmux -y

# 创建新会话
tmux new -s openclaw

# 在 tmux 会话中启动服务
cd ~/openclaw
npm run start

# 按 Ctrl+B 然后按 D 分离会话（服务继续运行）

# 重新连接会话
tmux attach -t openclaw

方法四：使用 Termux:Boot 开机自启

安装 Termux:Boot 插件可以实现开机自动启动 OpenClaw：

从 F-Droid 安装 Termux:Boot
创建启动脚本：

bash

mkdir -p ~/.termux/boot
cat > ~/.termux/boot/start-openclaw.sh << 'EOF'
#!/data/data/com.termux/files/usr/bin/sh
termux-wake-lock
cd ~/openclaw
npm run start
EOF
chmod +x ~/.termux/boot/start-openclaw.sh

安装验证

完成安装后，请按以下步骤验证 OpenClaw 是否正常运行：

打开手机浏览器，访问 http://localhost:3000
您应该能看到 OpenClaw 的欢迎页面
回到 Termux，运行健康检查：

bash

npm run health-check

如果所有检查项均显示 ✅，说明安装成功。

也可以使用 curl 测试 API 是否响应：

bash

curl http://localhost:3000/api/health

正常返回类似：

json

{"status":"ok","version":"1.x.x"}

性能优化建议

安卓设备资源有限，以下优化可以提升 OpenClaw 的运行体验：

1. 关闭不必要的后台应用

释放更多内存给 Termux 和 OpenClaw 使用。

2. 禁用电池优化

防止系统杀死 Termux 后台进程：

进入 设置 → 应用 → Termux → 电池
选择 不受限制 或 无限制

3. 锁定 Termux 通知

在 Termux 运行时，下拉通知栏，长按 Termux 通知，选择"固定"或"锁定"，防止系统清理。

4. 使用 SQLite 数据库

在安卓设备上，SQLite 比 PostgreSQL 或 MySQL 更轻量，推荐使用：

bash

DATABASE_URL=sqlite://./data/openclaw.db

5. 调整 Node.js 内存限制

如果遇到内存不足的问题，可以限制 Node.js 的内存使用：

bash

export NODE_OPTIONS="--max-old-space-size=512"
npm run start

6. 使用 Termux 唤醒锁

防止设备休眠时 CPU 降频：

bash

termux-wake-lock

常见问题

问题 1: pkg update 报错 "Unable to locate package"

症状: 执行 pkg update 时提示无法找到软件包。

解决方案:

更换 Termux 镜像源：

bash

termux-change-repo

在弹出的菜单中选择一个可用的镜像（推荐选择国内镜像如清华、中科大）。

问题 2: npm install 编译失败

症状: 安装依赖时出现 gyp ERR! 或编译错误。

解决方案:

安装编译工具链：

bash

pkg install build-essential python -y

如果仍然失败，尝试忽略可选依赖：

bash

npm install --ignore-scripts
npm install --no-optional

问题 3: Termux 被系统杀死

症状: 切换到其他应用后，回到 Termux 发现进程已被终止。

解决方案:

关闭 Termux 的电池优化（见上方性能优化部分）
在 Termux 中运行 termux-wake-lock 获取唤醒锁
使用 tmux 保持会话，即使 Termux 被杀死，重新打开后可以恢复：

bash

tmux attach -t openclaw

问题 4: 存储空间不足

症状: 安装过程中提示磁盘空间不足。

解决方案:

清理 npm 缓存：

bash

npm cache clean --force

清理 Termux 软件包缓存：

bash

pkg clean

问题 5: 局域网内其他设备无法访问

症状: 在同一 Wi-Fi 下，电脑或其他手机无法访问安卓上的 OpenClaw。

解决方案:

确保 .env 中 OPENCLAW_HOST 设置为 0.0.0.0
查看手机的局域网 IP 地址：

bash

ifconfig wlan0 | grep "inet "

在其他设备的浏览器中访问 http://手机IP:3000