AstrBot是一款AI聊天机器人，让更多用户可以展开自由的聊天，可以适配Deepseek R1，在其中接入qq，微信大模型机器人，可以选择的参数众多，用户只要简单的操作，即可得到满意的聊天过程，支持一对一聊天、群组互动，只要扫码登录，填入大模型密钥即可。

AstrBot怎么使用

1.下载安装AstrBot，之后打开，进行适配之后，进入扫码页面；

2.使用自己的手机qq扫码登陆，之后进入平台的登陆页面；

3.在其中输入对应的账号密码，确定之后即可进入主页；

4.点击【创建机器人】，输入大模型密钥，点击【创建】；

5.返回主页，就能看到对应项目，点击，展开聊天。

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

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

AstrBot软件特色

1.软件操作简单，将QQ号变成可以自动与人互动的AI聊天机器人。

2.接入喜欢的大语言模型，得到相应的对话能力，切换也很方便。

3.不需要电脑、懂命令行和配置服务器，让小白也能快速上手的。

AstrBot1.5.3更新日志

新特性

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