openclaw-termux：把 OpenClaw AI Gateway 装进 Android（带 App、终端和仪表盘）
openclaw-termux：把 OpenClaw AI Gateway 装进 Android（带 App、终端和仪表盘）
项目地址：https://github.com/mithun50/openclaw-termux
作者同时提供两种使用形态：Standalone Flutter App（推荐给大多数人） + Termux CLI 包（适合命令行党）。
一句话：它让你在不 root 的 Android 设备上，一键搭起 OpenClaw AI Gateway，并通过原生 UI 管理启动、日志、Provider 配置，甚至 SSH 远程连接。
这项目解决了什么问题？
OpenClaw 本身是一个 AI Gateway/代理网关：你可以把多个大模型 Provider（Anthropic / OpenAI / Gemini / OpenRouter / NVIDIA NIM / DeepSeek / xAI 等）统一接入，用统一的方式管理模型、路由、工具调用与仪表盘。
但在 Android 上“把这一套跑起来”，通常会卡在：
- 环境复杂：Linux 用户态、Node.js、依赖与权限管理
- 操作分散：Termux、浏览器、日志、配置来回切
- 常驻困难：后台容易被系统杀掉
openclaw-termux 的思路是：
在 Android 上用 proot-distro 拉起 Ubuntu 用户态环境，再装 Node.js 22 + OpenClaw；同时用一个 Flutter 原生 App 把“安装/配置/启动/查看仪表盘/看日志/设备能力”都集成在一个地方。
两种形态：App vs Termux CLI
1）Flutter App（Standalone）
适合：想“点一点就跑起来”、需要可视化仪表盘与日志的人。
它提供：
- 一键 Setup：自动下载 Ubuntu rootfs、安装 Node.js 22、安装 OpenClaw
- 网关控制：Start/Stop、状态指示、健康检查
- 内置终端：带额外按键工具栏、复制粘贴、可点击 URL
- 内置 Web Dashboard（WebView）：直接加载
localhost:18789的 OpenClaw 仪表盘（并支持 token URL 展示/复制） - Provider 配置与 onboarding：在 App 内完成 API Key 与模型选择
- 实时日志：支持搜索/过滤
- 后台保活：Foreground Service + 运行时间追踪 + Setup 进度通知
2）Termux CLI（npm 包）
适合：只要命令行、想写脚本、或者更偏“服务器式管理”的人。
安装后主要命令是 openclawx，比如：
openclawx setup：首次安装（proot + Ubuntu + Node + OpenClaw）openclawx start：启动 gatewayopenclawx onboarding：配置 Provider/API keysopenclawx shell：进入 Ubuntu 环境openclawx status/openclawx doctor：检查状态与诊断
注意：Termux 建议从 F-Droid 安装，而不是 Play Store 版本。
亮点功能：Android 设备能力“变成工具”
这项目不只是“把 Gateway 跑起来”，它还把 Flutter App 当作一个 node（节点） 连接到网关，通过 WebSocket node protocol 暴露设备能力给 AI 使用。
文档里列的能力包括（部分需权限）：
- Camera：拍照/录视频/列出摄像头
- Flash：手电筒开关/状态
- Location：定位
- Screen：录屏（需要 MediaProjection 授权）
- Sensor：传感器读取（需要 Body Sensors 权限）
- Haptic：震动反馈
并且项目会在启动前自动 patch openclaw.json，放开对应的 allowCommands（文档提到共 15 个命令）。
这意味着你可以把 Android 变成一个“随身 AI 设备节点”：AI 不只是聊天，还能在你的授权范围内调用手机能力完成任务。
安装与上手（按项目 README 的主流程）
Flutter App 流程（推荐）
- 从 Releases 下载 APK 并安装（或自行
flutter build apk --release构建） - 打开 App → 点 Begin Setup
- Setup 完成后在 App 内做 Onboarding（配置 API Keys、绑定地址等）
- 点 Start Gateway
- 打开内置 Dashboard（或浏览器访问
http://localhost:18789/ token URL）
Termux CLI 流程
npm install -g openclaw-termuxopenclawx setupopenclawx onboardingopenclawx start
架构一图看懂（项目自带的架构思路）
从上到下大概是：
- Flutter App：终端 + 网关控制 + WebView Dashboard
- Native Bridge（Kotlin）：负责和 Android 权限/能力打交道
- Node Provider（WebSocket）：把 Camera/Location/Screen 等能力以命令形式暴露给网关
- proot-distro + Ubuntu：用户态 Linux 环境
- Node.js 22 + OpenClaw Gateway：最终跑在 Ubuntu 里，Dashboard 默认
localhost:18789
这种架构的好处是：不 root，并且 UI/权限/日志体验比纯 Termux 顺滑很多。
注意事项与坑位（很关键）
- 电池优化：README 强调要关闭电池优化，否则后台网关很容易被系统杀掉（App 和 Termux 都要注意）
- 存储空间：需要大约 ~500MB（Ubuntu + Node + OpenClaw）
- 绑定地址：非 root 设备建议用 Loopback（127.0.0.1）做绑定更安全
- Bionic Bypass：项目包含对 Android Bionic libc 下
os.networkInterfaces()崩溃问题的绕过（这类兼容性处理正是这个项目的价值之一） - Termux 来源：CLI 形态建议使用 F-Droid 的 Termux
适合谁？
- 想把 OpenClaw 随身带着走：在手机上跑一个完整的 AI Gateway
- 想做“移动端 AI 工具箱”：让 AI 在授权下使用摄像头、定位、录屏、传感器等
- 不想 root、但又想要接近“Linux 环境”的开发/自动化能力
- 想用一个 App 管理多模型 Provider、网关状态、日志与仪表盘
结语
openclaw-termux 把原本偏“桌面/服务器”的 OpenClaw Gateway，成功搬到了 Android，并且用 Flutter 把关键的运维体验（安装、配置、启动、日志、仪表盘、权限）做成了一套完整产品。
对于想把 AI agent 从电脑扩展到手机的人来说，这是一个非常实用的桥梁项目。
