工具简介
本次方案基于 Termux、AstrBot 和 NapCat 构建。Termux 是 Android 上的开源终端模拟器,提供 Linux 环境;AstrBot 是一站式聊天机器人平台及开发框架,支持大模型接入;NapCat 则是基于 TypeScript 的 Bot 框架,通过 OneBot 协议实现 QQ 端接入。
部署步骤
1. 准备 Termux 环境
从 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 内模拟一个完整的 Linux 环境来运行 AstrBot。
安装组件
pkg install uv git proot-distro
安装 Ubuntu
中国大陆访问 GitHub 可能受限,建议使用代理。
proot-distro install ubuntu
登录进入 Ubuntu 环境:
proot-distro login ubuntu
配置 Python 环境
AstrBot 依赖 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
若 uv 下载速度慢,可设置清华源:
export UV_DEFAULT_INDEX="https://pypi.tuna.tsinghua.edu.cn/simple"
启动成功后,WebUI 将显示在本地端口(默认 6185)。默认账号密码均为 astrbot。
后台运行与维护:
如需后台运行,可使用 & 符号或 screen 命令。


