Android 上安装 OpenClaw：Termux + proot 完整指南

摘要

本文详细介绍如何在 Android 设备上通过 Termux + proot 环境安装和配置 OpenClaw，包括常见坑点、解决方案，以及与其他部署方案的对比。关键词：OpenClaw、Android、Termux、proot、LLM、部署

---

导言

OpenClaw 作为强大的 AI 开发框架，通常在服务器或 PC 上运行。但你知道吗？通过 Termux 和 proot，你也能在 Android 手机上完整部署 OpenClaw！

本文将手把手教你如何实现这一点，并解决过程中的各种坑。

---

第一部分：环境准备

1.1 什么是 Termux + proot？

• Termux：Android 上的 Linux 终端模拟器，提供完整的 bash、apt 等工具
• proot：用户空间 root 实现，让你在 Termux 中模拟完整的 Linux 文件系统，无需 root 权限

这个组合让 Android 设备成为真正的便携式 Linux 工作站。

1.2 前置条件

• Android 版本：6.0 及以上（推荐 8.0+）
• 存储空间：至少 2GB
• RAM：至少 1GB 可用（推荐 2GB+）
• 网络：用于 npm 下载

1.3 安装步骤

第一步：安装 Termux

从 F-Droid 或 GitHub 下载安装（不要用 Google Play，官方已停维）。

首次启动会自动下载基础系统（~300MB），耐心等待。

第二步：安装 proot-distro

apt update && apt upgrade -y
apt install -y proot-distro
proot-distro install ubuntu
proot-distro login ubuntu

现在你有了一个完整的 Ubuntu Linux 环境！

---

第二部分：在 proot 中安装 OpenClaw

2.1 安装基础工具

进入 proot Ubuntu 后：

apt update && apt upgrade -y
apt install -y nodejs npm git build-essential python3 openssh-server

验证：

node --version   # 应为 v22.x 或更高
npm --version    # 应为 9.x 或更高

2.2 安装 OpenClaw（核心步骤）

npm install -g openclaw --ignore-scripts

⚠️ 关键参数：--ignore-scripts 非常重要！它告诉 npm 跳过本地编译步骤，避免 ARM64 兼容性问题。

验证：

openclaw --version
# 输出: 2026.3.2

2.3 初始化

mkdir -p ~/openclaw-workspace
cd ~/openclaw-workspace
openclaw init

---

第三部分：配置和启动

3.1 配置 LLM API

编辑 ~/.openclaw/openclaw.json：

{
  "models": {
    "providers": {
      "internal": {
        "baseUrl": "https://your-llm-gateway.com",
        "apiKey": "your-api-key",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "claude-haiku-4.5",
            "name": "Haiku"
          }
        ]
      }
    }
  },
  "gateway": {
    "port": 3000,
    "mode": "local",
    "bind": "loopback",
    "auth": {"mode": "none"}
  },
  "plugins": {
    "entries": {
      "memory-lancedb-local": {"enabled": false}
    }
  }
}

关键配置说明：

• bind: "loopback"：只允许本机访问（更安全）
• memory-lancedb-local: disabled：禁用本地内存插件（Android 上 ONNX 不兼容）

3.2 启动 Gateway

前台运行（看实时日志）：

openclaw gateway --port 3000

后台运行（推荐）：

nohup openclaw gateway --port 3000 > ~/gateway.log 2>&1 &

然后访问 http://localhost:3000 即可使用！

---

第四部分：常见坑点和解决方案

坑 1️⃣：npm install 失败 - git command not found

症状：

npm error syscall spawn git
npm error path git

解决：

apt install -y git build-essential
npm install -g openclaw --ignore-scripts --force

经验：在 proot 环境中，一定要预装好开发工具链。

---

坑 2️⃣：原生模块不兼容 - onnxruntime-node

症状：

npm error notsup Valid os: darwin,linux,win32
npm error notsup Actual os: android

根本原因：memory-lancedb-local 插件依赖 onnxruntime-node，不支持 Android 的 proot 环境。

解决：在 openclaw.json 中禁用该插件：

{
  "plugins": {
    "entries": {
      "memory-lancedb-local": {"enabled": false}
    }
  }
}

权衡：失去本地内存功能，但能正常使用 LLM 调用。

---

坑 3️⃣：Gateway 启动失败 - bind without auth

症状：

Refusing to bind gateway to lan without auth.
Set gateway.auth.token/password or pass --token/--password

原因：尝试绑定到 lan（外网）但没有认证。

解决：改为 loopback（仅本机）或配置 token：

{
  "gateway": {
    "bind": "loopback",
    "auth": {"mode": "none"}
  }
}

---

坑 4️⃣：内存溢出 - heap out of memory

症状：

FATAL ERROR: Allocation failed - JavaScript heap out of memory

原因：Node.js 默认堆内存限制在 proot 环境下不足。

解决：

export NODE_OPTIONS="--max-old-space-size=512"
openclaw gateway --port 3000

建议：根据设备 RAM 设置（512MB 到 2GB）。

---

坑 5️⃣：npm install 极其缓慢

原因：proot 文件系统性能较差，npm 下载时网络也可能限速。

解决：

# 使用国内镜像（如在中国）
npm config set registry https://registry.npmmirror.com

# 或安装 yarn（通常更快）
apt install -y yarn
yarn global add openclaw

---

第五部分：进阶配置 - SSH 远程访问

如果想从其他设备访问 Android 上的 OpenClaw，需要配置 SSH。

5.1 启动 SSH 服务

# 在 proot Ubuntu 中
apt install -y openssh-server
ssh-keygen -A
service ssh start

# 设置 root 密码
passwd

5.2 获取 IP 地址

hostname -I
# 输出: 192.168.1.100

5.3 远程连接

从其他机器：

ssh -p 22 root@192.168.1.100

# 或带 SSH key
ssh -i ~/.ssh/id_rsa -p 22 root@192.168.1.100

然后就能在 SSH 会话中运行 OpenClaw 命令了！

---

第六部分：性能优化

优化 1：使用国内 npm 镜像

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

优化 2：配置 Node.js 内存

export NODE_OPTIONS="--max-old-space-size=512 --enable-source-maps"

优化 3：禁用不必要的插件

在 openclaw.json 中只启用需要的插件：

{
  "plugins": {
    "allow": [],
    "entries": {}
  }
}

优化 4：监控系统资源

apt install -y htop
htop  # 实时查看 CPU、内存使用

---

第七部分：方案对比

方案	优点	缺点	何时选用
Termux + proot	✅ 无需 root ✅ 完整 Linux 环境 ✅ 支持 SSH 远程	⚠️ 原生模块兼容性差 ⚠️ 性能低于容器	开发、学习、轻量应用
Docker（需 root）	✅ 隔离性好 ✅ 性能最优 ✅ 官方支持	❌ 需要 root ❌ 仅 Android 12+ ❌ 设置复杂	生产环境、高性能
本地 Node.js（无 proot）	✅ 最简单 ✅ 最快	❌ 需要 root ❌ 原生模块问题 ❌ 文件系统隔离差	快速测试、简单脚本
Kubernetes（k3s）	✅ 集群支持 ✅ 容器编排	❌ 极其复杂 ❌ 资源消耗大	大规模分布式部署

---

完整快速启动脚本

保存为 ~/quick-setup.sh：

#!/bin/bash
set -e

echo "🚀 Android OpenClaw 一键安装"
apt update && apt upgrade -y
apt install -y nodejs npm git build-essential python3 openssh-server
npm install -g openclaw --ignore-scripts --force
openclaw init --quiet 2>/dev/null || true

mkdir -p ~/.openclaw
cat > ~/.openclaw/openclaw.json << 'EOF'
{
  "models": {
    "providers": {
      "internal": {
        "baseUrl": "https://your-api.com",
        "apiKey": "your-key",
        "api": "anthropic-messages",
        "models": [{"id": "claude-haiku-4.5", "name": "Haiku"}]
      }
    }
  },
  "gateway": {
    "port": 3000,
    "bind": "loopback",
    "auth": {"mode": "none"}
  },
  "plugins": {
    "entries": {"memory-lancedb-local": {"enabled": false}}
  }
}
EOF

echo "✅ 完成！运行: openclaw gateway --port 3000"

使用：

chmod +x ~/quick-setup.sh
./quick-setup.sh

---

总结

通过 Termux + proot，你已经可以在 Android 设备上完整部署 OpenClaw，虽然有一些兼容性注意事项，但整体方案成熟可靠。

核心要点回顾：

1. ✅ 使用 --ignore-scripts 避免编译问题
2. ✅ 禁用不兼容的插件（memory-lancedb-local）
3. ✅ 配置适当的内存限制
4. ✅ 考虑 SSH 远程访问
5. ✅ 使用国内镜像加速下载

这使得 Android 设备真正成为强大的 AI 应用开发和部署平台。

---

参考

• Termux GitHub
• proot-distro
• OpenClaw 官方文档
• Node.js ARM64 支持

---

发布日期：2026-03-04
标签：OpenClaw、Android、Termux、proot、DevOps、LLM
分类：开发工具
本文对应开源项目：OpenClaw