openclaw-termux:把 OpenClaw AI Gateway 装进 Android(带 App、终端和仪表盘)

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:启动 gateway
  • openclawx onboarding:配置 Provider/API keys
  • openclawx 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 流程(推荐)

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

Read more

国产七大AI模型哪家强?DeepSeek、豆包、Kimi、智谱清言、通义千问深度解析!

国产七大AI模型哪家强?DeepSeek、豆包、Kimi、智谱清言、通义千问深度解析!

全球AI竞赛激烈,国内AI领域也进入白热化阶段。 Kimi、智谱清言、通义千问、文心一言、豆包、天工AI、讯飞星火这七款模型,在长文本处理、多模态交互、行业应用等赛道各展所能,竞争激烈。 下面,我们来详细梳理它们的优势与不足,帮你找到最适合的AI助手。 七款大模型实力盘点 1、 Kimi(月之暗面) 长处 处理长文档能力极为出色,能支持长达20万字的文本。面对长篇学术著作、复杂法律条文和冗长项目报告,它都能精准梳理,通过强大的上下文理解能力,把握整体逻辑与细节,在文献解析和知识推理方面实力超群。 * 学术研究人员借助Kimi,可快速梳理海量文献,提炼关键信息,助力论文撰写与研究思路搭建; * 法律从业者使用它,能在短时间内完成大量合同、法规的筛查,精准定位风险点。 不足 * 多模态功能有所欠缺,处理图片、音频等非文本信息时表现欠佳; * 实时信息更新不够及时,难以满足对信息及时性要求高的场景; * 在专业领域,术语库不够丰富,回答特定专业问题时精准度有待提高。 (图源:https://kimi.moonshot.

AI的提示词专栏:Instruction Tuning 与自定义指令集

AI的提示词专栏:Instruction Tuning 与自定义指令集

AI的提示词专栏:Instruction Tuning 与自定义指令集 本文围绕 Instruction Tuning(指令微调)与自定义指令集展开深入解析,先阐释 Instruction Tuning 的定义、与传统 Prompt 调优的区别及核心价值,指出其通过 “指令 - 响应” 对训练让模型从通用文本生成转向精准执行任务,解决传统 Prompt 调优痛点。接着详解自定义指令集的构成要素与设计原则,给出多领域示例。随后介绍 Instruction Tuning 从数据准备、模型选择、微调训练、效果评估到部署应用的完整实施流程,结合电商客服场景实战案例说明落地要点。还针对数据不足、过拟合等常见问题提供解决方案,最后总结核心内容并展望自动指令集生成等未来趋势,为相关实践提供全面指导。 人工智能专栏介绍     人工智能学习合集专栏是 AI 学习者的实用工具。它像一个全面的 AI 知识库,把提示词设计、AI 创作、智能绘图等多个细分领域的知识整合起来。无论你是刚接触

Qoder AI 编程全攻略:从安装到实战,小白也能轻松上手

Qoder AI 编程全攻略:从安装到实战,小白也能轻松上手

前言 还在觉得 AI 编程只是简单的代码补全?那你一定要试试Qoder!这款面向真实软件开发的 Agentic 编码平台,可不是普通的 AI 代码工具,它能深度理解你的整个代码库,把复杂的开发工作拆解开自动处理,不管是在 IDE 里无缝开发,还是在终端里高效操作,都能让你写代码的效率翻倍。 本文结合 Qoder 官方文档和实际使用经验,用最通俗的语言讲清 Qoder 的核心功能、安装步骤和实战用法,不管你是刚接触 AI 编程的新手,还是想提升开发效率的老程序员,都能轻松看懂、快速上手! 一、Qoder 是什么?核心亮点速览 Qoder(发音 /ˈkoʊdər/)是一款主打智能体驱动的 AI 编程平台,和普通的代码补全工具(比如 Copilot)相比,它的核心优势在于深度的项目上下文理解和自动化的复杂任务处理,简单说就是:它能 “读懂” 你的整个项目,

OpenClaw 接入 QQ Bot 完整指南:让你的 AI 助手入驻 QQ

OpenClaw 接入 QQ Bot 完整指南:让你的 AI 助手入驻 QQ TL;DR: OpenClaw 2026.3.31 正式支持 QQ Bot,可以接入 QQ 私聊、群聊,支持图片、语音、视频、文件等富媒体消息,还支持语音识别、日程提醒、Markdown 格式化等功能。 背景 QQ 是国内最主流的即时通讯工具之一,拥有大量技术社区用户。在此之前,OpenClaw 已经支持了钉钉、Slack、Telegram、飞书等渠道,这次更新终于把 QQ 也纳入了版图。 这次 QQ Bot 支持是由腾讯官方团队贡献的(@sliverp),直接对接 QQ