# termux-app

**Repository Path**: OpenclawCN/termux-app

## Basic Information

- **Project Name**: termux-app
- **Description**: Termux is an Android terminal application and Linux environment.
Termux 是一款安卓终端应用和 Linux 环境。
将Openclaw安装到手机必备神器！
Latest version is v0.118.3.
最新版本是 v0.118.3。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-02-11
- **Last Updated**: 2026-03-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# termux-app

#### 介绍
Termux is an Android terminal application and Linux environment.
Termux 是一款安卓终端应用和 Linux 环境。
将Openclaw安装到手机必备神器！
Latest version is v0.118.3.
最新版本是 v0.118.3。

#### 软件架构
软件架构说明


#### 安装教程

这是一个为您整理的**《OpenClaw 安卓手机端完整安装部署指南》**。

这份文档汇总了我们刚才解决的所有问题（包括 F-Droid 版本选择、环境配置、以及核心的 /tmp 路径报错修复），您可以直接复制保存。

OpenClaw 安卓版安装部署指南 (Termux 版)

适用设备： Android 手机/平板（建议 Android 12+，运存 8G+） 核心工具： Termux (必须来自 F-Droid) 最后更新时间： 2026年2月11日

#### 使用说明

第一阶段：准备工作 (必读)
警告： 请勿使用 Google Play 商店版本的 Termux，因其停止更新会导致 OpenClaw 无法运行。

下载 Termux：

访问 F-Droid 官网或 GitHub Release 页面。

下载并安装 Termux 应用。

下载 API 插件 (可选但推荐)：

同样在 F-Droid 搜索并安装 Termux:API（用于赋予 AI 控制手机剪贴板、震动等权限）。

系统设置：

安装后，请在手机设置中找到 Termux，将“电池优化”设置为 “无限制” (Unrestricted)，防止后台被杀。

第二阶段：基础环境构建
打开 Termux，依次复制并运行以下命令（每行运行完毕后再输下一行）：

1. 更新软件源
确保下载的是最新组件。

Bash
pkg update -y && pkg upgrade -y
2. 安装核心依赖
OpenClaw 基于 Node.js 运行，且需要编译环境。

Bash
pkg install nodejs-lts python git build-essential termux-api -y
(注意：此过程取决于网速，可能需要 3-5 分钟)

第三阶段：修复安卓路径 BUG (关键)
问题说明： OpenClaw 默认向 /tmp 写入数据，但安卓没有这个系统目录，会导致 ENOENT 错误。 解决方案： 建立 Termux 专用临时目录并重定向变量。

1. 创建临时目录
Bash
mkdir -p $PREFIX/tmp
2. 写入配置文件 (永久生效)
将修正后的路径写入启动脚本，这样下次重启 Termux 依然有效。

Bash
echo "export TMPDIR=$PREFIX/tmp" >> ~/.bashrc
3. 立即刷新环境
让刚才的修改立刻生效。

Bash
source ~/.bashrc

第四阶段：安装与启动 OpenClaw
1. 下载并安装 OpenClaw
使用 npm 拉取最新版。

Bash
npm install -g openclaw@latest
(提示：安装结束后如果出现 run npm fund for details，请直接忽略，这代表安装成功。)

2. 启动初始化
运行以下命令进入配置向导：

Bash
openclaw onboard

#### 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request


第五阶段：常见问题自救 (Q&A)
Q1: 运行 openclaw onboard 后卡住不动或报错？

原因： 可能是网络连接至 npm 官方源超时。

解决： 切换淘宝/腾讯镜像源后再试：

Bash
npm config set registry https://registry.npmmirror.com
npm install -g openclaw@latest
Q2: 提示 EACCES: permission denied？

原因： OpenClaw 试图读取手机存储（如相册）但没有权限。

解决： 运行以下命令并允许弹窗权限：

Bash
termux-setup-storage
Q3: 手机发热严重/耗电快？

原因： OpenClaw 在本地进行逻辑运算。

建议： 在 onboard 配置过程中，如果询问模型 (Model)，尽量选择 Cloud API (如 OpenAI/Claude)，不要选 Local LLM (本地模型)，否则手机 CPU 会满载。

现在，您可以对照此文档进行操作。如果到了最后一步成功出现了欢迎界面，恭喜您，您的手机已经拥有了一个开源 AI Agent！

1.  使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
2.  Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
3.  你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
4.  [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
5.  Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
6.  Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)