AstrBot 安卓 App：零门槛部署个人 AI 聊天机器人

🤹 Agent 任务自动化

• 代码执行器：在安全沙箱中运行 Python/JS 代码并返回结果。
• 网页搜索：实时联网获取最新信息，回答时效性问题。
• 待办事项：自然语言解析并管理任务列表。
• 记忆系统：长期记忆用户偏好与历史对话上下文。

🧩 插件扩展系统

• 内置官方插件：天气查询、翻译、知识问答、数学计算、图片生成等。
• 支持开发者自定义插件（Python 编写），社区生态丰富。
• 插件可独立开启/关闭，完全模块化设计。

🖥️ 开发者友好

• 基于事件总线和流水线架构，易于二次开发。
• 提供完整的 RESTful API 和 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 容器）。这是一个全自动过程，但仍需注意以下几点：

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

• 屏幕显示白色进度条，表示正在初始化。
• 点击屏幕任意位置，可在'进度条页面'与'模拟终端日志'之间切换。

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，这表明系统软件包配置中断。虽然你可以按提示尝试修复，但我们建议你： 立即清除应用数据并重新初始化。

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

• ✅ 首次初始化期间：虽然理论上支持息屏、切换后台，但强烈建议保持屏幕常亮并人工监视日志输出，以便快速排查问题。
• ✅ 初始化完成后：机器人可稳定在后台运行，息屏、切换 App 均不影响服务，只要保证通知栏常驻通知不被关闭即可。

🔄 登录与配置流程

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

1. 允许通知权限

• 启动后 App 会请求通知权限，必须点击'允许'。
• ❌ 若拒绝，机器人将无法在后台持续运行。

2. 等待 NapCatQQ 启动并显示二维码

• NapCatQQ 与 AstrBot 服务同步启动，成功后会弹出 QQ 登录二维码。
• 若始终未弹出 QQ 登录二维码，可能初始化时 napcat 组件安装失败。请关闭软件并重启，基本可以自动修复。

3. 扫码登录 QQ 账号

• 使用你手机上的 QQ 扫码登录。
• ✨ 体验优化：扫码时可自由切换后台（如截图、切换到 QQ 扫码），返回 App 后仍能正常进入控制台。

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

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

5. 查看通知栏状态

• 成功运行后，通知栏将显示'正在运行'常驻通知。
• 🔴 禁止手动清除该通知，否则服务将终止。

6. 首次登录控制台

• 默认用户名和密码均为：astrbot
• 登录后请按提示立即修改密码，确保账户安全。

7. 保留预设通信接口

• 在'机器人' → '通信接口'中，pre-config 是内置的 NapCatQQ 连接通道。
• ❌ 请勿修改或删除此接口，否则机器人将无法与 QQ 通信。

8. 填写大模型 API 密钥

• 前往模型提供商页面，新增并填入你的模型服务商提供的 Token（API Key）。
• 这是你唯一需要动手配置的地方，请自行搜索，或参考 AstrBot 官方 文档 的'接入大模型服务'页面。
• 支持 OpenAI、Anthropic、Ollama、智谱、DeepSeek、Dify 等平台。
• 配置完成后保存并重启机器人即可。

📌 总结：这款 App 相比原始项目，到底解决了什么问题？

💡 一句话总结： AstrBot 安卓 App 不是功能的增强，而是使用门槛的革命性降低。 它让原本需要有一定一定基础以部署的 AI 机器人系统，变成了每一个普通人都能轻松拥有的聊天助手。

🙏 致谢

感谢以下开源项目为本 App 提供基础支持：

• Code LFA：提供安卓端 Ubuntu 容器环境
• AstrBot：强大的多平台聊天机器人框架
• NapCatQQ：高效稳定的 QQ 协议适配器

📲 立即下载

• GitHub 仓库：https://github.com/zz6zz666/AstrBot-Android-App 在 release 页面下载最新版本 .apk 文件安装即可使用。

许可证说明 📜

本项目采用 BSD-3-Clause 许可证，尊重根基项目 Code LFA 的开源协议。