OpenClaw-Termux最新版

将你的安卓手机转化为一台功能完备的 OpenClaw AI 网关，现在有了更优雅的选择。OpenClaw-Termux 项目提供了两种截然不同的运行模式：一款功能强大的独立 Flutter 应用，以及一个轻量级的 Termux CLI 工具包。

无论你是否熟悉命令行，都能通过它轻松在手机上搭建基于 Ubuntu 的 AI 运行环境。更令人兴奋的是，它不仅能运行网关，还能作为物理节点，让 AI 直接调用手机的相机、传感器、闪光灯等硬件能力——全程无需 Root 权限。

核心架构：双模式选择

项目设计了两种使用路径，适配不同用户习惯：

模式一：Flutter 独立应用 —— 全能型 AI 控制台

这是为安卓用户量身打造的图形化解决方案。它自动处理所有复杂的底层配置，让你专注于 AI 交互。

核心功能亮点

• 一键自动化部署： 点击“开始设置”，应用自动下载 Ubuntu rootfs、Node.js 22 及 OpenClaw 核心，全程进度可视。
• 内置终端模拟器： 无需切换应用，直接在 App 内操作 Linux 命令。支持额外按键栏、快捷复制粘贴及链接点击。
• 智能网关管理： 实时状态指示灯、健康检查机制，一键启停网关服务。
• 实时日志监控： 内置日志查看器，支持关键词搜索与过滤，快速排查问题。
• 前台服务保活： 以后台服务形式运行网关，显示运行时长，防止系统杀进程。
• 凭证便捷管理： 自动捕获认证令牌，提供一键复制按钮，无缝对接网页仪表盘。

可选开发环境扩展

设置完成后，你可从应用内直接安装高级开发工具，将手机变为移动开发站：

这些工具的状态可在“设置向导”、“仪表盘快速操作”或“系统信息”中实时查看。

节点设备能力：让 AI 拥有“五感”

这是 OpenClaw-Termux 最独特的功能。Flutter 应用可作为**节点（Node）**连接到网关，通过 WebSocket 协议向 AI 暴露安卓硬件接口。当启用特定能力时，App 会自动请求相应权限。

安全机制： 启动前，系统会自动修补 openclaw.json 配置文件，清空拒绝列表 (denyCommands) 并明确允许上述 15 条硬件控制命令，确保 AI 能安全调用设备功能。

模式二：Termux CLI —— 极客的轻量选择

如果你习惯命令行，或已在 Termux 中构建了工作流，CLI 版本是完美补充。

技术特性

• Bionic 兼容性修复： 专门解决了安卓 Bionic libc 环境下 os.networkInterfaces() 崩溃的顽疾，确保网络功能稳定。
• 智能加载反馈： 在网关完全就绪前显示加载动画，避免盲目操作。
• 命令透传： 通过 openclawx 前缀可直接运行任何原生 OpenClaw 命令。
• 环境隔离： 自动配置 proot-distro 环境，不污染主机系统。

常用命令速查

# 1. 初始化环境 (安装 proot, Ubuntu, Node.js, OpenClaw)
openclawx setup

# 2. 检查运行状态
openclawx status

# 3. 启动 AI 网关
openclawx start

# 4. 进入 Ubuntu Shell 进行高级调试
openclawx shell

# 5. 运行诊断或详细模式
openclawx doctor
openclawx gateway --verbose

快速开始指南

方案 A：安装 Flutter 应用（推荐新手）

1. 下载： 访问 Releases 页面 下载对应架构的 APK（推荐 arm64-v8a）。
2. 安装： 在安卓设备上安装 APK。
3. 初始化： 打开应用，点击 “开始设置”（需下载约 500MB 数据）。
4. 配置： 在向导中输入你的 LLM API 密钥。
5. 运行： 点击 “启动网关”，即可在内置 WebView 中访问仪表盘。

进阶用户可从源码构建：

git clone https://github.com/mithun50/openclaw-termux.git
cd openclaw-termux/flutter_app
flutter build apk --release

方案 B：安装 Termux CLI

方法 1：一键脚本（最快）

curl -fsSL https://raw.githubusercontent.com/mithun50/openclaw-termux/main/install.sh | bash

方法 2：NPM 安装

npm install -g openclaw-termux
openclawx setup

系统要求与下载

硬件与系统门槛

APK 下载选择指南