简介
Termux
Termux 是一款运行于 Android 系统的开源终端模拟器,提供 Linux 环境,无需 root 权限即可使用包管理器安装开发工具。
AstrBot
一站式 Agentic 聊天机器人平台,支持接入多种大模型服务及多消息平台(如 QQ、微信等)。
NapCat
基于 TypeScript 构建的 Bot 框架,通过 OneBot 协议实现 QQ 客户端接口调用。
环境准备
安装 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
正式部署
安装 Ubuntu 环境
安装必要组件:
pkg install uv git proot-distro
安装 Ubuntu 并登录:
proot-distro install ubuntu
proot-distro login ubuntu
配置 Python 环境
由于 uv 需要 Python 3.10,需添加 PPA 源:
apt update && apt install software-properties-common
add-apt-repository ppa:deadsnakes/ppa && apt update
apt install python3.10
部署 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)。如需后台运行,可使用 & 或 screen 命令管理进程。
部署 NapCat
在 Termux 中执行一键脚本:
curl -o napcat.termux.sh https://nclatest.znin.net/NapNeko/NapCat-Installer/main/script/install.termux.sh && bash napcat.termux.sh


