基于 Termux 的 QQ 机器人部署指南
在安卓设备上运行本地机器人服务，既能节省服务器成本，也能锻炼 Linux 环境下的运维能力。本方案利用 Termux 模拟 Linux 环境，结合 AstrBot 大模型框架与 NapCat 客户端，实现非官方的 QQ 个人机器人部署。
核心工具简介
Termux
Termux 是 Android 上的开源终端模拟器，提供类 Linux 环境。无需 Root 权限即可使用包管理器安装开发工具（如 Python、Git、Node.js 等）。建议从 F-Droid 下载最新版本，Google Play 版本更新较慢。
AstrBot
AstrBot 是一站式 Agentic 聊天机器人平台，支持接入多种大语言模型及消息平台（QQ、微信、飞书等）。它具备 WebUI 可视化配置、插件扩展及代码沙箱执行能力。
NapCat
NapCat 是基于 TypeScript 构建的 Bot 框架，通过 OneBot 协议规范对接 QQ 接口。它支持 HTTP/WebSocket 请求，能处理消息收发、图片语音解析等功能。
环境准备
1. 安装与初始化
从 F-Droid 获取 Termux 应用。打开后执行以下命令更新源并安装基础依赖：
pkg update && pkg upgrade
pkg install python git wget curl proot-distro uv
换源提示：国内用户可运行 termux-change-repo，选择镜像组中中国大陆节点以提升下载速度。
2. 存储权限
执行 termux-setup-storage 授权文件访问，后续部署需要读写权限。
正式部署流程
1. 构建 Ubuntu 子系统
由于 AstrBot 依赖较新的 Python 环境，直接在 Termux 原生环境中可能受限。建议使用 proot-distro 安装 Ubuntu。
proot-distro install ubuntu
proot-distro login ubuntu
进入 Ubuntu 后，需添加第三方 PPA 以获取 Python 3.10（uv 要求版本）：
apt update && apt install software-properties-common
add-apt-repository ppa:deadsnakes/ppa && apt update
apt install python3.10
2. 部署 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 将显示在 localhost:6185。默认账号密码均为 astrbot。如需后台运行，可使用 & 符号或 screen 命令管理会话。
注意：Termux 与主机共享网络，访问 WebUI 时可直接使用
localhost或手机 IP。
