編輯點評：手機一鍵部署QQAI機器人，泡泡版無需電腦服務器接入各類大模型

AstrBot泡泡版是下载輕量化安卓QQAI機器人應用，專門解決傳統機器人需要電腦、泡泡版複雜代碼部署的下载難題，基於成熟AstrBot開源框架打造，泡泡版整合NapCatQQ適配協議，下载在手機容器內完整運行機器人服務，泡泡版支持個人QQ私聊智能應答、下载群聊多人互動，泡泡版可自由接入市麵上主流大語言模型，下载海量社區插件一鍵安裝拓展群管理、泡泡版問答、下载生成等功能，泡泡版全程可視化操作，下载不用專業技術知識，泡泡版普通用戶安裝完成後簡單配置就能擁有專屬AIQQ機器人。

登錄及配置流程

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 等平台。

配置完成後保存並重啟機器人即可。

AstrBot泡泡版初始化失敗怎麽辦

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， 這表明係統軟件包配置中斷。雖然你可以按提示嚐試修複，但我們建議你： 立即清除應用數據並重新初始化。

關於前台與息屏運行的說明

 首次初始化期間：雖然理論上支持息屏、切換後台，但強烈建議保持屏幕常亮並人工監視日誌輸出，以便快速排查問題。

 初始化完成後：機器人可穩定在後台運行，息屏、切換 App 均不影響服務，隻要保證通知欄常駐通知不被關閉即可。

機器人頻繁離線掉線怎麽解決

1、將AstrBot泡泡版加入手機電池白名單，關閉係統自動休眠、後台清理限製。

2、開啟應用前台常駐通知功能，維持係統前台進程避免被殺。

3、更換網絡環境，使用穩定WiFi或流量，減少網絡波動造成的連接中斷。

適用人群及場景

1、普通QQ用戶，想要低成本打造專屬AI聊天機器人，實現私聊、群聊智能自動回複。

2、社群運營人員，利用機器人實現群問答、自動管理、定時推送內容，減輕人工維護壓力。

3、AI愛好者，想要在手機端便捷測試各類大語言模型，體驗本地化QQ機器人交互效果。

4、零基礎用戶，無電腦與編程基礎，需要簡單易上手的移動端機器人部署工具。

更新日誌

0.1.0更新

修複bot接收圖片報錯rkey異常、400問題。舊版本需要更新最新版APP，到環境管理下載最新腳本，重裝napcat並勾選”同時重裝QQ“。新用戶直接正常安裝即可

修複大部分情況wifi網絡安裝環境報403問題，如果還是遇到請更換為流量

獨立安裝腳本，從腳本倉庫拉取最新安裝腳本。防止更新腳本需要更新APP

修複在webui界麵點返回會回到桌麵的bug，當前為回到網頁的上一頁

優化一些界麵交互邏輯和顯示效果