編輯點(diǎn)評(píng)：手機(jī)一鍵部署QQAI機(jī)器人，泡泡版無(wú)需電腦服務(wù)器接入各類大模型
AstrBot泡泡版是下載輕量化安卓QQAI機(jī)器人應(yīng)用，專門解決傳統(tǒng)機(jī)器人需要電腦、泡泡版複雜代碼部署的下載難題，基於成熟AstrBot開源框架打造，泡泡版整合NapCatQQ適配協(xié)議，下載在手機(jī)容器內(nèi)完整運(yùn)行機(jī)器人服務(wù)，泡泡版支持個(gè)人QQ私聊智能應(yīng)答、下載群聊多人互動(dòng)，泡泡版可自由接入市麵上主流大語(yǔ)言模型，下載海量社區(qū)插件一鍵安裝拓展群管理、泡泡版問(wèn)答、下載生成等功能，泡泡版全程可視化操作，下載不用專業(yè)技術(shù)知識(shí)，泡泡版普通用戶安裝完成後簡(jiǎn)單配置就能擁有專屬AIQQ機(jī)器人。
登錄及配置流程
1、允許通知權(quán)限
啟動(dòng)後 App 會(huì)請(qǐng)求通知權(quán)限，必須點(diǎn)擊“允許”。
若拒絕，機(jī)器人將無(wú)法在後臺(tái)持續(xù)運(yùn)行。
2、添加NapCat賬號(hào)
可指定監(jiān)聽端口，可留空自動(dòng)分配
啟動(dòng)賬號(hào)，等待二維碼彈出
3、掃碼登錄QQ賬號(hào)
使用你手機(jī)上的 QQ 掃碼登錄。
體驗(yàn)優(yōu)化：掃碼時(shí)可自由切換後臺(tái)（如截圖、切換到 QQ 掃碼），返回 App 後仍能正常進(jìn)入控製臺(tái)。
4、啟動(dòng)AstrBot
主頁(yè)點(diǎn)擊啟動(dòng)AstrBot
5、查看通知欄狀態(tài)
成功運(yùn)行後，通知欄將顯示“正在運(yùn)行”常駐通知。
禁止手動(dòng)清除該通知，否則服務(wù)將終止。
6、首次登錄控製臺(tái)
默認(rèn)用戶名和密碼均為：astrbot
登錄後請(qǐng)按提示立即修改密碼，確保賬戶安全。
7、保留預(yù)設(shè)通信接口
在“機(jī)器人” → “通信接口”中，pre-config 是內(nèi)置的 NapCatQQ 連接通道。
請(qǐng)勿修改或刪除此接口，否則機(jī)器人將無(wú)法與 QQ 通信。
8、填寫大模型 API 密鑰
前往模型提供商頁(yè)麵，新增並填入你的模型服務(wù)商提供的 Token（API Key）。
這是你唯一需要?jiǎng)邮峙渲玫牡胤剑?qǐng)自行搜索，或參考 AstrBot 官方文檔的 “接入大模型服務(wù)” 頁(yè)麵。
支持 OpenAI、Anthropic、Ollama、智譜、DeepSeek、Dify 等平臺(tái)。
配置完成後保存並重啟機(jī)器人即可。
AstrBot泡泡版初始化失敗怎麼辦
1、首次啟動(dòng)環(huán)境安裝
主頁(yè)->環(huán)境管理 依次安裝“基礎(chǔ)命令”、“uv”、“NapCat”、“AstrBot”
安裝完成，點(diǎn)擊刷新，圖標(biāo)右下顯示綠色勾則安裝成功
2、強(qiáng)烈建議人工監(jiān)視終端輸出
雖然過(guò)程自動(dòng)化並可後臺(tái)自動(dòng)運(yùn)行，但我們強(qiáng)烈建議你在首次啟動(dòng)時(shí)切入終端日誌頁(yè)麵，持續(xù)觀察安裝進(jìn)度。
這樣可以第一時(shí)間發(fā)現(xiàn)網(wǎng)絡(luò)阻塞、下載失敗等問(wèn)題，避免長(zhǎng)時(shí)間等待無(wú)果。
3、napcat 安裝可能耗時(shí)較長(zhǎng)且易失敗
特別是 napcat 組件（負(fù)責(zé) AstrBot 與 QQ 協(xié)議通信），其安裝時(shí)間較長(zhǎng)，且對(duì)網(wǎng)絡(luò)穩(wěn)定性要求高。
若發(fā)現(xiàn)卡住或報(bào)錯(cuò)，可直接關(guān)閉 App 再次啟動(dòng)，係統(tǒng)會(huì)從中斷處繼續(xù)安裝。
4、安裝中斷可自動(dòng)恢複
新增穩(wěn)健性優(yōu)化：AstrBot 的代碼倉(cāng)庫(kù)克隆已改為“原子操作”，避免因網(wǎng)絡(luò)中斷導(dǎo)致文件損壞。
初始化失敗後重啟，大部分情況下係統(tǒng)將自動(dòng)恢複進(jìn)程，大幅降低安裝損壞風(fēng)險(xiǎn)。
5、極端情況處理方式
若多次重啟仍無(wú)法完成初始化，可能是係統(tǒng)包損壞。
此時(shí)需進(jìn)入手機(jī)設(shè)置 → 應(yīng)用管理 → 找到 AstrBot App → 清除應(yīng)用數(shù)據(jù) → 重新啟動(dòng)。
6、特例警告
終端輸出顯示正在安裝係統(tǒng)軟件包（而非 uv, napcat 等資源下載）時(shí)，請(qǐng)務(wù)必避免操作中斷！！
若終端出現(xiàn)如下提示：
dpkg was interrupted, you must manually run 'dpkg --configure -a' to correct the problem， 這表明係統(tǒng)軟件包配置中斷。雖然你可以按提示嚐試修複，但我們建議你： 立即清除應(yīng)用數(shù)據(jù)並重新初始化。
關(guān)於前臺(tái)與息屏運(yùn)行的說(shuō)明
首次初始化期間：雖然理論上支持息屏、切換後臺(tái)，但強(qiáng)烈建議保持屏幕常亮並人工監(jiān)視日誌輸出，以便快速排查問(wèn)題。
初始化完成後：機(jī)器人可穩(wěn)定在後臺(tái)運(yùn)行，息屏、切換 App 均不影響服務(wù)，隻要保證通知欄常駐通知不被關(guān)閉即可。
機(jī)器人頻繁離線掉線怎麼解決
1、將AstrBot泡泡版加入手機(jī)電池白名單，關(guān)閉係統(tǒng)自動(dòng)休眠、後臺(tái)清理限製。
2、開啟應(yīng)用前臺(tái)常駐通知功能，維持係統(tǒng)前臺(tái)進(jìn)程避免被殺。
3、更換網(wǎng)絡(luò)環(huán)境，使用穩(wěn)定WiFi或流量，減少網(wǎng)絡(luò)波動(dòng)造成的連接中斷。
適用人群及場(chǎng)景
1、普通QQ用戶，想要低成本打造專屬AI聊天機(jī)器人，實(shí)現(xiàn)私聊、群聊智能自動(dòng)回複。
2、社群運(yùn)營(yíng)人員，利用機(jī)器人實(shí)現(xiàn)群?jiǎn)柎稹⒆詣?dòng)管理、定時(shí)推送內(nèi)容，減輕人工維護(hù)壓力。
3、AI愛(ài)好者，想要在手機(jī)端便捷測(cè)試各類大語(yǔ)言模型，體驗(yàn)本地化QQ機(jī)器人交互效果。
4、零基礎(chǔ)用戶，無(wú)電腦與編程基礎(chǔ)，需要簡(jiǎn)單易上手的移動(dòng)端機(jī)器人部署工具。
更新日誌
0.1.0更新
修複bot接收?qǐng)D片報(bào)錯(cuò)rkey異常、400問(wèn)題。舊版本需要更新最新版APP，到環(huán)境管理下載最新腳本，重裝napcat並勾選”同時(shí)重裝QQ“。新用戶直接正常安裝即可
修複大部分情況wifi網(wǎng)絡(luò)安裝環(huán)境報(bào)403問(wèn)題，如果還是遇到請(qǐng)更換為流量
獨(dú)立安裝腳本，從腳本倉(cāng)庫(kù)拉取最新安裝腳本。防止更新腳本需要更新APP
修複在webui界麵點(diǎn)返回會(huì)回到桌麵的bug，當(dāng)前為回到網(wǎng)頁(yè)的上一頁(yè)
優(yōu)化一些界麵交互邏輯和顯示效果
