AstrBot泡泡版手机app

AstrBot泡泡版是AstrBot安卓客户端的一个重构分支，核心目标只有一个：让你不需要电脑、不需要命令行、不需要服务器，只用一部安卓手机，就能把自己的QQ号变成一个能自动回复、能调用大模型、能装插件的AI聊天机器人。它把AstrBot的完整服务、NapCat协议适配和运行环境全部封装进了一个App里，首次启动按顺序安装几个组件，扫码登录QQ，填入大模型的API Key，机器人就能跑起来。和原版安卓App相比，泡泡版修复了启动卡在“配置中”的bug，把安装拆成了分步进行，增加了多NapCat账号管理（支持部署多个BOT），并且与原版共存、数据隔离。但它仍然是beta阶段的软件，初始化对环境网络要求较高，NapCat组件安装容易卡住，QQ登录受腾讯风控影响，多开需要两个QQ号。本文把它的实际部署流程、多BOT的配置逻辑、插件与模型接入的玩法，以及新手最容易卡住的初始化与风控问题逐条拆开。

AstrBot是什么

你是否想过，用自己的QQ号，变成一个可以自动回复消息、调用大模型进行智能对话的“AI账号”？

AstrBot安卓App正是为此而生。

它不是一个普通的AI聊天界面，也不是一个本地运行的AI工具箱。

它的核心功能非常明确：

把你自己的QQ号，变成一个可以自动与人互动的AI聊天机器人。

你可以用它：

让你和你的朋友们，都可以在QQ上和机器人账号一对一智能聊天

加入QQ群，与广大群友们一起互动；甚至借助庞大的AstrBot社区插件，实现各种有意思的功能

接入你喜欢的大语言模型（如GPT、Llama、Gemini等），让这个QQ账号拥有强大的对话能力

最关键的是：这一切，不需要电脑、不需要懂命令行、不需要配置服务器。

只需要一部安卓手机，安装App，等待应用启动完成，扫码登录QQ，填入大模型密钥，就能让这个QQ号“活”起来。

当然，这个软件是【开源】且【免费】的！！！

关于泡泡版？

本项目基于AstrBot-Android-App进行重构，解决了下面问题：

修复了启动卡在配置中的bug

安装分步进行，不再一次安装，减少出错概率。首次启动请在主页点击环境管理进行安装

增加多NapCat账号管理，泡泡版支持部署多个BOT

优化了使用体验

与原版共存，与原版数据隔离

AstrBot泡泡版是什么：把QQ号变成AI机器人的手机端“封装器”

它的定位可以用一句话说清楚：AstrBot是一个强大的开源聊天机器人框架，但它原本需要服务器、命令行和一定的技术基础；泡泡版做的事情，是把这套框架连同运行环境一起塞进一个安卓App里，让你在手机上点几下就能跑起来。项目在GitHub上的描述非常直白：“不需要电脑、不需要懂命令行、不需要配置服务器。只需要一部安卓手机，安装App，等待应用启动完成，扫码登录QQ，填入大模型密钥，就能让这个QQ号‘活’起来”。泡泡版不是AstrBot官方产品，而是社区开发者基于另一个安卓项目（AstrBot-Android-App）进行重构的版本。它解决的问题很具体：修复了原版启动卡在“配置中”的bug，把原来一步到位的安装拆成了分步进行以减少出错概率，增加了多NapCat账号管理（支持部署多个BOT），并且与原版应用共存、数据隔离。把泡泡版理解为“AstrBot的手机端便捷部署壳”，而不是“一个独立的AI聊天App”，是理解它全部使用逻辑的前提。它的能力上限来自AstrBot框架本身，它的体验则取决于手机的性能、网络环境以及你对beta版软件排错的耐心。

AstrBot泡泡版怎么登录配置

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

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

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

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

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

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

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

注意事项：

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

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

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

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

1、首次启动环境安装

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

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

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

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

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

4、安装中断可自动恢复

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

5、极端情况处理方式

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

6、特例警告

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

AstrBot泡泡版手机版怎么获取密钥

1、打开派欧云等API密钥获取网站，进入密钥管理页面，点击创建按钮，输入自定义密钥名称，即可生成API密钥。

2、生成后请妥善保存密钥，如不慎丢失，可在控制台删除原有密钥，重新创建新密钥使用。

核心功能拆解：环境封装、多BOT与插件生态

📦 环境全封装：分步安装，降低出错概率

泡泡版把AstrBot运行所需的依赖和组件预先打包在了App里，但首次启动并不是“一键完成”，而是需要你在“环境管理”页面按顺序安装四个组件：基础命令、uv、NapCat、AstrBot。每安装完一个，图标右下角会显示绿色勾，全部装完后刷新即可。官方文档和部署教程反复强调：“首次启动请在主页点击环境管理进行安装”“安装分步进行，不再一次安装，减少出错概率”。这意味着泡泡版的设计逻辑是“把复杂流程拆开、让每一步可见”，而不是假装复杂不存在。NapCat组件的安装是整个过程里最耗时、也最容易失败的一环，因为它负责AstrBot与QQ协议的通信，对网络稳定性要求较高。部署教程给出的建议是：如果卡住或报错，直接关闭App再次启动，系统会从中断处继续安装；如果多次重启仍失败，清除应用数据后重来。

多NapCat账号管理与多BOT部署

泡泡版相比原版安卓App的一个关键升级，是增加了多NapCat账号管理，支持部署多个BOT，并且与原版应用共存、数据隔离。这意味着你可以在同一个App里管理多个QQ机器人账号，或者在同一台手机上同时运行泡泡版和原版AstrBot App，两者的数据互不干扰。对于需要同时运营多个QQ群、或者想用一个机器人做群管理、另一个做私聊陪伴的用户，多账号管理省掉了反复卸载重装的麻烦。但需要提前知道：多开通常需要准备两个QQ号——NapCat登录的是你的小号（机器人账号），你用大号去和这个小号对话。“一般来说需要，Napcat登录的是你的小号。机器人会使用这个号与你的大号聊天”。用一个号同时登录手机QQ和NapCat，存在被踢下线的风险。

大模型接入与插件生态：AstrBot框架的能力被完整继承

泡泡版继承了AstrBot框架的大模型接入能力，支持OpenAI GPT、Google Gemini、Llama、DeepSeek、ChatGLM、通义千问等主流模型，也兼容Ollama等本地部署方案。配置路径是：在WebUI管理面板或App内的模型提供商页面，选择新增，填入对应服务商的API Key（Token），保存并重启机器人。插件方面，AstrBot社区已有1000+插件可一键安装，覆盖联网搜索、图片生成、私有知识库、语音TTS、群管理工具、代码执行器、记忆系统等。泡泡版继承了这套插件体系，意味着你在手机上部署的机器人，功能和你在服务器上部署的AstrBot是同一套生态。知识库功能支持导入PDF、文档和Markdown文件，配合AstrBot的记忆系统，可以让机器人基于你提供的资料进行回答，而不是只依赖模型本身的通用知识。

⚠️ 部署与使用中的高频卡点：初始化、QQ登录与风控

初始化失败：NapCat安装卡住是常态

首次部署时，最常见的挫败点是NapCat组件安装失败或卡住。NapCat负责AstrBot与QQ协议的通信，安装时间较长，对网络稳定性要求高。部署教程给出的处理路径是：如果卡住或报错，直接关闭App再次启动，系统会从中断处继续安装；如果多次重启仍无法完成，进入手机设置 → 应用管理 → AstrBot → 清除应用数据，然后重新初始化。另一个实用建议是：首次启动时切入终端日志页面，持续观察安装进度，第一时间发现网络阻塞或下载失败。如果在线下载反复失败，可以考虑使用离线包导入的方式，绕过网络问题。

🔑 QQ登录：扫码只能用摄像头，风控需要“养号”

QQ登录环节有一个容易被忽略的限制：QQ不支持从相册读取二维码登录，必须使用摄像头扫描。这意味着如果你只有一台手机，需要把二维码显示在另一块屏幕上（或用镜子反射、分屏等方式）才能完成扫码。部署教程明确提示：“QQ不支持相册读取二维码的方式登录，只能使用摄像头”。另一个更根本的限制是腾讯风控。教程中写道：“QQ时不时被踢下线，需要重新扫码。这是tx风控，目前没有什么好办法，只能养号。”如果你用一个新注册的小号作为机器人账号，被风控的概率会更高。建议使用有一定使用记录、绑定过手机号的账号，并且避免在机器人账号上频繁切换设备或进行敏感操作。

🔋 后台保活：不配置电池白名单，机器人会“消失”

初始化完成后，机器人可以稳定在后台运行，息屏和切换App都不影响服务，前提是保证通知栏的常驻通知不被关闭。但不同手机厂商的省电策略差异很大，不配置的话，系统可能在锁屏后清理掉AstrBot进程，导致机器人离线。部署教程的建议很具体：将AstrBot泡泡版加入手机电池白名单，关闭系统自动休眠和后台清理限制；开启应用前台常驻通知功能，维持系统前台进程。如果机器人频繁离线，先检查这两项，再考虑网络环境是否稳定。

AstrBot泡泡版与原版安卓App、服务器部署的定位差异

❓ 常见问题

📵 初始化一直失败，NapCat装不上怎么办？

NapCat安装失败是泡泡版部署阶段最高频的问题。首先确认网络稳定，如果在线下载反复失败，可以使用离线包导入的方式绕过网络问题。如果安装卡住或报错，直接关闭App再次启动，系统会从中断处继续安装。如果多次重启仍然失败，进入手机设置 → 应用管理 → AstrBot → 清除应用数据，然后重新初始化。部署教程特别提醒：如果终端输出显示正在安装“系统软件包”（而非uv、napcat等资源下载），请务必避免操作中断。首次启动时切入终端日志页面观察进度，能更早发现卡在哪里。

🔑 QQ扫码登录不了，或者登录后总被踢下线？

扫码登录有两个限制：QQ不支持从相册读取二维码，必须用摄像头扫描；如果二维码过期，需要在主页删除账号重新创建。只有一台手机的话，可以用另一台设备显示二维码、用镜子反射、或者分屏操作来完成扫码。登录后被频繁踢下线，属于腾讯风控，没有一劳永逸的解决办法，只能“养号”。建议使用有一定使用记录、绑定过手机号的账号作为机器人号，避免新注册小号频繁切换设备。多开场景下，机器人号（NapCat登录的号）和你的主号需要是两个不同的QQ账号。

🔋 机器人总是离线，后台挂不住怎么办？

先把AstrBot泡泡版加入手机电池白名单，关闭系统自动休眠和后台清理限制；然后开启应用的前台常驻通知，让系统把它当作活跃进程对待。这两步做完，机器人在息屏和切换App时通常能保持在线。如果仍然频繁离线，检查通知栏的常驻通知是否被手动划掉，以及网络环境是否稳定。不同厂商的省电策略差异很大，部分品牌需要额外在“应用启动管理”中关闭自动管理，才能让后台进程稳定存活。

🧩 怎么接入大模型？API Key 从哪里获取？

进入泡泡版的模型提供商页面，选择新增，填入对应服务商的API Key（Token），保存并重启机器人即可。3DM的教程给出的获取方式是：打开派欧云等API密钥获取网站，进入密钥管理页面，创建密钥，生成后妥善保存。AstrBot框架支持的模型范围很广，DeepSeek、GPT、Gemini、千问、Llama、ChatGLM都可以，你也可以接入本地Ollama来避免API费用。API Key在本地加密保存，不会随意上传，但请仍然妥善保管，不要分享给他人。

👥 多开需要两个QQ号吗？

一般来说需要。NapCat登录的是你的小号（机器人账号），你用大号去和这个小号对话。如果你尝试用同一个QQ号同时登录手机QQ和NapCat，两者会互相挤下线。泡泡版的多NapCat账号管理功能，让你可以在一个App里管理多个机器人账号，但每个账号背后仍然需要一个独立的QQ号。如果你只需要一个机器人，准备一个小号即可；如果要同时跑多个不同人设或不同群组的机器人，就需要对应数量的QQ号。

👍 适合谁，不适合谁

适合：想在安卓手机上部署一个QQ AI机器人、但不想买服务器或长期开电脑的用户；需要管理多个QQ机器人账号（多个群、多个人设）并希望在一个App里统一操作的人；对AstrBot插件生态有兴趣、想用手机体验一键安装社区插件、接入大模型和知识库的玩家；以及能接受beta版软件、愿意按照部署教程一步步安装组件、自己排查NapCat和网络问题的折腾型用户。

不太适合：追求开箱即用、不愿意经历分步安装和环境配置的用户（泡泡版不是“装上就能聊”的App，它需要初始化环境、扫码登录、填API Key）；需要7×24小时稳定在线、不能接受手机后台被杀导致离线的用户（服务器或电脑部署AstrBot在稳定性上明显更优）；对腾讯风控没有心理准备、不愿意“养号”或准备小号的人；以及需要鸿蒙原生或iOS版本的用户（泡泡版目前是安卓端）。

⚖️ 优缺点速览

优点：不需要电脑和服务器，一部安卓手机就能部署完整的AstrBot机器人；环境组件预先封装，分步安装降低了出错概率；修复了原版启动卡“配置中”的bug；多NapCat账号管理支持部署多个BOT，与原版应用共存且数据隔离；完整继承AstrBot的大模型接入能力（DeepSeek/GPT/Gemini/千问等）和1000+插件生态；支持知识库导入、自定义人设和WebUI可视化管理；开源免费，无内购和广告。

需要注意的点：beta阶段软件，版本仍在迭代，稳定性和功能可能变化；NapCat安装对网络要求高，容易卡住或失败，需要耐心重试或使用离线包；QQ登录只能用摄像头扫码，且受腾讯风控影响，机器人号需要“养”；多开通常需要两个QQ号；手机后台保活依赖电池白名单和前台通知，不同厂商策略差异大；大模型API调用费用需自理，免费指的是软件本身。

新手使用小贴士与避坑提醒

✏️ 先按顺序装完四个组件，再谈登录。首次启动不要在主页乱点，先进“环境管理”，依次安装基础命令、uv、NapCat、AstrBot。每个装完看到绿色勾再继续。NapCat是最容易卡的一步，卡住就关掉App重开，系统会续装。全部装完再扫码登录QQ，顺序反了会出各种奇怪的问题。

✏️ 准备一个小号做机器人，大号用来聊天。NapCat登录的号就是机器人号，你用另一个号去加它、和它对话。用一个号同时登手机QQ和NapCat会被互相踢下线。小号最好是有一定使用记录的，新注册的号风控概率高。如果小号被踢，只能重新扫码，这是腾讯侧的限制，不是泡泡版的bug。

✏️ 电池白名单和前台通知必须配，否则机器人会“消失”。初始化完成后，立刻把泡泡版加入电池白名单，关闭系统自动休眠和后台清理限制，开启前台常驻通知。不配这两项，锁屏几分钟后机器人就可能离线。不同品牌手机还要检查“应用启动管理”是否限制了后台活动。

✏️ API Key是你的责任，从正规渠道获取。泡泡版本身不提供大模型，你需要自己去DeepSeek、派欧云或其他服务商创建API Key，填入模型设置。Key在本地加密保存，但仍然要妥善保管。如果你不想产生API费用，可以研究接入本地Ollama的方案，但通常需要另一台性能足够的设备来跑模型。

💬 编辑点评

AstrBot泡泡版解决的是一个很具体的痛点：AstrBot框架本身很强大，但“部署”这一步把很多只想在QQ里用上AI机器人的普通用户挡在了门外。泡泡版把服务器、命令行、依赖环境这些门槛全部收进了一个安卓App里，让你用一部手机、按照分步指引、扫码填Key就能跑起来。多NapCat账号管理和多BOT部署是它相比原版安卓App的实质进步，对于需要管理多个群或多个机器人账号的用户，这个差异是决定性的。但它的边界也同样清晰：它是beta阶段的社区重构版，NapCat安装可能卡住，QQ登录受腾讯风控，后台保活依赖手机厂商的省电策略，多开需要两个QQ号。把它当作一个“需要按教程一步步走、接受偶发故障、但确实能在手机上跑起来”的开源部署方案，它在降低门槛这件事上做得是扎实的；如果把它当作一个“装上就能稳定7×24小时在线”的商业产品，手机后台的限制和beta版的不确定性会让你失望。对于愿意折腾、手头正好有一部闲置安卓手机、需要快速验证QQ机器人玩法的用户，泡泡版在“手机端AstrBot部署”这个需求上提供了一个可用的入口；对于追求长期稳定在线、不希望被手机省电策略干扰的用户，服务器或电脑部署AstrBot仍然是更可靠的选择。本站提供AstrBot泡泡版相关版本信息，具体版本、包名与文件信息以GitHub Releases页面展示为准。

📌 总结

下载AstrBot泡泡版之前，先确认三件事：你愿意按照分步教程完成环境安装（基础命令→uv→NapCat→AstrBot），并接受NapCat可能卡住、需要重试或使用离线包的现实；你准备了一个专门用于机器人登录的QQ小号（与大号分开），并且知道QQ登录只能用摄像头扫码、可能受风控影响；以及你接受它是beta阶段的社区重构版，后台保活需要手动配置电池白名单和前台通知，API Key和调用费用由你自己负责。三个答案都偏向正面的话，它在“用一部安卓手机部署QQ AI机器人”这个需求上，提供了一个继承AstrBot完整能力（大模型、插件、知识库）且支持多BOT管理的入口。如果其中任何一项让你犹豫，或者你需要的是长期稳定、免维护的在线机器人，服务器或电脑部署AstrBot是更稳妥的路径。本站资源信息以GitHub官方发布页面为准。

更新日志

AstrBot泡泡版 v0.1.0 beta6.2.0 内测版

1.修复了一些后台稳定性

2.可以更方便地修改Astrbot的密码

3.自诊断功能兼容最新版本Astrbot

4.Opencode更新修复，先将“脚本”更新至v0.1.6，然后重装opencode即可更新到最新版本