AstrBot安卓版v1.5.3 开源版

编辑点评：让每一个普通人都能拥有自己的 AI 聊天机器人

AstrBot 安卓 App 是一款专为普通用户设计的 AI 聊天机器人应用，将复杂的 AI 系统封装成一个简单易用的手机应用。用户只需安装 App、扫码登录 QQ 并填入大模型密钥，即可将 QQ 号变成一个智能聊天机器人，支持一对一聊天、群组互动，甚至接入多种大语言模型。

AstrBot 安卓 App怎么使用？

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

AstrBot安卓App正是为此而生。

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

它的核心功能非常明确：

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

你可以用它：

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

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

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

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

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

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

为什么要做这个App？它的最大优势是什么？

市面上有很多AI工具，但大多数只是“单机版聊天窗口”。

而AstrBot的特别之处在于：它让你的QQ号真正成为一个可交互的AI节点。

但原始的AstrBot需要在电脑上通过命令行部署环境、在浏览器中管理服务——这对绝大多数零技术背景的用户来说太难了。

因此，我们开发了AstrBot安卓App，它的最大优势是：

将复杂的AI机器人系统，封装成一个手机App，让电子小白也能轻松使用。

它解决了：

难以跟着文档一步一步配置

不知道什么是“命令行”或“终端”

没有电脑或无法长期开机

但希望用自己的QQ号实现AI自动回复

我们把复杂的依赖打包进App，通过手机一键启动，极大降低了使用门槛。

什么是AstrBot？

在深入安卓App之前，先让我们了解它背后的核心框架：AstrBot。

AstrBot:https://docs.astrbot.app/：强大的多平台聊天机器人框架是一个开源的多平台聊天机器人框架，专注于将大语言模型（LLM）接入日常社交工具（如QQ、微信、Telegram），提供对话管理、插件扩展和自动化任务能力。其核心定位是“消息平台与大模型的连接器”，支持多轮对话、知识库、代码执行器等高级功能。

原始项目核心能力

多平台支持

兼容QQ（OneBot/频道）、微信（企业微信/公众号）、飞书、钉钉、Telegram、Discord等15+平台。

支持多实例部署，可同时运行多个机器人账号。

提供消息过滤、白名单、速率限制等管理功能。

大模型对接

支持主流大模型：OpenAIGPT-4、GoogleGemini、Llama、DeepSeek、ChatGLM、通义千问等。

兼容本地部署方案（如Ollama、LLMTuner），降低API成本。

支持多模型混合调用、负载均衡、失败自动切换。

Agent任务自动化

代码执行器：在安全沙箱中运行Python/JS代码并返回结果。

网页搜索：实时联网获取最新信息，回答时效性问题。

待办事项：自然语言解析并管理任务列表。

记忆系统：长期记忆用户偏好与历史对话上下文。

插件扩展系统

内置官方插件：天气查询、翻译、知识问答、数学计算、图片生成等。

支持开发者自定义插件（Python编写），社区生态丰富。

插件可独立开启/关闭，完全模块化设计。

开发者友好

基于事件总线和流水线架构，易于二次开发。

提供完整的RESTfulAPI和WebSocket接口。

支持Docker、Windows、Linux多种部署方式。

一句话总结：

AstrBot是一个功能强大、高度可扩展的AI机器人开发框架，适合开发者、极客用户构建专业级聊天机器人。

AstrBot安卓App：让普通人也能用上AstrBot

虽然AstrBot功能强大，但它的原始部署方式对普通人来说门槛太高。

因此，我们基于AstrBot核心，开发了AstrBot安卓App，目标非常明确：

让每一个没有技术基础、不懂命令行、甚至都不知道如何解压缩的电子小白，也能用上AI聊天机器人。

我们把AstrBot+NapCatQQ+Ubuntu容器环境全部打包进一个.apk文件，用户只需三步即可启用：

1安装App

2等待应用启动完成

3扫码登录QQ

4填入大模型密钥

全程无需电脑、无需命令行、无需手动配置，彻底打破技术壁垒。

安卓App能做什么？不能做什么？

重点强调：

本App已将NapCatQQ与AstrBot核心深度集成，省去用户手动配置的麻烦。但也意味着：它只能用于QQ平台。这不是缺陷，而是为了简化体验所做的必要聚焦。

使用前必读：完整操作指南与注意事项

由于本App面向的是完全零技术背景的用户群体，为确保你能顺利完成初始化并稳定运行，请务必仔细阅读以下全部内容。

网络要求

【首次启动】必须在网络通畅的环境下进行

推荐使用家用Wi-Fi或手机5G流量

避免使用校园网、公司内网、公共Wi-Fi等限速或受限网络，可能导致资源下载失败

初始化注意事项（请逐条阅读，以避免初始化失败）

首次启动时，App会自动下载并安装必要的运行环境（基于Ubuntu容器）。这是一个全自动过程，但仍需注意以下几点：

应用启动后会联网下载依赖资源

屏幕显示白色进度条，表示正在初始化。

点击屏幕任意位置，可在“进度条页面”与“模拟终端日志”之间切换。

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

虽然过程自动化并可后台自动运行，但我们强烈建议你在首次启动时切入终端日志页面，持续观察安装进度。

这样可以第一时间发现网络阻塞、下载失败等问题，避免长时间等待无果。

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

特别是napcat组件（负责AstrBot与QQ协议通信），其安装时间较长，且对网络稳定性要求高。

若发现卡住或报错，可直接关闭App再次启动，系统会从中断处继续安装。

安装中断可自动恢复

新增稳健性优化：AstrBot的代码仓库克隆已改为“原子操作”，避免因网络中断导致文件损坏。

初始化失败后重启，大部分情况下系统将自动恢复进程，大幅降低安装损坏风险。

极端情况处理方式

若多次重启仍无法完成初始化，可能是系统包损坏。

此时需进入手机设置→应用管理→找到AstrBotApp→清除应用数据→重新启动。

特例警告

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

若终端出现如下提示：

dpkgwasinterrupted,youmustmanuallyrun'dpkg--configure-a'tocorrecttheproblem，这表明系统软件包配置中断。虽然你可以按提示尝试修复，但我们建议你：立即清除应用数据并重新初始化。

关于前台与息屏运行的说明

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

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

登录与配置流程

完成初始化后，请按以下步骤操作：

允许通知权限

启动后App会请求通知权限，必须点击“允许”。

若拒绝，机器人将无法在后台持续运行。

等待NapCatQQ启动并显示二维码

NapCatQQ与AstrBot服务同步启动，成功后会弹出QQ登录二维码。

若始终未弹出QQ登录二维码，可能初始化时napcat组件安装失败。请关闭软件并重启，基本可以自动修复。

扫码登录QQ账号

使用你手机上的QQ扫码登录。

体验优化：扫码时可自由切换后台（如截图、切换到QQ扫码），返回App后仍能正常进入控制台。

登录成功后自动跳转控制台

二维码窗口自动消失，内置WebView加载AstrBot浏览器仪表盘。

查看通知栏状态

成功运行后，通知栏将显示“正在运行”常驻通知。

禁止手动清除该通知，否则服务将终止。

首次登录控制台

默认用户名和密码均为：astrbot

登录后请按提示立即修改密码，确保账户安全。

保留预设通信接口

在“机器人”→“通信接口”中，pre-config是内置的NapCatQQ连接通道。

请勿修改或删除此接口，否则机器人将无法与QQ通信。

填写大模型API密钥

前往模型提供商页面，新增并填入你的模型服务商提供的Token（APIKey）。

这是你唯一需要动手配置的地方，请自行搜索，或参考AstrBot官方文档:https://docs.astrbot.app/的“接入大模型服务”页面。

支持OpenAI、Anthropic、Ollama、智谱、DeepSeek、Dify等平台。

配置完成后保存并重启机器人即可。

更新日志

v1.5.3 

新特性

支持两次返回手势/点按返回按钮回到桌面