ByteNoteByteNote

字节笔记本

2026年2月20日

在 Android 手机上运行 OpenClaw 完全指南

本文是一篇详细的教程,介绍如何在 Android 手机上通过 Termux 和 proot-distro 安装运行 OpenClaw,让你无需 Mac Mini 也能拥有一个功能强大的 AI 助理。

前言

OpenClaw 是一个开源的 AI 智能代理框架,通常需要在服务器或电脑上运行。但通过 Termux 和 proot-distro,我们可以在 Android 手机上安装完整的 Linux 环境,从而运行 OpenClaw。

关键要点:所有在 Android 上运行 OpenClaw 的教程都基于 Termux,但成功的关键在于安装 proot-distro 这个插件,它让我们得以在 Termux 内安装完整的 Linux 发行版。

要求:Android 10.0 以上系统版本的手机

安装步骤

1. 安装 Termux

  • 打开 F-Droid.org 下载并安装 F-Droid
  • 在 F-Droid 中搜索 Termux 并安装
  • 或者直接在 Google Play Store 搜索 Termux 安装(Pixel 6 Pro 测试通过)

2. 更新 Termux 包

bash
pkg update && pkg upgrade -y

作用说明:

  • pkg update:刷新 Termux 的软件包索引
  • pkg upgrade -y:自动升级所有已安装软件到最新版本

3. 安装 proot-distro

bash
pkg install proot-distro

这是在 Android 里运行真实 Linux 环境的关键步骤。proot-distro 允许在 Termux 内安装完整的 Linux 发行版,不需要 root 权限。

4. 安装 Ubuntu

bash
proot-distro install ubuntu

这个命令会在 Termux 里安装 Ubuntu(真实的 Linux 发行版),OpenClaw 环境就能在 Ubuntu 下运行。

5. 登录 Ubuntu 环境

bash
proot-distro login ubuntu

进入刚才安装的 Ubuntu 系统,然后就可以像正常 Ubuntu 一样执行命令。

6. Ubuntu 系统更新

bash
apt update && apt upgrade -y

刷新 Ubuntu 的软件源并升级系统,确保软件和安全补丁是最新的。

7. 安装 curl

bash
apt install -y curl

curl 是一个命令行下载工具,用于从网络下载脚本或文件。OpenClaw 安装脚本需要用它来获取 Node.js 设置脚本。

8. 添加 Node.js 官方软件源

bash
curl -fsSL https://deb.nodesource.com/setup_22.x | bash -

这个命令从 NodeSource 下载脚本并执行,让 Ubuntu 能安装 Node.js 22。Ubuntu 默认仓库里可能没有最新版本。

9. 安装 Node.js

bash
apt install -y nodejs

安装 Node.js 运行时,用来运行 OpenClaw 主程序。

10. 检查版本

bash
node -v
npm -v

检查 Node.js 与 npm 是否成功安装,版本是否可用。

11. 安装 git

bash
apt install -y git

安装 git,用于后续可能拉取插件仓库、更新脚本等。

12. 安装 OpenClaw

bash
npm install -g openclaw@latest

从 npm 安装 OpenClaw 框架全局运行版,将核心智能代理程序装到 Android Linux 环境中。

13. 网络接口修复脚本

bash
cat <<EOF > /root/hijack.js
const os = require('os');
os.networkInterfaces = () => ({});
EOF

echo 'export NODE_OPTIONS="-r /root/hijack.js"' >> ~/.bashrc
source ~/.bashrc

作用说明:Android Termux 里的网络接口行为与标准 Linux 不一样,这个脚本让 Node.js 绕过检测网络接口的逻辑错误,否则 OpenClaw 可能找不到本地网络地址。

14. 运行 OpenClaw 安装向导

bash
openclaw onboard

这个交互式命令会引导你完成 OpenClaw 的初始设置:

  • Gateway 绑定地址
  • API key 配置
  • 端口、权限、默认设置等

向导可以自动生成配置文件。

15. 启动代理核心服务

bash
openclaw gateway --verbose

这个命令启动 OpenClaw 的后端服务守护进程(gateway 模块),它会监听本地请求(例如仪表盘、消息客户端通知、技能管理等)。

--verbose 表示显示详细输出,用于调试。这个命令成功启动后,就代表 OpenClaw 已经成功运行起来了。

结语

在手机上运行 OpenClaw 并不是炫技,也并非多此一举。虽然有一些插件无法在手机端使用,但运行在手机里的 OpenClaw 依然可以作为一个贴心的、功能强大的 AI 助理,帮我们完成很多工作,比如自动发布公众号。

不要再推高 Mac Mini 的销量了,谁还没有一台闲置的 Android 手机呢?

分享: