基于 Termux 在安卓手机部署 AstrBot QQ 机器人
简介
本教程旨在通过 Termux 环境，在 Android 设备上搭建一套支持大语言模型的 QQ 个人机器人。主要涉及三个核心组件：
- Termux：Android 终端模拟器，提供 Linux 环境，无需 Root 权限。
- AstrBot：开源一站式 Agentic 聊天机器人平台，支持多模态、工具调用及多种消息平台接入。
- NapCat：基于 TypeScript 的 Bot 框架，通过 OneBot 协议实现 QQ 客户端与机器人的连接。
环境准备
1. 安装 Termux
建议从 F-Droid 下载 Termux，Google Play 版本可能更新不及时。
2. 初始化环境
打开 Termux，执行以下命令更新源并安装基础工具：
pkg update && pkg upgrade
pkg install python git wget curl
如需优化下载速度，可运行 termux-change-repo 选择中国大陆镜像。
3. 申请存储权限
运行以下命令授权文件访问，弹窗时务必允许：
termux-setup-storage
正式部署
1. 安装 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 3.10，需添加 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
若下载包速度慢，可设置清华源：
export UV_DEFAULT_INDEX="https://pypi.tuna.tsinghua.edu.cn/simple"
启动成功后，WebUI 将显示在 localhost:6185。默认账号密码均为 astrbot。
