JunWan666/astrbot-for-android
在 Android 手机上本地部署和管理 AstrBot 与 NapCat，内置 PRoot Ubuntu 运行环境，支持原生管理界面、WebUI、日志、备份恢复和独立更新，无需 Root。
From the publisher
README & documentation
Source previewRead the project’s overview, installation instructions and usage examples. The original README is the source of truth.
AstrBot for Android 简体中文 | English 把 AstrBot 和 NapCat，装进你的 Android 手机。 一个 APK · 本地运行 · 原生管理 · 内置 WebUI AstrBot for Android（AstrBot 运行管理器） 是面向 Android 设备的 AstrBot 与 NapCat 本地部署及运行管理应用。通过单个 APK 集成 PRoot Ubuntu 运行环境与服务组件，提供环境初始化、服务启停、状态监控、日志查看、备份恢复及独立在线更新等功能，无需 Root。 应用采用 Kotlin 与 Jetpack Compose 构建原生管理界面，支持简体中文与英文，通过内置 WebView 访问 AstrBot 和 NapCat 的 WebUI，在手机端完成 QQ 登录、模型接入与插件配置，并提供人设管理、局域网访问、SSH 终端与 cpolar 内网穿透扩展。 当前版本为 1.2.0。本轮改善终端滚动、选字和快捷键，增加最近任务隐藏与后台凭据重置，简化 App 更新流程，并完善 Linux QQ 与 Ubuntu 的运行兼容性。完整变化见更新记录。 以下为 v1.1.0 的基础界面示例，包含服务管理、人设库、设置、实时日志及两套内置后台；截图尚未更新到 1.2.0。 首页和多数设置采用固定布局，小窗口分页；后台运行设置集中在可滚动的单页，人设与日志区域支持滚动。进入服务详情后，底部导航切换为该服务的概览、连接、凭据和日志，凭据页可重置忘记的后台密码或口令。 完整包内置运行环境，初始化无需另外下载 Ubuntu 或安装项目依赖。QQ 登录、模型调用和在线更新需要网络，账号与 API Key 直接在对应 WebUI 中配置。更多操作见使用指南。 cpolar 在“设置 → 扩展组件”中单独下载安装，客户端不打入 APK。登录官方 WebUI 后自动保存令牌，可管理三个默认隧道；隧道目标服务需在 App 中启动，服务能力以 cpolar 账号套餐为准。 使用 JDK 17、Android SDK…
Read the full README ↗ · Preview checked 2026-10-29T12:44:29.735Z
Inside the original README — Document outline
Headings are captured from the source. Links open the publisher’s document, not a locally hosted copy.
Links from the README
References supplied by the publisher, not independently verified endorsements. Check the destination before downloading files or entering credentials.
Documentation belongs to its respective authors. Reported project/model license: MIT. A listing is not a grant of reuse or training rights. Confirm the document’s own terms at the source.
What this repository does
在 Android 手机上本地部署和管理 AstrBot 与 NapCat，内置 PRoot Ubuntu 运行环境，支持原生管理界面、WebUI、日志、备份恢复和独立更新，无需 Root。
Repository facts
- Owner
- JunWan666
- Primary language
- Kotlin
- Stars
- 282
- Forks
- 12
- Open issues + pull requests
- 2
- License
- MIT
- Archived
- No
- Default branch
- main
- Created
- 2026-10-26T05:13:32.000Z
- Last push
- 2026-10-29T19:24:02.000Z
Topics and intended use
Owner-supplied topics: ai, android, astrbot, chatbot, jetpack-compose, kotlin, llm, napcat, napcatqq, onebot, proot, qq-bot, self-hosted, ubuntu
Review the README for scope, installation, examples and limitations. We do not run repository code or certify it.
Evaluate before installing
Review licensing and dependencies, inspect recent commits and unresolved issues, and test in an isolated environment before production use. Stars and forks alone cannot answer these questions.
Source and freshness
Source: GitHub. Metadata observed 2026-10-31T12:17:23.005Z. Daily imports are snapshots, not real-time monitoring.
Popularity and source listings do not establish security, suitability, licensing rights or benchmark performance.