【亲测有效!手把手教你在 Android 手机上运行 OpenClaw 🦞】

被网上错误的文章误导,经过几个小时的折腾,OpenClaw 终于成功运行在我的 Pixel 6 Pro (Android 16)上了🎉🎉🎉,所以本篇文章就是为了给大家一个正确的教程,跟着做绝对能成功跑起来!

前言

原文地址:https://github.com/AbuZar-Ansarii/Clawbot

所有在 Android 上运行 OpenClaw 的教程都是基于 Termux ,但这是唯一一篇最终让我成功运行的,我看了 N 篇不靠谱的文章后,这篇教程最关键的差别在于安装 proot-distro,这个插件让我们得以在 Termux 内安装完整的 Linux 发行版,这是在 Android 里运行真实 Linux 环境的关键步骤。

为了成功构建,你需要一台至少能运行 Android 10.0 以上系统版本的手机

本文由 兔子API 友情赞助,兔子 API 有全品类的各种大模型接入,价格非常友好,大家可以用我的链接注册 https://api.tu-zi.com/register?aff=Itmf

安装步骤

1. 安装 Termux

1. 打开 F-Droid.org

1. 下载并安装 F-Droid

1. 在 F-Droid 中搜索 Termux

1. 安装 Termux

1. 打开 Termux

我的手机是 Pixel 6 Pro,可以直接在Google Play Store 里搜索 termux 并安装。目前用下来没发现问题。

2. 更新 Termux 包

所有的命令都是在 Termux 这个应用中输入的,后面不再赘述

pkg update && pkg upgrade -y

作用说明:

• pkg update:刷新 Termux 的软件包索引(类似 apt update)。

• pkg upgrade -y:自动升级所有已安装软件到最新版本。
用于确保系统环境是最新的。

3. 安装 proot-distro

这是在 Android 里运行真实 Linux 环境的关键步骤。

pkg install proot-distro

作用说明:

• proot-distro:允许在 Termux 内安装完整的 Linux 发行版(不需要 root 权限)。

4. 安装 Ubuntu

proot-distro install ubuntu

作用说明:

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

5. 登录 Ubuntu 环境

proot-distro login ubuntu

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

6. Ubuntu 系统更新

apt update && apt upgrade -y

作用说明:

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

7. 安装 curl

apt install -y curl

作用说明:

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

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

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

作用说明:
这个命令从 NodeSource 下载脚本并执行,让你的 Ubuntu 能安装 Node.js 22。
之所以要用这个脚本,是因为 Ubuntu 默认仓库里可能没有最新版本。

9. 安装 Node.js

apt install -y nodejs

作用说明:
在 Ubuntu 里安装 Node.js 运行时,用来运行 OpenClaw 主程序。
Node.js 是 JavaScript 的服务器端引擎。

10. 检查版本

node -v
npm -v

作用说明:
检查 Node.js 与 npm 是否成功安装,版本是否可用(常见测试步骤)。

11. 安装 git

apt install -y git

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

12. 安装 OpenClaw

npm install -g openclaw@latest

作用说明:
从 npm 安装 OpenClaw 框架全局运行版(类似 npm install -g clawdbot)。
这一步是将核心智能代理程序装到 Android Linux 环境中。

13. 网络接口修复脚本

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 可能找不到本地网络地址。
它通过 Node 扩展参数 加载修补逻辑。

14. 运行 OpenClaw 安装向导

openclaw onboard

作用说明:
运行安装 “向导”(wizard)。
这个交互式命令会引导你完成 OpenClaw 的初始设置:
✔ Gateway 绑定地址
✔ API key 配置
✔ 端口、权限、默认设置等
向导可以自动生成配置文件。

15. 启动代理核心服务

openclaw gateway --verbose

作用说明:
这个命令启动 OpenClaw 的后端服务守护进程(gateway 模块),它会监听本地请求(例如仪表盘、消息客户端通知、技能管理等)。
--verbose 表示显示详细输出,用于调试。

这个命令成功启动后,就代表你的 openclaw 已经成功运行起来了

结语

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

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

← 返回 XPut 首页 保存在 X 查看原帖 ↗