Termux + Ubuntu + OpenClaw · 从零开始+科普

测试使用设备：荣耀200 Pro / 骁龙8s Gen3 / 12GB / Android 16

此教程同样适用于任何 Android 10 以上、4GB 以上内存的安卓手机

写在前面：什么是 OpenClaw？

OpenClaw 是 2025 年底推出的一款开源 AI 智能体（Agent）框架，因为它的图标是一只红色龙虾，在国内被网友亲切地称为“龙虾”。

龙虾和我们平时用的 ChatGPT、Claude、智谱清言、豆包这些“对话式 AI”不同，OpenClaw 最大的特点是能动手干活。传统的 AI 只能在对话框里一问一答，而 OpenClaw 可以直接操作你的电脑（或手机），它帮你整理文件、写代码并执行、抓取网页信息、发邮件、定时执行任务……它不只是一张“嘴”而是一双“手”。

当前，OpenClaw 在 GitHub 上的星标数量迅速突破 20万，甚至催生了深圳腾讯大厦楼下市民排队免费安装的盛况，甚至一度把 Mac Mini 的价格都炒高了。

其实你并不需要买 Mac Mini，有一部闲置的安卓手机，就够了。

为什么安卓手机能跑龙虾？

这里涉及几个技术概念，先做简要科普。

Termux 是什么？

Termux 是一款运行在安卓上的 Linux 终端模拟器。你可以把它理解为是在你的安卓手机里开了一个“命令行窗口”，让你可以像操作 Linux 电脑一样输入命令、安装软件。它不需要 root（获取手机最高权限），普通手机直接装就能用。

proot-distro 是什么？

安卓系统底层虽然是 Linux 内核，但它的用户空间和标准 Linux 发行版（比如 Ubuntu）差别很大，有很多软件没法直接在 Termux 里跑。

proot-distro 的作用是在 Termux 里再套一层 Ubuntu 系统。它通过一种叫“proot”的技术，让手机在不需要 root 权限的情况下模拟出一个完整的 Ubuntu 环境。OpenClaw 需要的 Node.js 22+ 和各种依赖在这个 Ubuntu 环境里就能正常安装和运行。

可以想象成一个“俄罗斯套娃”。

安卓系统

└── Termux（Linux 终端）

           └── Ubuntu（通过 proot-distro）

                    └── Node.js + OpenClaw

Node.js 是什么？

Node.js 是一个 JavaScript 运行环境。OpenClaw 就是用 JavaScript/Node.js 写的，所以运行龙虾必须先装 Node.js。OpenClaw 要求Node.js版本在 22 以上。

OpenClaw 在手机上做什么？

OpenClaw 在手机上运行的其实是一个“网关（Gateway）”，它负责接收你的指令、调用云端的大模型 API（比如 Gemini、DeepSeek、Claude 等）来“思考”，然后把思考结果转化为实际操作。

AI 推理（思考）是在云端完成的，你的手机只负责“接单”和“执行”。所以手机的 CPU 性能不是瓶颈，内存够用就行。这也是为什么一台旧手机也能当 24 小时 AI 服务器。

开始之前你需要准备什么

1. 一部安卓手机，Android 10 以上，内存 4GB 以上（8GB 以上更佳）。

2. 稳定的网络连接，安装过程需要下载约 200–300MB 的数据。

3. 一个 AI 服务商的 API Key，用来让龙虾调用 AI 大模型。

4. 一根充电线，如果打算让龙虾长时间运行，建议插着电。

硬件参考（以荣耀200 Pro 为例）

第一步：安装 Termux 和 Termux:API

为什么不能从 Google Play 安装？

Google Play 上的 Termux 版本停留在很久以前，已经不再维护，很多功能都是坏的。官方推荐从 F-Droid（一个开源软件商店）安装最新版。

操作步骤

1. 打开手机浏览器，访问 F-Droid 官网：https://f-droid.org。

2. 点击页面上的下载按钮，下载 F-Droid 的 APK 安装包。

3. 系统会提示“不允许安装未知来源的应用”，按提示去设置里允许浏览器安装应用，然后回来继续。

4. 安装好 F-Droid 后，打开它搜索 Termux，安装。

5. 再搜索 Termux:API，也安装上。

Termux:API 是 Termux 的扩展插件，让命令行程序能调用安卓手机的硬件功能——摄像头、传感器、短信、通知等。龙虾以后“动手干活”时可能会用到【想想是不是很让人兴奋？】。

验证安装

打开 Termux，看到黑色背景界面底部出现 $ 提示符就说明安装成功。

第二步：系统防杀设置【极其重要】

为什么需要这一步？

国产安卓系统（华为 HarmonyOS、荣耀 MagicOS、小米 MIUI/HyperOS、OPPO ColorOS、vivo OriginOS 等）为了省电和提升续航都会非常激进地杀后台应用。

对普通 App 来说这没什么问题，但 OpenClaw 需要一直在后台运行。如果不做设置，你一锁屏系统几分钟内就会把 Termux 进程杀掉，龙虾就会直接暴毙。

荣耀 MagicOS 的设置方法

2.1 允许忽略电池优化

路径：设置→ 应用和服务 → 应用管理 → 找到 Termux → 权限 → 往下翻到“其他”区域 → 点击“请求忽略电池优化”→ 设为允许。

同时在同一个页面，把“防止手机休眠”也设为允许。

2.2 对 Termux:API 做同样设置

重复上面的步骤，找到 Termux:API，做同样的设置。

2.3 关闭省电模式

确认手机没有开启省电模式或超级省电模式。设置→ 电池 → 确认省电模式关闭。

2.4 锁定最近任务

打开 Termux 后，从屏幕底部上滑停顿进入多任务界面，找到 Termux 的卡片，点击右上角的锁图标，把它锁住。这样“一键清理后台”不会误杀 Termux。

其他品牌手机参考

具体路径可能因系统版本不同有差异，但是核心思路都一样，让系统不要限制 Termux 的后台运行。

第三步：Termux 基础环境配置

打开 Termux，开始输入命令。

3.1 更新软件包

pkg update -y && pkg upgrade -y

pkg 是 Termux 的包管理器（类似手机上的“应用商店”，但管理的是命令行工具）。update 刷新可用软件列表，upgrade 升级已安装软件到最新版。-y 表示自动确认。两条命令用 && 连接，意思是“第一条成功了才执行第二条”。

过程中可能弹出提示，一路按回车选默认即可。

3.2 获取存储权限

termux-setup-storage

Termux 默认只能访问自己的私有目录。执行这条命令后，系统会弹出授权弹窗，允许 Termux 访问手机的公共存储空间（相册、下载、文档等）。弹出授权提示时点“允许”。

3.3 开启唤醒锁

termux-wake-lock

这是告诉安卓系统，Termux 正在执行重要任务，请不要让 CPU 休眠。执行后通知栏会出现 Termux 的常驻通知，说明唤醒锁已生效。每次重新打开 Termux 都要执行一次这条命令。

第四步：安装 Ubuntu 环境

4.1 安装 Ubuntu

proot-distro install ubuntu

proot-distro 是 Termux 提供的工具，专门用来在 Termux 内安装 Linux 发行版。这条命令会下载一个精简版 Ubuntu 镜像（约 50–100MB），并解压到 Termux 目录里。安装完成后会看到绿色的 [*] Finished. 字样。过程中可能出现黄色 Warning（“CPU doesn’t support 32-bit instructions”之类），这对我们要跑的东西完全没影响，忽略即可。

4.2 进入 Ubuntu

proot-distro login ubuntu

执行后，命令行提示符会变成：

root@localhost:~#

这说明你已经“进入”了 Ubuntu 环境。从现在开始输入的命令都是在 Ubuntu 里执行的。

这不是真正的虚拟机，性能几乎没有损失。proot 只是做了一层路径映射和系统调用转换，开销很小。

第五步：安装依赖和 Node.js

以下命令都在 Ubuntu 环境里执行（提示符是 root@localhost:~#）。

5.1 更新 Ubuntu 并安装基础工具

apt update && apt upgrade -y && apt install curl git build-essential -y

apt 是 Ubuntu 的包管理器。curl 是命令行下载工具；git 是版本控制工具；build-essential 是 C/C++ 编译工具链，有些 npm 包安装时需要编译本地代码。这一步也可能出现黄色 Warning，同样忽略。

5.2 安装 Node.js 22

curl -fsSL https://deb.nodesource.com/setup_22.x | bash - && apt install -y nodejs

这其实是两条命令：第一条从 NodeSource（Node.js 官方推荐的分发渠道）下载安装配置脚本并执行，自动配置好 Node.js 22 的软件源；第二条用 apt 安装 Node.js。“|”是管道符，意思是把下载的内容直接传给 bash 执行。

安装完成后可以验证版本：

node --version

应该显示 v22.x.x，大版本是 22 就没问题。

5.3 安装 OpenClaw

npm install -g openclaw@latest

npm 是 Node.js 的包管理器，-g 表示全局安装。这一步会下载 OpenClaw 和它的所有依赖包（约 600–700 个包），需要几分钟。过程中的 npm warn deprecated 是某些依赖包版本较旧的提示，不影响使用。看到 added 669 packages 就说明安装成功。

如果下载速度很慢或者报错，可以先换镜像源再安装：

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

npm install -g openclaw@latest

第六步：初始化 OpenClaw

openclaw onboard --install-daemon

onboard 是 OpenClaw 的初始化向导，会引导你选择 AI 服务商、输入 API Key、选择消息通道。--install-daemon 会同时安装守护进程，让龙虾可以在后台持续运行。

6.1 选择 AI 服务商

向导会列出支持的 AI 服务商，以下是几个推荐选项：

新手推荐：先选 Google Gemini（免费）或 DeepSeek（便宜）。我用的是火山引擎的coding套餐。智谱的coding套餐也可以，但是现在或许是因为算力紧张的缘故，需要限时抢购。Kimi等等都有coding套餐，听说千问的有免费的，我没有试过。如果重度使用，一定要用coding套餐。

6.2 获取 API Key

什么是 API Key？

API Key就是一把“钥匙”，就是应用程序编程接口密钥。AI 服务商的大模型运行在他们的服务器上，你每次让龙虾干活，龙虾就带着这把钥匙去敲服务商的门：“这是我主人的钥匙，请帮他处理这个任务。”服务商验证钥匙有效后就会出结果。

API Key 等同于你的账号密码，不要泄露给任何人。

Google Gemini API Key 获取方法

1. 浏览器打开 https://aistudio.google.com/apikey

2. 用 Google 账号登录

3. 点击 Create API Key

4. 复制生成的 Key（一长串字母数字）

DeepSeek API Key 获取方法

1. 手机浏览器打开 https://platform.deepseek.com

2. 注册并登录

3. 进入“API Keys”页面，创建新 Key

4. 复制 Key

6.3 选择消息通道

建议先选 Web UI（网页界面），这是最简单的方式。后面随时可以加 飞书、Telegram 等通道。

6.4 完成初始化

看到 Onboarding complete 字样后，初始化完成。可能需要按 Ctrl + C（Termux 底部辅助按钮栏上有 CTRL 按钮）退出向导。

第七步：启动龙虾并访问

7.1 启动 Gateway

openclaw gateway --verbose

--verbose 表示输出详细日志。启动成功后会看到：

Gateway running on http://localhost:18789

7.2 获取访问 Token

从 Termux 左侧边缘向右滑动，打开侧边栏，点击 New Session（新建会话），然后输入：

proot-distro login ubuntu

进入 Ubuntu 后：

cat ~/.openclaw/openclaw.json

找到 "token" 字段，后面引号里的那串字符就是你的访问 Token，长按复制它。

7.3 打开 Web 界面

手机浏览器访问：

http://localhost:18789

localhost 和 127.0.0.1 都是“本机地址”的意思，指你手机自己。因为龙虾就运行在手机上，所以访问自己就行了。18789 是 OpenClaw 默认使用的端口号。

在页面的 Gateway Token 输入框粘贴你的 Token，点 Connect。看到对话界面后输入“你好”——龙虾回复了，恭喜你，部署成功！

日常使用速查

每次启动龙虾的流程

每次手机重启或 Termux 被关闭后，需要依次执行三条命令：

termux-wake-lock

proot-distro login ubuntu

openclaw gateway --verbose

从电脑访问手机上的龙虾

前提：手机和电脑在同一个 WiFi 下。在 Termux 里（不是 Ubuntu 里，输入 exit 可退回 Termux）查看手机 IP：

ip addr show wlan0

找到 inet 后面的 IP 地址（格式如 192.168.1.105），然后在电脑浏览器访问：

http://192.168.1.105:18789

停止龙虾

在运行 Gateway 的那个 Termux 会话里，按 CTRL 然后按 C。

查看状态

openclaw status

更新 OpenClaw

进入 Ubuntu 环境后：

npm update -g openclaw

卸载

进入 Ubuntu 环境后卸载 OpenClaw：

npm uninstall -g openclaw

如果要把整个 Ubuntu 也删掉，退回 Termux 后：

proot-distro remove ubuntu

常见问题

Q1: 锁屏后龙虾断了？

安卓系统杀后台导致的。请严格按照第二步设置，并确认：termux-wake-lock 已执行（通知栏有常驻通知）；Termux 在最近任务里已锁定；手机没开省电模式；电池优化已设为“不受限制”。

Q2: npm install 卡住或报错？

大概率是网络问题。换镜像源：

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

npm install -g openclaw@latest

Q3: 手机发烫严重？

龙虾待机时几乎不耗资源。如果持续发烫，检查是不是有 Skill 在循环执行任务。建议不要边充电边长时间高负载运行。

Q4: Token 费用怎么控制？

龙虾每次执行任务都要调用大模型 API，按量计费。建议初期用 Gemini 免费额度或 DeepSeek（很便宜），定期去 API 服务商后台查看消费，不要让龙虾无人值守地执行大量复杂任务。

安全提醒

OpenClaw 拥有操作系统级别的权限——它能读写文件、执行命令。这既是它强大的原因，也是潜在的风险来源。

1. 不要安装来路不明的 Skill 包，只从官方或可信来源安装技能包。

2. 保护好你的 API Key 和 Gateway Token，不要截图发到群里或分享给他人。

3. 不要在主力手机上跑高风险任务，建议用闲置手机部署，与日常使用的手机隔离【不过我就是用我的主力手机部署的，我的理念是别怕这怕那】。

4. 定期检查龙虾的操作日志，了解它在你的设备上做了什么。

名词对照表