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
7
8
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
# 安装 PM2 进程管理器
npm install -g pm2

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. 使用 PM2 持久化后台运行 (新增)

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

1
2
3
4
5
6
7
8
9
10
# 启动进程 (必须手动带上补丁路径)
NODE_OPTIONS="-r /root/hijack.js" pm2 start openclaw --name "ai_bot" -- gateway

# 保存进程列表 (确保重启后能自动加载)
pm2 save

# 查看运行状态和日志
pm2 status
pm2 logs ai_bot

7. 手机端保活建议

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

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

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

参考链接：