OpenClaw-Termux 项目介绍把OpenClaw搬到 Android 手机上如果你希望在手机上直接运行一个可控的 AI 编码网关而不是只使用“聊天式助手”mithun50/openclaw-termux是一个值得关注的开源项目。它提供了两种形态独立 Flutter Android App推荐Termux CLI 包openclawx核心目标很明确在 Android 上通过proot拉起 Ubuntu 环境装好 Node.js 和 OpenClaw Gateway并提供可用的控制界面与命令行入口。一、项目概览截至 2026-03-03仓库mithun50/openclaw-termuxLicenseMITGitHub Stars314Forks53最新版本v1.8.1发布时间2026-03-01最近一次代码推送2026-03-02项目的 README 给出的定位是在 Android 上运行 OpenClaw AI Gateway带内置终端、Web Dashboard以及一键安装流程。二、这个项目解决了什么问题在移动端做 AI 工程实验通常会遇到三个问题环境搭建重Termux Ubuntu Node.js 工具链手工操作多。过程不稳定Android 后台策略、权限和网络兼容经常导致服务掉线。可观测性差只在命令行里跑状态、日志、配置入口分散。openclaw-termux的价值是把这些环节打包成一个“可运行、可管理、可恢复”的工作流。三、核心能力拆解1) 双入口App 与 CLI 并存README 中给出的对照关系很清晰App 端点击Begin Setup/Start GatewayCLI 端执行openclawx setup/openclawx start对于偏工程化用户CLI 便于脚本化对于普通用户App 端更适合快速上手。2) 一键初始化 Android 上的 Ubuntu Node.js 22项目会自动安装proot-distro Ubuntu rootfsNode.js 22OpenClaw 运行环境这一步是大部分“手机端开发环境”最容易劝退新手的地方项目把它做成了向导化流程。3) 网关管理 仪表盘项目提供了完整的网关生命周期管理启停控制与状态检测日志查看搜索/过滤Web Dashboard默认localhost:18789在 App 里还能直接携带 token 打开 Dashboard减少手工拷贝步骤。4) AI Provider 配置内置化根据 README 与 Changelog当前支持 7 个 ProviderAnthropicOpenAIGoogle GeminiOpenRouterNVIDIA NIMDeepSeekxAI这部分能力在v1.8.0版本中被重点增强Provider 配置与模型选择界面。5) Android 设备能力映射为 Node 能力这是项目和普通“终端壳子”相比最有辨识度的点Camera / Flash / Location / Screen / Sensor / Haptic / Canvas共 15 条命令通过 WebSocket 暴露给网关如果你在做“手机端感知 AI Agent”实验这一层很实用。四、5 分钟上手路径路径 AFlutter App推荐# 1) 从 Releases 下载 APK# 2) 安装后打开 App# 3) 点击 Begin Setup# 4) 完成后在 Onboarding 配置 API Key# 5) 回到 Dashboard 启动网关路径 BTermux CLI# 一键安装脚本推荐curl-fsSLhttps://raw.githubusercontent.com/mithun50/openclaw-termux/main/install.sh|bash# 或 npm 安装npminstall-gopenclaw-termux openclawx setup openclawx onboarding openclawx start常用命令openclawx status openclawx shell openclawx doctor openclawx gateway--verbose五、架构上有什么工程亮点从 README 的架构图可以看到项目分为三层Flutter UI 层终端、设置、仪表盘、日志、Provider 管理Android 原生桥接层权限、前台服务、系统能力Ubuntu/Node/OpenClaw 运行层真正的网关执行环境这种分层把“交互体验”和“实际执行环境”解耦了便于后续独立演进。六、使用时要注意的三个坑1) 后台保活Android 的电池优化会导致进程被杀。README 明确建议将 App/Termux 设为 Unrestricted。2)os.networkInterfaces相关报错项目通过 Bionic Bypass 解决该兼容问题如果报错优先重新执行openclawx setup。3) 非 root 设备绑定方式Onboarding 时建议选择Loopback (127.0.0.1)避免在移动端暴露不必要的监听地址。七、近期迭代观察从 Changelog 和最新 Release 看项目最近几版迭代重点非常明确稳定性DNS 修复、后台重连、生命周期恢复可用性配置快照导入导出、URL 可点击、安装流程修复能力扩展AI Providers、SSH Access、Node 能力增强对开源项目而言这类“持续修 bug 逐步补能力”的节奏比一次性堆功能更有参考价值。八、适合谁不适合谁适合希望在 Android 上做 AI Agent / Gateway 实验的开发者需要随身可运行的轻量开发调试环境想把手机硬件能力接入 AI 工作流的工程用户不太适合只想开箱即用、完全不碰命令行与网络配置的用户对本地存储和后台资源占用非常敏感的设备环境结语openclaw-termux的价值不在“把所有事情都自动化”而在于提供了一条在 Android 上可落地、可调试、可持续维护的 AI Gateway 路径。如果你关注的是“移动端可执行 AI 工程环境”而不是“移动端 AI 聊天界面”这个项目值得直接跑一遍。参考链接GitHub 仓库https://github.com/mithun50/openclaw-termuxREADMEhttps://github.com/mithun50/openclaw-termux/blob/main/README.mdChangeloghttps://github.com/mithun50/openclaw-termux/blob/main/CHANGELOG.mdReleaseshttps://github.com/mithun50/openclaw-termux/releases