AstrBot泡泡版

AstrBot泡泡版是一款轻量化的AI机器人工具，专为安卓QQ软件设计，打破门槛限制。基于成熟开源框架深度开发，整合NapCatQQ适配协议，在手机容器内完整运行机器人服务，实现私聊智能应答与多人互动，全程可视化操作。

新手快速配置指南

1、下载安装：获取AstrBot泡泡版安装包，打开后点击【同意继续】阅读隐私政策。

2、启动账号：进入主页指定监听端口，可留空自动分配，随后启动账号等待二维码弹出。

3、扫码登录：使用手机QQ扫描二维码登录，成功返回主页后点击【启动 AstrBot】，通知栏显示“正在运行”即成功。

4、模型接入：点击【机器人】选择【通信接口】找到pre-config，前往模型提供商页面新增并填入Token（API Key），保存重启机器人即可。

5、安全提醒：首次登录控制台默认用户名和密码均为astrbot，登录后请按提示立即修改密码；pre-config为内置NapCatQQ连接通道，请勿修改或删除。

初始化失败排查手册

1、环境安装：主页进入环境管理，依次安装“基础命令”、“uv”、“NapCat”、“AstrBot”，安装完成点击刷新，图标右下显示绿色勾则安装成功。

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

3、组件重试：napcat组件安装耗时较长且对网络稳定性要求高，若卡住或报错，直接关闭App再次启动，系统会从中断处继续安装。

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

5、极端处理：若多次重启仍无法完成初始化，可能是系统包损坏，进入手机设置应用管理清除AstrBot App数据后重新启动。

后台运行与掉线处理

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

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

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

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

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

核心功能亮点

1、自由接入：支持接入主流大语言模型，配备海量社区插件一键安装机制。

2、多样拓展：拓展群管理、智能问答、内容生成等多样化功能，操作灵活。

3、极简部署：无需购置额外硬件，仅凭一部手机即可部署与使用专属AI机器人。

4、清晰指引：从账号添加到模型接入，每一步都配有清晰指引，降低使用门槛。

AstrBot使用教程

1、首先打开AstrBot软件，阅读并同意相关协议及使用条款。

2、确认相关协议后，按照软件提示完成自动安装，等待安装流程结束。

3、安装完成后，进入软件登录界面，根据页面提示完成登录操作。

4、登录成功后，即可根据实际需求接入相关服务，开始使用AstrBot的各项功能。

更新日志

v0.1.0：修复bot接收图片报错rkey异常及400问题，旧版本需更新最新版APP并到环境管理下载最新脚本重装napcat；修复大部分情况wifi网络安装环境报403问题；独立安装脚本从脚本仓库拉取最新安装脚本；修复在webui界面点返回会回到桌面的bug；优化一些界面交互逻辑和显示效果。

小编简评

AstrBot泡泡版将AI机器人部署门槛降至一部手机，开源免费且整合NapCatQQ协议，可视化界面让普通用户也能轻松上手。从环境安装到模型接入均有清晰指引，后台运行稳定，是安卓QQ用户打造专属智能机器人的省心之选。