AstrBot泡泡版v0.1.0-beta5.5 安卓官方版

编辑点评：手机一键部署QQAI机器人，无需电脑服务器接入各类大模型

AstrBot泡泡版是轻量化安卓QQAI机器人应用，专门解决传统机器人需要电脑、复杂代码部署的难题，基于成熟AstrBot开源框架打造，整合NapCatQQ适配协议，在手机容器内完整运行机器人服务，支持个人QQ私聊智能应答、群聊多人互动，可自由接入市面上主流大语言模型，海量社区插件一键安装拓展群管理、问答、生成等功能，全程可视化操作，不用专业技术知识，普通用户安装完成后简单配置就能拥有专属AIQQ机器人。

登录及配置流程

1、允许通知权限

启动后 App 会请求通知权限，必须点击“允许”。

若拒绝，机器人将无法在后台持续运行。

2、添加NapCat账号

可指定监听端口，可留空自动分配

启动账号，等待二维码弹出

3、扫码登录QQ账号

使用你手机上的 QQ 扫码登录。

体验优化：扫码时可自由切换后台（如截图、切换到 QQ 扫码），返回 App 后仍能正常进入控制台。

4、启动AstrBot

主页点击启动AstrBot

5、查看通知栏状态

成功运行后，通知栏将显示“正在运行”常驻通知。

禁止手动清除该通知，否则服务将终止。

6、首次登录控制台

默认用户名和密码均为：astrbot

登录后请按提示立即修改密码，确保账户安全。

7、保留预设通信接口

在“机器人” → “通信接口”中，pre-config 是内置的 NapCatQQ 连接通道。

请勿修改或删除此接口，否则机器人将无法与 QQ 通信。

8、填写大模型 API 密钥

前往模型提供商页面，新增并填入你的模型服务商提供的 Token（API Key）。

这是你唯一需要动手配置的地方，请自行搜索，或参考 AstrBot 官方文档的 “接入大模型服务” 页面。

支持 OpenAI、Anthropic、Ollama、智谱、DeepSeek、Dify 等平台。

配置完成后保存并重启机器人即可。

AstrBot泡泡版初始化失败怎么办

1、首次启动环境安装

主页->环境管理 依次安装“基础命令”、“uv”、“NapCat”、“AstrBot”

安装完成，点击刷新，图标右下显示绿色勾则安装成功

2、强烈建议人工监视终端输出

虽然过程自动化并可后台自动运行，但我们强烈建议你在首次启动时切入终端日志页面，持续观察安装进度。

这样可以第一时间发现网络阻塞、下载失败等问题，避免长时间等待无果。

3、napcat 安装可能耗时较长且易失败

特别是 napcat 组件（负责 AstrBot 与 QQ 协议通信），其安装时间较长，且对网络稳定性要求高。

若发现卡住或报错，可直接关闭 App 再次启动，系统会从中断处继续安装。

4、安装中断可自动恢复

新增稳健性优化：AstrBot 的代码仓库克隆已改为“原子操作”，避免因网络中断导致文件损坏。

初始化失败后重启，大部分情况下系统将自动恢复进程，大幅降低安装损坏风险。

5、极端情况处理方式

若多次重启仍无法完成初始化，可能是系统包损坏。

此时需进入手机设置 → 应用管理 → 找到 AstrBot App → 清除应用数据 → 重新启动。

6、特例警告

终端输出显示正在安装系统软件包（而非 uv, napcat 等资源下载）时，请务必避免操作中断！！

若终端出现如下提示：

dpkg was interrupted, you must manually run 'dpkg --configure -a' to correct the problem， 这表明系统软件包配置中断。虽然你可以按提示尝试修复，但我们建议你： 立即清除应用数据并重新初始化。

关于前台与息屏运行的说明

 首次初始化期间：虽然理论上支持息屏、切换后台，但强烈建议保持屏幕常亮并人工监视日志输出，以便快速排查问题。

 初始化完成后：机器人可稳定在后台运行，息屏、切换 App 均不影响服务，只要保证通知栏常驻通知不被关闭即可。

机器人频繁离线掉线怎么解决

1、将AstrBot泡泡版加入手机电池白名单，关闭系统自动休眠、后台清理限制。

2、开启应用前台常驻通知功能，维持系统前台进程避免被杀。

3、更换网络环境，使用稳定WiFi或流量，减少网络波动造成的连接中断。

适用人群及场景

1、普通QQ用户，想要低成本打造专属AI聊天机器人，实现私聊、群聊智能自动回复。

2、社群运营人员，利用机器人实现群问答、自动管理、定时推送内容，减轻人工维护压力。

3、AI爱好者，想要在手机端便捷测试各类大语言模型，体验本地化QQ机器人交互效果。

4、零基础用户，无电脑与编程基础，需要简单易上手的移动端机器人部署工具。

更新日志

0.1.0更新

修复bot接收图片报错rkey异常、400问题。旧版本需要更新最新版APP，到环境管理下载最新脚本，重装napcat并勾选”同时重装QQ“。新用户直接正常安装即可

修复大部分情况wifi网络安装环境报403问题，如果还是遇到请更换为流量

独立安装脚本，从脚本仓库拉取最新安装脚本。防止更新脚本需要更新APP

修复在webui界面点返回会回到桌面的bug，当前为回到网页的上一页

优化一些界面交互逻辑和显示效果