openclaw-termux：在 Android 上部署 OpenClaw AI Gateway

注意：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 流程（推荐）

1. 从 Releases 下载 APK 并安装（或自行 flutter build apk --release 构建）
2. 打开 App → 点 Begin Setup
3. Setup 完成后在 App 内做 Onboarding（配置 API Keys、绑定地址等）
4. 点 Start Gateway
5. 打开内置 Dashboard（或浏览器访问 http://localhost:18789 / token URL）

Termux CLI 流程

1. npm install -g openclaw-termux
   

2. openclawx setup
   

3. openclawx onboarding
   

4. openclawx 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 从电脑扩展到手机的人来说，这是一个非常实用的桥梁项目。