安卓手机使用 Termux 部署 AstrBot 与 NapCat QQ 机器人

安卓手机使用 Termux 部署 AstrBot 与 NapCat QQ 机器人

简介

本方案旨在利用旧款安卓设备，通过 Termux 模拟 Linux 环境，部署 AstrBot 聊天机器人框架及 NapCat 协议端，实现 QQ 账号接入大模型对话功能。

核心组件

Termux: Android 终端模拟器，提供 Linux 环境，无需 Root 权限即可运行开发工具。

AstrBot: 开源一站式 Agentic 聊天机器人平台，支持多模态、大模型接入及多消息平台适配。

NapCat: 基于 TypeScript 的 Bot 框架，通过 OneBot 协议规范调用 QQ 接口，支持 HTTP/WebSocket 通信。

环境准备

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。

2. 权限申请

执行以下命令授权文件读写权限，弹窗时务必允许：

termux-setup-storage

正式部署

1. 构建 Ubuntu 环境

使用 proot-distro 安装轻量级 Linux 发行版。

pkg install uv git proot-distro
proot-distro install ubuntu

登录环境：

proot-distro login ubuntu

2. 配置 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

若下载包速度慢，可设置清华源：

export UV_DEFAULT_INDEX="https://pypi.tuna.tsinghua.edu.cn/simple"

启动成功后，WebUI 将显示访问地址（默认 localhost:6185），用户名密码均为 astrbot。