AstrBot安卓版是一款面向Android设备的AstrBot与NapCat本地部署及运行管理应用。它在手机里起一个隔离的Linux运行环境,把消息协议端和AI调度框架都养在同一个容器里,外面再用Kotlin+Jetpack Compose做一层原生操控台。
AstrBot安卓版不是另一个客户端,而是一个运行管理器。大脑AstrBot负责接大模型、管人设、跑插件、处理多平台消息。嘴巴NapCat通过OneBot v11把QQ的收发变成标准事件流。用户不需要懂容器、不用配环境变量,打开就是两个熟悉的后台网页,一边调机器人,一边看QQ连接状态。
• 给 QQ 挂上 DeepSeek / Claude / 通义千问,私聊群聊都能接
• 捏一个人设——毒舌猫、温柔树洞、二次元客服,语气你说了算
• 插件市场挑着装:查天气、搜资料、记对话、管群秩序
• 手机原生面板里看运行状态、翻日志、做备份,哪里卡了一眼定位
• 常用网页
底部“网页”默认提供 DeepSeek。说明文字下方的整行“添加网址”按钮可添加收藏,列表上方显示收藏数量。旧版默认的 DeepSeek 聊天页或用量页会更新为官网首页,已改名或改成其他地址的条目保留。
卡片自动获取并缓存网站图标,无法获取时显示名称首字。卡片下方直接显示“打开网页、编辑、删除”三个按钮;点名称也可打开网页,删除前会再次确认。网页支持刷新和返回浏览历史,右上角“…”菜单可调整 100%、75%、50%、25% 缩放或在外部浏览器打开,每个地址独立保存缩放。仅接受不含账号密码的 HTTP / HTTPS 网址;网站的登录会话由 WebView 保存,不会预填本机服务凭据。
普通收藏网页支持用户点击后拉起已安装的微信、支付宝,以及网页打开新窗口的流程;返回时可回到原页面。未安装对应 App 时给出提示。部分支付站点仍可能要求外部浏览器或扫码,能否完成交易由商户网页、支付 App 与账号状态决定,App 不代为付款。外部浏览器的登录会话与内置网页独立。
• 后台登录与缩放
内置浏览器会填写仍有效的初始登录信息,点击登录即可。AstrBot 首次登录要求修改密码;修改用户名或密码后,不再预填初始账号。NapCat 使用当前访问口令。
服务详情的“凭据”页可查看、隐藏和复制初始信息。两套后台默认使用 75% 缩放,可切换 100%、75%、50%、25%,也可从连接页打开外部浏览器。
忘记后台密码或口令时,在对应服务的“凭据”页点击“重置后台密码”或“重置后台口令”,确认后生成新的随机凭据,可在同页查看或复制。AstrBot 保留登录账号,首次登录新密码后需改密,原登录会话失效;NapCat 保留 QQ 会话和 OneBot 配置。只重启原本正在运行的对应服务,NapCat 重启期间 QQ 会短暂断开,其他模型、插件和聊天数据保持原样。
新装空配置会准备 NapCat WebSocket 客户端 ws://127.0.0.1:6199/ws,token 留空,与 AstrBot 本机 OneBot 服务配对。使用明确的 IPv4 回环地址,避免 localhost 优先解析到 ::1 时无法连接仅监听 IPv4 的服务。
旧版生成且仍保持默认参数的 localhost 连接,会在下次启动 NapCat 前备份并迁移到上述 IPv4 地址;自定义端口、token、其他目标及已停用的连接保留。原文件位于 persistent/manager/onebot-ipv4-backup/。手动配置连接时,请确认 AstrBot 的 OneBot 服务端口、路径和 token 与 NapCat 一致。
• 服务与局域网访问
首页可以启动、停止或重启全部服务,也可以分别控制。进入服务详情后,底栏切换为“概览 / 连接 / 凭据 / 日志”。
在对应服务的“连接”页开启局域网访问后,使用同一网络下的设备访问页面显示的地址。每套后台单独控制,原有登录鉴权保留;App 内仍使用本机地址。网络切换后请使用当前显示的局域网地址。
1.4.0 新增 AstrBot 实例检查:启动前通过独立锁避免重复实例,并检查配置中的实际后台端口,包括默认 6185。已有实例响应时保留原进程,提示先在原会话停止;确认来自本环境、已运行超过启动宽限期且连续无响应的旧 AstrBot,才尝试先正常结束、必要时强制结束该 Python 进程,等待端口释放后再启动。不会按端口或进程名称批量结束 Ubuntu、桌面或 QQ,也不依赖读取 Android 限制的 /proc/net/tcp。无法确认身份的占用仍需用户处理,不会无限重复拉起。
• 人设
人设页支持搜索、分类、预览和复制,列表可以上下滑动浏览,不显示滚动条。预设可“仅添加”到 AstrBot,也可“设为默认”或“恢复上次”。
内置预设参考玖帕喵市场精选整理:吃白饭的大肥鱼、月见八千代、DeepSeek娘,以及根据《拟人模板Ⅲ》补全的原创朋友“小满”。预览顶部注明发布者和改编范围,“来源”可打开原帖。预设排除破甲内容,移除不适用于 AstrBot 的框架工具与越权要求,保留角色特点并调整为短句聊天。
• 分段回复
人设约定日常使用完整短句、中文句末标点和真实换行;实际分开发送由 AstrBot 控制。在 AstrBot 后台的“分段回复”中开启功能,使用正则模式时可填写:
.*?[。?!\~…\n]+|.+$
此规则按中文句末标点、波浪号、省略号或换行分段,保留匹配的标点;空格和逗号不作为分隔符。英文章节或代码中的 .?! 不属于上述中文标点。预设避免在词中拖音和输出零碎旁白;教程、代码、链接等按任务需要保留完整格式。
AstrBot 4.29.3 对整段文本先检查字符长度:默认阈值为 150,超过 150 字符会直接发送,不再执行分段正则;恰好等于阈值仍进入分段处理。字符数包含标点和换行。需要分割更长的回复时,在后台按需提高阈值。App 不自动更改开关、阈值、流式输出或会话配置;模型也可能不完全遵循提示词。
• 自建与切换
点击列表上方的“人设市场”会在外部浏览器打开玖帕喵人设市场。选择喜欢的提示词后,回到 App 点击“新增人设”,填写名称、分类和提示词保存,简介和开场示例可以选填。
自建人设和内置预设都可在预览中删除。新增内容和删除记录保存在本地,更新 App 后保留;列表可以全部删除,也可以重新添加。删除仅影响本地列表,已导入 AstrBot 的副本和当前默认人设保留,在 AstrBot 后台中管理。
切换时会短暂停止 AstrBot 并恢复原启停状态,NapCat 保持运行。已在 AstrBot 中独立指定人设的会话继续使用原设置;预设内容可以在原后台继续编辑。
更新 App 不会覆盖已经导入 AstrBot 的同名人设。如果之前导入过同名旧稿并希望换成新版提示词,请在预览中复制提示词,在 AstrBot 后台编辑对应人设;旧版预设从本地目录替换后,其已导入副本仍会保留。开场白仅供预览,不会自动向会话发送。
• QQ 掉线排查
QQ 若提示“已登录设备风险提醒”,并说明已将 Linux QQ 设备强制下线,属于 QQ 平台的账号风险处置。请先在官方 QQ 中按提示检查登录设备和账号安全,避免短时间内反复扫码、切换设备或重启重登。管理器的后台权限、自动重启以及更换接入组件都不能保证消除这类风控。
如果没有风险提示,可先看 NapCat 后台的 QQ 登录状态和服务日志:QQ 仍在线但 AstrBot 收不到消息时,检查 OneBot WebSocket 连接;服务进程已退出时,检查退出日志和安卓后台权限。更新组件前先备份,使用上游发布的兼容版本,并逐项观察变化。
配置流程
1.进入 AstrBot 的 WebUI,点击左边栏 机器人,然后点击 + 创建机器人。
2.选择 QQ 官方机器人(WebSocket)。
3.在 选择创建方式 中选择 扫码一键创建,点击开始创建后,用手机 QQ 扫描页面中的二维码。
4.扫码确认后,AstrBot 会自动写入 AppID 和 AppSecret。确认 启用 已勾选,然后点击 保存。
5.回到 QQ 开放平台页面,点击机器人右边的 扫码聊天。用手机 QQ 扫码即可聊天。
在群聊中使用
添加到群聊
进入创建的 QQ 机器人的资料页(手机QQ -> 联系人 -> 机器人页签),在下方可以找到 “添加到群聊”。目前只能添加到自己为群主的群聊。
设置机器人可获取的群聊消息范围和主动发言
在手机 QQ 的群聊设置中打开机器人设置,推荐将 机器人可获取的群聊消息范围 设置为 获取群内全部消息,并开启 机器人主动在群聊内发言。
这样机器人可以接收群聊全量消息,也可以在群聊中主动推送消息,例如定时任务推送、插件主动通知等。
v1.4.1版本
加快首次初始化
完善离线准备进度
改善 Linux QQ 启动衔接
调整手动部署引导
补齐快捷初始凭据
展开内容
访问网络 访问网络连接,可能产生GPRS流量 ------------------------------------- 获取网络状态 获取网络信息状态,如当前的网络连接是否有效 ------------------------------------- 唤醒锁定 允许程序在手机屏幕关闭后后台进程仍然运行 ------------------------------------- 开机自动允许 允许程序开机自动运行 -------------------------------------