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

add-apt-repository ppa:deadsnakes/ppa && apt update

按回车确认继续。

安装 Python 3.10：

apt install python3.10

3. 克隆并运行 AstrBot

确保当前路径为根目录或项目目录，防止找不到文件：

git clone https://github.com/AstrBotDevs/AstrBot.git && cd AstrBot

启动 AstrBot：

uv run main.py

若下载速度较慢，可切换 PyPI 源（以清华源为例）：

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

启动成功后，控制台会显示 WebUI 访问地址（如 http://localhost:6185）。默认用户名和密码均为 astrbot。

提示：Termux 与主机共享网络，访问 localhost 即访问本机。如需查看 IP，可使用 ifconfig。

4. 后台运行与持久化

重启 Termux 后需重新进入 Ubuntu 并启动服务。为避免每次手动输入，可组合命令：

proot-distro login ubuntu && cd AstrBot && uv run main.py

若需后台运行多个进程（如同时运行 NapCat），可使用 & 符号或 screen。

使用 screen 管理会话（推荐）：

apt install screen
screen -S astrbot_session
# 运行 uv run main.py
# 退出会话 Ctrl + a + d
# 重新连接 screen -r astrbot_session

此外，需在系统设置中允许 Termux 后台活动，防止被系统杀进程。

部署 NapCat 并连接

1. 安装 NapCat (Termux 版)

在 Termux 主界面（非 Ubuntu 内）执行以下脚本：

curl -o napcat.termux.sh https://nclatest.znin.net/NapNeko/NapCat-Installer/main/script/install.termux.sh && bash napcat.termux.sh

2. 配置 AstrBot 适配器

1. 打开 AstrBot WebUI 管理面板。
2. 点击左侧栏 消息平台 -> + 新增适配器。
3. 选择 aiocqhttp(OneBotv11)。
4. 填写配置项：
   • ID：自定义名称。
   • 启用：勾选。
   • 反向 WebSocket 主机地址：0.0.0.0。
   • 反向 WebSocket 端口：例如 6199。
5. 保存配置。

在 其他配置 中设置管理员 QQ 号，保存后 AstrBot 会自动重启。

3. 配置 NapCat 客户端

1. 打开 NapCat 管理面板（日志中通常包含 URL）。
2. 进入 网络配置 -> 新建 -> WebSockets 客户端。
3. 填写信息：
   • 启用：勾选。
   • URL：ws://宿主机IP:端口/ws（如 ws://127.0.0.1:6199/ws，注意末尾加 /ws）。
   • 消息格式：Array。
   • 心跳间隔：5000。
   • 重连间隔：5000。
4. 保存。

4. 验证连接

返回 AstrBot WebUI 控制台，若看到 aiocqhttp(OneBot v11) 适配器已连接 的蓝色日志，说明连接成功。使用 QQ 私聊发送 /help 检查机器人响应。

常见问题与注意事项

• Git Clone 失败：若遇到网络问题导致仓库克隆失败，请检查代理设置。可先删除残留目录再重试：

  rm -r AstrBot
  git clone https://github.com/AstrBotDevs/AstrBot.git && cd AstrBot
  

• 大模型性能：本地安卓设备运行大模型推理资源消耗较大，建议仅用于轻量级对话或配合云端 API 使用。
• 语音与文件：Docker 部署模式下可能无法接收语音和文件数据，Termux 原生部署通常能更好支持。
• 风控风险：请勿高频发送消息，避免触发 QQ 风控机制。

参考资料

• AstrBot 官方文档
• NapCat 安装指南