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

启动 AstrBot：

uv run main.py

如果下载速度较慢，可设置清华源加速：

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

启动成功后，WebUI 将自动开启，默认地址通常为 http://localhost:6185。默认账号密码均为 astrbot。

注意：Termux 与主机共享网络，访问 WebUI 时可直接使用 localhost 或主机 IP。

如需后台运行，可使用 & 符号或 screen 命令管理会话，防止终端关闭后进程中断。

部署 NapCat

NapCat 是连接 QQ 的协议端，支持多种部署方式。在 Termux 环境下推荐使用一键脚本。

Termux 部署

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

部署完成后，查看日志获取 WebUI 链接和登录二维码：

# 示例日志查看命令，具体视脚本输出而定
docker logs napcat 

若使用 Docker 部署，需注意语音和文件数据可能无法接收，仅支持文本和图片消息。

连接到 AstrBot

1. 配置 AstrBot 适配器

进入 AstrBot WebUI 管理面板：

1. 点击左侧栏 消息平台。
2. 点击 + 新增适配器。
3. 选择 aiocqhttp(OneBotv11)。

填写配置项：

• ID：随意填写，用于区分实例。
• 启用：勾选。
• 反向 WebSocket 主机地址：0.0.0.0。
• 反向 WebSocket 端口：例如 6199。

保存后进入 其他配置，在 管理员 ID 处填入你的 QQ 号（非机器人号），再次保存。

2. 配置 NapCat 客户端

切换回 NapCat 管理面板：

1. 点击 网络配置 -> 新建 -> WebSockets 客户端。
2. 勾选 启用。
3. URL 填写：ws://宿主机 IP:端口/ws（如 ws://127.0.0.1:6199/ws）。注意末尾必须带 /ws。
4. 消息格式：Array。
5. 心跳间隔：5000。
6. 重连间隔：5000。

保存后，前往 AstrBot WebUI 控制台查看日志。若显示 aiocqhttp(OneBot v11) 适配器已连接，说明连接成功。

此时可通过 QQ 私聊发送 /help 测试机器人功能。

常见问题

• Git Clone 失败：检查网络连接，建议使用加速器或代理。若失败，可先删除残留目录再重试：

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

• 后台存活：在系统设置中将 Termux 设为手动管理，允许后台活动，防止被杀进程。
• 大模型性能：受限于手机硬件，本地运行大模型可能较吃力，建议优先使用云端 API。

参考资料

• AstrBot 文档
• NapCat 安装指南