
更新:2026-09-04 09:40大小:88.4M
类型:手机软件版本:v0.1.0-beta5.5 安卓版





AstrBot泡泡版是基于开源AstrBot二次改造的轻量化移动端衍生版本,主打手机本地直接运行AI机器人,不用电脑、不用云服务器,普通用户也能快速搭出属于自己的AI聊天助手,全部靠图形界面点选操作,降低普通玩家上手门槛。
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 等平台。
配置完成后保存并重启机器人即可。
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, 这表明系统软件包配置中断。虽然你可以按提示尝试修复,但我们建议你: 立即清除应用数据并重新初始化。
AstrBot泡泡版是用NapCatQQ这套适配协议把整个机器人服务塞进了安卓容器里跑,该有的功能全在,只是你不用再面对那些命令行和报错日志了。装好之后在手机上登录QQ,把机器人挂上去,私聊它能回,群里有@它也能接住。大语言模型这块也给了选择空间,主流的模型都能接进去,想让它聪明点还是正经点可以自己调。比起那些功能受限的简化版机器人工具,泡泡版在"轻量"和"完整"之间找到了一个还不错的平衡点。
手机容器内完整运行:基于安卓容器技术承载完整的机器人服务,无需外部服务器或常开电脑即可保持在线。
基于成熟开源框架:依托AstrBot开源项目构建,底层能力经过社区验证,功能完整性和稳定性有一定保障。
NapCatQQ协议适配:整合NapCatQQ作为通信适配层,实现与QQ平台的消息收发对接,保持通信顺畅。
私聊与群聊双模式支持:可响应用户在个人对话中的提问,也可参与群内的多人互动和话题讨论。
填补轻量与专业之间的空白:市场上有全功能但难部署的专业方案,也有容易上手但功能简陋的简化版,泡泡版处于中间地带。
完整的对话处理能力:相比于阉割功能的轻量机器人,它在应答质量和交互方式上保留了完整方案的成熟度。
长期运行成本极低:无需额外购买服务器或保持电脑开机,一台安卓手机即可支撑持续服务,使用成本优势明显。
官方网址:暂无
应用厂商:
包名:com.astrbot.astrbot_bubble
名称:AstrBot泡泡版
版本:0.1.0-beta5.5
MD5值:bd33f8844bacd9bae7854630af0d49fc