基于 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"


