LuRen' Blog

OpenClaw 在 Android Termux 上的全流程教程

发表于 更新于 分类于

这份教程结合了 Sagar 的“内核绕过”技术与 PM2 的进程管理，确保你的 AI 机器人在安卓端 24/7 稳定运行。

🛠️ 前置准备

  1. 设备：Android 10 或更高。

  2. Termux：请务必使用 F-Droid 版本。

  3. API Key：准备好 Gemini API Key。

1. 环境搭建 (Ubuntu proot)

1
2
3
4
5
pkg update && pkg upgrade -y
pkg install proot-distro -y
proot-distro install ubuntu
proot-distro login ubuntu

2. 安装 Node.js 与 OpenClaw

1
2
3
4
5
6
apt update && apt upgrade -y
apt install curl git build-essential -y
curl -fsSL https://deb.nodesource.com/setup_22.x | bash -
apt install -y nodejs
npm install -g openclaw@latest

3. 核心补丁：Bionic Bypass (解决 Error 13)

这是防止 OpenClaw 闪退的关键。

1
2
3
4
5
6
7
8
9
10
# 创建劫持脚本
cat <<EOF > /root/hijack.js
const os = require('os');
os.networkInterfaces = () => ({});
EOF

# 写入环境变量，确保全局生效
echo 'export NODE_OPTIONS="-r /root/hijack.js"' >> ~/.bashrc
source ~/.bashrc

4. 初始化配置

1
2
openclaw onboard

  • 注意：在网关绑定（Gateway Bind）时，务必选择 127.0.0.1。

5. 调试运行 (测试用)

在正式进入后台运行前，先手动测试是否能跑通：

1
2
openclaw gateway --verbose

确认 Telegram 机器人有响应后，按 Ctrl+C 退出，进入下一步。

6. 使用TMUX 持久化后台运行 (新增)

使用tmux可以让机器人即使在关闭终端窗口后依然运行。

1
2
3
4
5
6
7
8
9
10
11
12
# 在termux下创建tmux的实例
tmux new -s openclaw
# 进入实例后启动openclaw
openclaw gateway --verbose

# 退出当前实例
ctrl + b  然后  d
# 查看当前在后台运行的实例
tmux ls
# 进入实例
tmux a -t openclaw

7. 手机端保活建议

  • 唤醒锁：在 Termux 菜单中点击 “Acquire wakelock”，或运行 termux-wake-lock。

  • 电池优化：在安卓设置中，将 Termux 设为“不优化电池使用”。

  • 控制台访问：手机浏览器访问 http://127.0.0.1:18789 管理面板。

参考链接：