预计耗时
30-45 分钟
首次安装更建议预留一整段时间
Android 10+ / Termux / Debian / OpenClaw
从零开始，把 OpenClaw 装到手机里并学会控制手机
这份页面已经按新手更容易理解的方式排好步骤。你只需要按顺序执行： 先准备环境，再装 OpenClaw，再配置 API，最后接入 ADB 控制手机。
零基础
命令可复制
手机端友好
关键风险点
Bionic Bypass
Android 内核拦截问题，这一步不能省略
最终结果
Gateway + TUI + ADB
能对接模型，也能控制手机执行操作
01
先装运行环境
在 Android 上安装 Termux，用 Debian 容器提供更稳定的 Linux 执行环境。
02
再装 OpenClaw
在 Debian 里装 Node.js 22、OpenClaw，并用劫持脚本绕过 Android 系统兼容问题。
03
最后接入模型与手机
完成 API Key 配置、启动 Gateway，再通过无线调试与 ADB 让 OpenClaw 控制手机。
Start Here
前置要求
先把准备工作一次看清楚，避免做到一半才发现设备或密钥没准备。
Android 10 及以上
教程默认你使用 Android 手机，并且系统支持无线调试。
先安装 Termux
准备大模型 API Key
给小白的建议
先决定你要用哪家模型服务商，再开始安装。因为后面的
openclaw onboard 会直接进入 API Key 与渠道配置流程。
Zero-Basic Map
三层环境理解
新手最容易搞混“Termux、Debian、OpenClaw”分别做什么，这里先拆开。
Termux
它是 Android 手机上的终端入口。你先打开它，再在里面安装 Debian 容器。
Debian 容器
真正安装 Node.js、OpenClaw、ADB 的地方。后续大多数命令都在这里执行。
OpenClaw
模型接入、网关运行、终端会话、手机控制都由它负责。
Install Flow
安装步骤总览
建议完全按下面顺序执行，不要跳步骤。
1
Termux 主环境配置
更新 Termux、安装 proot-distro、部署 Debian 并登录。
2
Debian 安装 OpenClaw
装 Node.js 22、编译工具和最新版 OpenClaw。
3
Bionic Bypass 修复
通过劫持 Node.js 的 os.networkInterfaces() 避免系统崩溃。
4
初始化与模型接入
运行 openclaw onboard，完成 API Key 与渠道配对。
Step 1
Termux 主环境配置：安装并登录 Debian
这一节所有命令都在 Termux 主环境 中执行，一行一行回车。
你在做什么
先把 Android 终端准备好，再借助 proot-distro 构建一个 Debian 容器，后面的 OpenClaw 安装都在这个容器里完成。
# 更新Termux系统包
pkg update && pkg upgrade -y
# 安装proot-distro（用于搭建Debian容器）
pkg install proot-distro -y
# 安装Debian系统
proot-distro install debian
# 登录Debian容器（后续所有操作均在该容器内执行）
proot-distro login debianStep 2
Debian 容器内安装核心依赖与 OpenClaw
这一步开始，你已经在 Debian 容器内部。
需要安装什么
先更新 Debian 包源，再安装基础依赖、Node.js 22，最后全局安装最新版 OpenClaw。
提醒
如果你下载 openclaw@latest 比较慢，可能需要科学网络环境。
# 更新Debian包源并升级
apt update && apt upgrade -y
# 安装基础依赖
apt install curl git build-essential -y
# 安装Node.js 22
curl -fsSL https://deb.nodesource.com/setup_22.x | bash -
apt install -y nodejs
# 全局安装最新版OpenClaw官方版本（下载慢可能需要挂梯子）
npm install -g openclaw@latestStep 3 · Critical
Bionic Bypass：解决系统崩溃问题
这里已经明确说明：这一节不可省略。
为什么必须做
Android 内核会拦截 os.networkInterfaces() 调用，导致 OpenClaw 运行时报错。
这里通过劫持 Node.js 运行时，把该调用替换为空对象。
# 创建劫持脚本
cat <<EOF > /root/hijack.js
const os = require('os');
os.networkInterfaces = () => ({});
EOF
# 配置环境变量，让所有OpenClaw命令永久加载该脚本
echo 'export NODE_OPTIONS="-r /root/hijack.js"' >> ~/.bashrc
# 生效环境变量
source ~/.bashrcStep 4
初始化配置：绑定 API Key 与接入渠道
安装完成后，就进入真正的 OpenClaw 配置阶段。
1. 启动初始化向导
openclaw onboard2. 启动 Gateway 并看日志
openclaw gateway --verbose3. 新开会话后测试模型
在 Termux 里按手机音量下键新建一个新终端，再重新登录 Debian：
# 登录Debian容器（后续所有操作均在该容器内执行）
proot-distro login debian
# 登录Debian容器后执行
openclaw tui进入 TUI 后，可以直接发送测试问题，比如：你是什么模型？
Keep Alive
实用技巧：保持后台运行
如果不做保活，Android 可能会把 Termux 杀掉，Gateway 就断了。
1. Termux 保活锁
termux-wake-lock2. 关闭电池优化
进入手机系统设置，找到 Termux，关闭电池优化和后台限制。
Phone Control
OpenClaw 控制手机教程
完成这里以后，你的 OpenClaw 不只是聊天，还能通过 ADB 对手机做真实操作。
先确认 2 个条件
- 手机和 Termux / Debian 在同一 WiFi 网络
- 安卓系统已经开启无线调试
路径：手机桌面 → 系统设置 → 开发者选项 → 开启无线调试。
记住你看到的 IP:端口，例如 192.168.11.6:36991。
1
先在 Termux 完成授权
如果你已经在 Debian 中，先输入 exit 退回 Termux。
pkg update -y
pkg install android-tools -y
# 以下 IP：端口 按你实际在设置里看到的填写
adb connect 192.168.11.6:36991
# 验证连接
adb devices
手机会弹出“允许无线调试？”，请选择 一律允许。
成功后 adb devices 会出现 device 状态。
2
再进入 Debian 使用 ADB
手机授权完成后，在 Debian 容器里重复连接一次。
proot-distro login debian
apt update -y
apt install android-tools-adb -y
# IP：端口 按你实际在设置里看到的填写
adb connect 192.168.11.6:36991
# 验证设备
adb devicesTest Run
开始测试控制手机
先启动 Gateway，再通过 TUI 下发自然语言指令。
openclaw gatewayopenclaw tui
测试提示词
打开 QQ 音乐播放当前歌曲后打开抖音刷 5 条视频
ADB Toolbox
Debian 里调试手机的常用命令
这些命令适合排查连接问题，或者直接对手机进行文件与应用操作。
adb shell # 进入手机系统 Shell
adb shell su # 进入 Root 权限（需手机已 Root）
adb install xxx.apk # 安装 APK
adb push 本地文件 /sdcard/ # 向手机传输文件
adb pull /sdcard/文件名 . # 从手机拉取文件到 DebianNotes
注意事项
这些都是实际操作中最常见的坑。
无线调试端口会变
每次重启手机或关闭再打开无线调试后，IP:端口 可能变化，需要重新查看并重新连接。
网络必须一致
手机和 Termux / Debian 必须在同一 WiFi 网络，否则 ADB 无法直连。
连接失败先重置 ADB
adb kill-server执行后重新运行 adb connect IP:端口。
FAQ
常见问题
专门给第一次接触这套流程的人准备。
为什么既要 Termux 又要 Debian？
Termux 是 Android 终端入口，Debian 是更稳定、更完整的 Linux 运行环境。OpenClaw 和 Node.js 放在 Debian 里更稳。
openclaw gateway 和 openclaw tui 有什么区别？
gateway 是核心引擎和连接层，tui 是你和模型对话、下发任务的终端界面。
如果看不到开发者选项怎么办？
通常可以通过“连续点击系统版本号三次”开启，不同品牌入口略有区别，可以按机型搜索具体步骤。
Bionic Bypass 真的必须做吗？
是。这里已经明确指出该步骤不可省略，否则 OpenClaw 可能因为 Android 内核拦截网络接口调用而直接报错。