


AstrBot泡泡版是一款AI机器人工具,内置完整的运行依赖环境,开箱即用,不用单独配置Python环境,也不需要电脑,手机本地就能启动Web管理面板。支持接入DeepSeek、通义千问、Ollama本地模型等多种大语言模型,可自定义AI人设、对话记忆、上下文压缩等参数。支持对接QQ、KOOK等聊天平台协议,实现群聊AI回复、自动问答。内置插件市场,可安装联网搜索、图片生成、知识库、语音TTS、群管工具等社区插件,扩展机器人能力。

1. 打开App,点击【同意继续】确认隐私政策。
2. 进入主页,指定监听端口(可留空自动分配),然后启动账号。
3. 等待二维码弹出,用手机QQ扫码登录,成功后返回主页。
4. 点击【启动AstrBot】,运行成功后通知栏会显示“正在运行”。
5. 点击【机器人】,选择【通信接口】,找到pre-config。
6. 前往模型提供商页面,选择新增并填入Token(API Key)。
7. 最后保存并重启机器人即可。
注意事项:
· 支持后台自由切换,比如截图、切换QQ扫码后,返回App仍可正常进入控制台。
· 首次登录控制台,默认用户名和密码均为astrbot,登录后按提示立即修改密码。
· pre-config是内置的NapCatQQ连接通道,不要修改或删除,否则机器人无法与QQ通信。
1. 首次启动的环境安装
路径:主页 → 环境管理 → 依次安装“基础命令”、“uv”、“NapCat”、“AstrBot” → 安装完成 → 点击刷新 → 图标右下显示绿色勾即表示安装成功。

2. 建议人工监视终端输出
首次启动时切到终端日志页面,持续观察安装进度,以便第一时间发现网络阻塞、下载失败等问题。

3. napcat安装可能耗时较长且容易失败
napcat组件负责AstrBot与QQ协议之间的通信,安装时间较长,对网络稳定性要求高。如果卡住或报错,直接关闭App再重新启动,系统会从中断处继续安装。
4. 安装中断可自动恢复
新版增加了稳健性优化:AstrBot的代码仓库克隆已改为“原子操作”,避免网络中断导致文件损坏。初始化失败后重启,大部分情况下系统会自动恢复进程。
5. 极端情况的处理
若多次重启仍无法完成初始化,可能是系统包损坏。可进入手机设置 → 应用管理 → AstrBotApp → 清除应用数据,然后重新启动。
6. 特例警告
当终端输出显示正在安装系统软件包(而非uv、napcat等资源下载)时,务必避免中断操作。

一、首次初始化期间
理论上支持息屏和切换后台,但建议保持屏幕常亮并人工监视日志输出,方便快速排查问题。
二、初始化完成后
机器人可稳定在后台运行,息屏或切换App都不影响服务,只要保证通知栏的常驻通知不被关闭即可。
1. 可自由接入主流大语言模型,社区插件支持一键安装。
2. 能扩展群管理、智能问答、内容生成等多样化功能,操作灵活。
3. 安装完成后简单配置,即可拥有专属的AI QQ机器人。
4. 无需额外购置硬件,一部手机就能部署和使用专属AI机器人。
5. 从账号添加到模型接入,每一步都有清晰指引,降低了使用门槛。
6. 可根据预算与需求灵活选择不同模型服务,获得差异化的智能交互体验。
最新评论