基于 Termux 的 QQ 机器人本地化部署方案
在资源受限的移动设备上运行聊天机器人，Termux 配合 AstrBot 框架和 NapCat 协议端是一个轻量且可行的方案。本文介绍如何在非 Root 的安卓手机上搭建环境，实现 QQ 机器人的本地化运行。
核心组件简介
- Termux：Android 上的开源终端模拟器，提供 Linux 环境，无需 Root 即可安装开发工具。
- AstrBot：一站式 Agentic 聊天机器人平台，支持接入大模型及多种消息平台（如 QQ），具备 WebUI 管理界面。
- NapCat：基于 TypeScript 的 Bot 框架，通过 OneBot 协议将 QQ 客户端接口标准化，方便 AstrBot 调用。
环境准备
1. 安装 Termux
建议从 F-Droid 下载 Termux，Google Play 版本更新可能滞后。部分国内应用商店也可找到，但需确认版本较新。
2. 更新源与基础工具
打开 Termux，执行以下命令更新软件源并安装 Python、Git 等依赖：
pkg update && pkg upgrade && pkg install python git wget curl
如需提升下载速度，可运行 termux-change-repo，选择镜像组后切换至中国大陆节点。
3. 申请存储权限
执行 termux-setup-storage，允许弹窗中的文件访问权限，这是后续操作的基础。
正式部署
1. 安装 Proot 与 Ubuntu 环境
由于 AstrBot 依赖 Python 3.10+ 及特定库，直接在 Termux 原生环境中配置较繁琐，建议使用 proot-distro 模拟 Ubuntu。
首先安装必要组件：
pkg install uv git proot-distro
接着安装 Ubuntu 系统（国内网络可能需要代理）：
proot-distro install ubuntu
登录 Ubuntu 环境：
proot-distro login ubuntu
2. 配置 Python 环境
Ubuntu 官方源默认 Python 版本可能较低，而 AstrBot 需要 3.10 版本。需添加 deadsnakes PPA：
apt update && apt install software-properties-common
add-apt-repository ppa:deadsnakes/ppa && apt update
apt install python3.10
3. 克隆并运行 AstrBot
确保当前路径为根目录或项目预期位置，避免 cd 错误：
git clone https://github.com/AstrBotDevs/AstrBot.git && cd AstrBot
若遇到 git clone 失败，请检查网络连接或代理设置。成功后进入项目目录启动服务：
uv run main.py
如果下载包速度慢，可临时更换 PyPI 源：
export UV_DEFAULT_INDEX="https://pypi.tuna.tsinghua.edu.cn/simple"
