AstrBot泡泡版

AstrBot泡泡版是AI一键部署工具，能对接各类大模型，OpenAI、DeepSeek、通义千问、百度文心、Gemini等。还可以一键安装需要的插件，进一步拓展服务。支持自定义人设、定时任务和调用Agent工具。软件开源免费没有广告，手机上就能搭建QQ AI机器人，体验群聊智能助手。

AstrBot泡泡版怎么登录配置

1.打开点击【同意继续】隐私政策；

2.进入主页，指定监听端口，可留空自动分配，之后启动账号；

3.等待二维码弹出，使用手机QQ扫码登录，成功返回主页；

4.点击【启动AstrBot】，成功运行后，通知栏显示"正在运行"；

5.点击【机器人】，选择【通信接口】，找到pre-config；

6.前往模型提供商页面，选择新增并填入Token（APIKey；

7.最后保存并重启机器人即可。

注意事项：

支持后台自由切换，如截图、切换QQ扫码，返回App后正常进入控制台；

首次登录控制台，默认用户名和密码均为：astrbot，登录后按提示立即修改密码；

pre-config是内置的NapCatQQ连接通道（请勿修改或删除，否则机器人无法与QQ通信）。

AstrBot泡泡版常见问题

1、各种安装失败

最最最最推荐的办法，使用离线下载：

离线安装包有5个，跟这五个组件一一对应，选择对应的包导入就行。离线包不要自己解压。

如果你的APP没有离线安装的功能，请更新到最新版：

泡泡版为beta6.1.0及以上。

沙盒本体版本为0.3.5。

沙盒皮肤版本为beta5.6.0及以上。

2、Astrbot密码错误

如果你是最新版，默认账号与密码都是 astrbot。

如果不是最新版，请在终端查看随机初始密码。

3、Napcat无法登录

提示二维码过期：请在主页删除账号，重新创建。

提示“为了保证你的账号安全，本次请求不支持图片识别或长按扫描二维码授权，请通过摄像头扫一扫重新授权登录。”

QQ不支持相册读取二维码的方式登录，只能使用摄像头，意味着你必须将二维码放在你的摄像头能拍到的位置。你可以：

使用另一台设备进行扫码。

将码发到其他带屏幕的设备上，进行扫码。

利用两面镜子反射，手机开分屏，进行单设备扫码。

4、Napcat账号问题

需要两个QQ号吗

一般来说需要，一个小号完全交给机器人，一个是你自己的号，Napcat登录的是你的小号。机器人会使用这个号与你自己的号聊天。

QQ时不时被踢下线

这是tx风控，目前没有什么好办法，只能养号。账号等级要尽量高，不要有违规行为，绑定了成年身份证，掉线就马上补。up的账号前期也会被踢，现在已经稳定一年没被踢了。

5、Astrbot相关问题相关问题

如何下载插件

在webUI中点左上角导航栏，找到“插件”-“插件市场”下载自己需要的插件。

如何重置对话/清空记忆

对bot发送：/reset  （注意，如果你在设置里修改了唤醒词，请将“/”换成对应的唤醒词）。

其他功能

Astrbot的功能很强大，社区也很丰富，如果你想深入研究，可以实现让BOT控制你的电脑，帮你玩游戏，主动发说说，主动逛社区等等。可以加入Astrbot的官方社区。

6、Napcat的webUI登录token是什么

点这个球能直接登录webUI无需输入token。

点最后三个点的按钮，里面也能自行复制token。

7、API key如何获取

不同模型的供应商不同，获取方式也不同。可以自行询问AI，查询教程。比如你想使用deekseek的API key，就搜索关键词“deepseek API”。其他同理。

8、鸿蒙系统可以用吗

不可以。

AstrBot泡泡版使用教程

一，首次初始化期间

理论上支持息屏+切换后台，但强烈建议保持屏幕常亮+人工监视日志输出，便于快速排查问题

二，初始化完成后

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

AstrBot泡泡版初始化失败

1.首次启动环境安装

主页→环境管理→依次安装"基础命令"、"uv"、"NapCat"、"AstrBot"→安装完成→点击刷新→图标右下显示绿色勾则安装成功

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

首次启动时切入终端日志页面→持续观察安装进度→第一时间发现网络阻塞、下载失败等问题

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

napcat组件（负责AstrBot与QQ协议通信）安装时间较长，对网络稳定性要求高→若卡住或报错→直接关闭App再次启动，系统会从中断处继续安装

4.安装中断可自动恢复

新增稳健性优化：AstrBot的代码仓库克隆已改为"原子操作"，避免网络中断导致文件损坏→初始化失败后重启→大部分情况下系统自动恢复进程

5.极端情况处理方式

若多次重启仍无法完成初始化→可能是系统包损坏→进入手机设置→应用管理→AstrBotApp→清除应用数据→重新启动

6.特例警告

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