没有电脑？手机也能部署QQ机器人！AstrBot + NapCat 双方案教程

3.1 下载安装#

GitHub 仓库：https://github.com/zz6zz666/AstrBot-Android-App

• 有梯子的直接去 Release 页面下载最新 .apk
• 没梯子的去 123 云盘（仓库里有分享链接）

安装完成后，打开 App，允许通知权限（必须！否则后台会被杀）。

3.2 启动并登录QQ#

1. 打开 App，等待初始化（第一次会自动下载组件，大概几分钟）
2. 初始化完成后，会弹出 QQ登录二维码
3. 用你手机上的 QQ 扫码登录（建议用另一个设备扫，或者截图后用QQ识别）
4. 登录成功后，自动跳转到 AstrBot 控制台

3.3 配置大模型#

1. 进入 AstrBot 控制台（内置 WebView，不用额外开浏览器）
2. 左侧菜单 → “提供商”，添加你的大模型 API Key
3. 支持 OpenAI、DeepSeek、Gemini、Llama 等主流模型
4. 保存并启用

3.4 测试机器人#

用另一个 QQ 号给机器人发消息，比如 /help，如果机器人回复了，说明搞定！

方案A优缺点#

优点：

• 一键安装，零命令行
• 内置 NapCat，不用手动配置连接
• 有通知栏常驻，后台相对稳

缺点：

• 只能跑QQ，不支持微信/钉钉等其他平台
• 部分机型杀后台严重，需要手动保活
• 代码执行器功能不可用（依赖Docker环境）

4.1 安装 Termux#

下载 ZeroTermux（推荐，比原版Termux更好用）：

GitHub 仓库：https://github.com/hanxinhao000/ZeroTermux

或者直接装原版 Termux（F-Droid 或 GitHub 下载，Google Play 版已停止维护）。

4.2 安装 Linux 容器#

Termux 本身是个终端，但直接在里面跑 NapCat 会有各种问题。建议先装一个 proot-distro（Linux容器）：

1
# 更新软件源
2
pkg update && pkg upgrade -y
3

4
# 安装 proot-distro
5
pkg install proot-distro -y
6

7
# 安装 Debian 容器（推荐Debian 12）
8
proot-distro install debian
9

10
# 进入容器
11
proot-distro login debian

4.3 在容器里安装 AstrBot#

1
# 更新apt源
2
apt update && apt upgrade -y
3

4
# 安装必要工具
5
apt install git curl python3 python3-pip screen -y
6

7
# 安装 uv（Python包管理器，比pip快）
8
curl -LsSf https://astral.sh/uv/install.sh | sh
9

10
# 克隆 AstrBot
11
cd ~
12
git clone https://github.com/AstrBotDevs/AstrBot.git
13
cd AstrBot
14

15
# 安装依赖
16
uv sync
17

18
# 启动 AstrBot
19
uv run main.py

看到 WebUI 已启动，可访问 http://localhost:6185 就说明 AstrBot 跑起来了。

后台运行：

1
# 用 screen 挂后台
2
screen -S astrbot
3
uv run main.py
4
# 然后按 Ctrl+A 再按 D 分离会话

4.4 安装 NapCat#

在另一个终端会话里（或者新开一个 screen）：

1
# 安装 NapCat（官方一键脚本）
2
curl -o napcat.sh https://nclatest.znin.net/NapNeko/NapCat-Installer/main/script/install.sh
3
bash napcat.sh --docker n --cli y --force
4

5
# 启动 NapCat
6
napcat start 你的QQ号

启动后会显示二维码，扫码登录。

4.5 连接 AstrBot 和 NapCat#

1. 浏览器访问 http://localhost:6185，登录 AstrBot 控制台
2. 左侧菜单 → “机器人” → “创建机器人”
3. 平台选择 “QQ个人号”，启用反向 WebSocket
4. 端口默认 6199，Token 随便设一个（两边要一致）

然后访问 NapCat 的 WebUI：http://localhost:6099/webui

1. 用初始 Token 登录（查看命令：cat ~/Napcat/config/webui.json | grep token）
2. 左侧 → “网络配置” → “新建” → “WebSocket Client”
3. URL 填 ws://localhost:6199/ws
4. Token 填刚才 AstrBot 那边设的
5. 消息格式选 Array，心跳间隔 5000
6. 保存并启用

4.6 测试#

用另一个 QQ 给机器人发消息，如果两边日志都有显示，说明连接成功！

启动流程（Termux版）#

1
# 打开 ZeroTermux
2
# 进入容器
3
proot-distro login debian
4

5
# 启动 NapCat
6
napcat start 你的QQ号
7

8
# 新开一个会话启动 AstrBot
9
screen -S astrbot
10
cd ~/AstrBot && uv run main.py

保活设置（重要！）#

Termux/App 在安卓上很容易被系统杀后台，需要做以下设置：

1. 电池优化 → 把 Termux/App 设为 “不优化” 或 “无限制”
2. 自启动权限 → 开启允许自启动
3. 后台锁定 → 在多任务界面把 Termux 锁上（下滑或长按加锁）
4. 开发者选项 → 关闭 “后台进程限制”

不同手机品牌路径不同，自己搜一下「XX手机 应用保活教程」。