请确认自己的版本是不是最新版，不是最新版请先更新最新版！！！
请确认自己的版本是不是最新版，不是最新版请先更新最新版！！！
请确认自己的版本是不是最新版，不是最新版请先更新最新版！！！
泡泡版为beta6.1.0及以上；
沙盒本体版本为v0.3.5及以上；
沙盒皮肤版本为beta5.6.0及以上。
1、在线下载失败
下载失败99%是网络问题，如果你无法解决网络问题，最最最最推荐的办法，直接使用离线下载。
如何离线下载
5个组件分别选择对名字应的离线包导入就行。离线包不要自己解压
如何获取离线安装包
github：网页链接
关注进群，在群文件获取
选择离线安装后，找不离线包
离线包是下载到手机存储，具体下载到什么路径没有唯一答案，请自行解决。这里只提醒两点：
在QQ群下载后，还需要选择保存到手机
点击离线安装后，如果显示“无任何文件”，大概率是进入了最近文件页面，请先进入手机存储文件夹
为什么点安装后没有离线安装选项
你不是最新版
2、Astrbot账号密码错误
默认账号与密码都是 astrbot
如果忘记账号，重启Astrbot并在终端查看
如果密码错误请按照下面步骤修改密码：
终端-右上角菜单-新建终端
输入下面脚本，并确定：
cd /root/AstrBot && .venv/bin/python -m astrbot.cli init
如果上一步脚本执行后提示输入[Y/n],，请输入Y并确定，未提醒则直接下一步
输入脚本，并确定：
.venv/bin/python -m astrbot.cli password
输入新密码，并确定（注意此处输入会被隐藏，并不是输入不进去，需要进行盲输，如果不确定自己输了什么就多点几次删除键，重新输入）
重复一遍新密码，并确定
当弹出Dashboard password updated.说明密码修改成功，否则说明输入的密码不符合规范。请自行翻译报错原因。（提示：密码需要大于等于8位，且至少含有一个大写字母，两次输入密码必须保持一致）
3、QQ无法登录
提示二维码过期：请在主页删除账号，重新创建
提示“为了保证你的账号安全，本次请求不支持图片识别或长按扫描二维码授权，请通过摄像头扫一扫重新授权登录。”
QQ不支持相册读取二维码的方式登录，只能使用摄像头，意味着你必须将二维码放在你的摄像头能拍到的位置。你可以：
使用另一台设备进行扫码
将码发到其他带屏幕的设备上，进行扫码
利用两面镜子反射，手机开分屏，进行单设备扫码
码扫不上/扫了没反应/其他无法扫码登录的情况
运行Napcat的webUI后进行扫码
如何更换BOT的QQ号
参考二维码过期的处理方式，删掉账号并新建
4、Napcat问题
需要两个QQ号吗？
一般来说需要，Napcat登录的是你的小号。机器人会使用这个号与你的大号聊天。
QQ时不时被踢下线，需要重新扫码
这是tx风控，目前没有什么好办法，只能养号。可以参考其他up主的视频：小号别再被封了！QQ机器人风控防范指南（新人必看）
没有小号怎么办
如果你只有一个账号，或者账号一直被tx风控。可以尝试申请一个QQ的官方BOT。部署方式见：https://docs.astrbot.app/platform/qqofficial/websockets.html
Napcat的webUI登录token是什么
点这个球能直接登录webUI无需输入token
点最后三个点的按钮，里面也能自行复制token
终端报错“反向WebSocket连接错误，在5秒后尝试重新连接
请确认Astrbot已经成功启动，如果仍然报错，关闭APP，重新打开后，先启动Astrbot，等待完全启动成功后，再运行Napcat。
5、Astrbot相关问题
如何下载插件
在webUI中点左上角导航栏，找到“插件”-“插件市场”下载自己需要的插件，如果插件市场打不开可能需要魔法
如何重置对话/清空记忆
对bot发送：/reset （注意，如果你在设置里修改了唤醒词，请将“/”换成对应的唤醒词）
webUI界面划不动/显示不全/卡顿
右上角菜单-在浏览器中打开
如何更换人设
webUI-配置文件-AI-人格-选择人格
进行修改或更换。注意修改或更换人格不会删除记忆，就算全面修改了人格，但是记忆还是上一份人格留下的记忆，如果不清除记忆，会导致两份人格串味。请视情况决定是否需要清除记忆。清除记忆方式见上文。修改后需要点击保存才能生效
如何设置白名单
webUI-配置文件-访问控制-白名单
白名单可以输入QQ群号，对整个群生效。但对个人不可以输入QQ号，而是填UMO号，输入/sid可以查询UMO。
其他功能
Astrbot的功能很强大，社区也很丰富，可以实现让BOT控制你的电脑，帮你玩游戏，主动发说说，主动逛社区等等。如果你想深入研究，请加入Astrbot的官方社区（https://docs.astrbot.app/community.html）
6、BOT相关问题
软件在后台BOT不回复，一切到前台就能回复
因为系统将软件的后台限制了，不同系统限制策略不同，很难一步到位，请尽量按照下面的步骤进行设置
电池优化设置不限制后台
应用设置开启自启动，并允许通知
关闭省电模式
开发者选项中将后台进程限制设置为4个或者更多，并开启停止限制子进程
BOT完全不回复
在设置中点击“自诊断”，确保结果全绿
BOT回复慢
请先确认的确是回复慢，而不是第一种前台回复后台不回复的情况
回复慢有多种可能，请自行排查：
模型本身延迟高
安装太多插件
网络不通畅
7、API key如何获取
不同模型的供应商不同，获取方式也不同。可以自行询问AI，查询教程。 这里分享一个DeepSeek的API key获取教程超简单的DeepSeek-APIKey获取教程 （跟着做前三步就获取成功了）
8、鸿蒙系统可以用吗
不可以
