环境准备
在旧款安卓手机上运行本地机器人，核心在于利用 Termux 模拟 Linux 环境。AstrBot 提供大模型对话及多平台接入能力，NapCat 则负责处理 QQ 协议连接。以下流程基于非 Root 环境，通过 proot-distro 构建 Ubuntu 子系统。
1. 安装与初始化
从 F-Droid 下载 Termux（Google Play 版本更新较慢）。打开应用后执行基础更新：
pkg update && pkg upgrade
pkg install python git wget curl
建议更换软件源以提升下载速度，选择中国大陆镜像组即可：
termux-change-repo
# 依次选择 Mirror group Rotate between several mirrors -> Mirrors in Chinese Mainland All in Chinese Mainland
申请存储权限以允许读写文件：
termux-setup-storage
2. 构建 Ubuntu 环境
Termux 本身资源有限，使用 proot-distro 安装 Ubuntu 可获取更完整的开发工具链。
安装组件
pkg install uv git proot-distro
安装并登录 Ubuntu
由于国内访问 GitHub 可能受限，请确保网络代理已配置。安装 Ubuntu 子系统：
proot-distro install ubuntu
登录进入系统：
proot-distro login ubuntu
此时提示符变为 root@ubuntu，说明已进入 Ubuntu 环境。
配置 Python 环境
AstrBot 依赖 Python 3.10，而 Ubuntu 默认源中通常只有 3.8 或 3.9，需添加 deadsnakes PPA：
apt update && apt install software-properties-common
add-apt-repository ppa:deadsnakes/ppa && apt update
apt install python3.10
3. 部署 AstrBot
克隆官方仓库并初始化项目。注意确保当前路径为根目录，避免后续命令失效：
git clone https://github.com/AstrBotDevs/AstrBot.git && cd AstrBot
启动服务：
uv run main.py
若 uv 下载包速度慢，可临时切换清华源：
export UV_DEFAULT_INDEX="https://pypi.tuna.tsinghua.edu.cn/simple"
启动成功后，终端会输出 WebUI 访问地址（如 http://localhost:6185）。默认账号密码均为 astrbot。如需退出当前会话，输入 exit。
后台运行技巧：
Termux 关闭后进程通常会终止。若需保持服务在线，可在设置中允许 Termux 后台活动，或使用 screen 管理会话：
