openclaw-termux：把 OpenClaw AI Gateway 装进 Android（带 App、终端和仪表盘）

优质文章学习记录

— 5 min read
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

前端防范 XSS（跨站脚本攻击）

目录 一、防范措施 1.layui util  核心转义的特殊字符 示例 2.js-xss.js库 安装 1. Node.js 环境（npm/yarn） 2. 浏览器环境 核心 API 基础使用 1. 基础过滤（默认规则） 2. 自定义过滤规则 （1）允许特定标签 （2）允许特定属性 （3）自定义标签处理 （4）自定义属性处理 （5）转义特定字符 常见场景示例 1. 过滤用户输入的评论内容 2. 允许特定富文本标签（如富文本编辑器内容） 注意事项 更多配置 XSS（跨站脚本攻击）是一种常见的网络攻击手段，它允许攻击者将恶意脚本注入到其他用户的浏览器中。
详细教程：如何从前端查看调用接口、传参及返回结果（附带图片案例）

详细教程：如何从前端查看调用接口、传参及返回结果（附带图片案例）

目录 1. 打开浏览器开发者工具 2. 使用 Network 面板 3. 查看具体的API请求 a. Headers b. Payload c. Response d. Preview e. Timing 4. 实际操作步骤 5. 常见问题及解决方法 a. 无法看到API请求 b. 请求失败 c. 跨域问题（CORS） 作为一名后端工程师，理解前端如何调用接口、传递参数以及接收返回值是非常重要的。下面将详细介绍如何通过浏览器开发者工具（F12）查看和分析这些信息，并附带图片案例帮助你更好地理解。 1. 打开浏览器开发者工具 按下 F12 或右键点击页面选择“检查”可以打开浏览器的开发者工具。常用的浏览器如Chrome、Firefox等都内置了开发者工具。下面是我选择我的一篇文章，打开开发者工具进行演示。 2. 使用

Cursor+Codex隐藏技巧：用截图秒修前端Bug的保姆级教程（React/Chakra UI案例）

Cursor+Codex隐藏技巧：用截图秒修前端Bug的保姆级教程（React/Chakra UI案例） 前端开发中最令人头疼的莫过于那些难以定位的UI问题——元素错位、样式冲突、响应式失效...传统调试方式往往需要反复修改代码、刷新页面、检查元素。现在，通过Cursor编辑器集成的Codex功能，你可以直接用截图交互快速定位和修复这些问题。本文将带你从零开始，掌握这套革命性的调试工作流。 1. 环境准备与基础配置 在开始之前，确保你已经具备以下环境： * Cursor编辑器最新版（v2.5+） * Node.js 18.x及以上版本 * React 18项目（本文以Chakra UI 2.x为例） 首先在Cursor中安装Codex插件： 1. 点击左侧扩展图标 2. 搜索"Codex"并安装 3. 登录你的OpenAI账户（需要ChatGPT Plus订阅） 关键配置项： // 在项目根目录创建.