AstrBot/docs/zh/faq.md

FAQ

管理面板相关

当管理面板打开时遇到 404 错误

在 release 页面下载 dist.zip，解压拖到 AstrBot/data 下。还不行请重启电脑（来自群里的反馈）

管理面板的密码忘记了

如果你忘记了 AstrBot 管理面板的密码，你可以在 AstrBot/data/cmd_config.json 配置文件中找到 "dashboard" 字段进行修改，其中 "username" 是你的用户名，"password" 是你的密码（经过 MD5 加密）。

如果想要修改账号密码，你可以这样做：

1. 修改 "username" 字段，注意保留 ""；如果不想修改用户名，可以不修改
2. 进入网站：在线 MD5 生成
3. 在转换前文本框输入你的新密码
4. 选择 MD5 加密（32 位），请确认选择 32 位选项
5. 将转换后的字符粘贴至配置文件，注意保留 "", 且字母使用小写

AstrBot 使用相关

如何让 AstrBot 控制我的 Mac / Windows / Linux 电脑？

1. 在 AstrBot WebUI 的 配置 -> 普通配置 中，找到 使用电脑能力，运行环境选择 local。
2. 在 配置 -> 其他配置 中，找到 管理员 ID 列表，添加你的用户 ID（可以通过 /sid 指令获取）。
3. 右下角保存配置

Tip

AstrBot 为了安全起见，运行环境选择 local 时，默认仅允许 AstrBot 管理员使用电脑能力。 运行环境可以选择 sandbox，此时所有用户都可以使用电脑能力（在一个隔离的沙箱中）。详情请看 AstrBot 沙箱环境

通过 AstrBot 桌面客户端安装的 AstrBot，data 目录在哪？

在家目录下的 .astrbot 目录下。

• Windows: C:\Users\你的用户名\.astrbot
• MacOS / Linux: /Users/你的用户名/.astrbot 或者 /home/你的用户名/.astrbot

通过 AstrBot Launcher 安装的 AstrBot，data 目录在哪？

如果是旧版本的 AstrBot Launcher（Powershell），data 目录就在 Launcher bat 脚本的同级目录下。

如果是新版本的 AstrBot Launcher（可视化），data 目录在家目录下的 .astrbot_launcher 目录下。

• Windows: C:\Users\你的用户名\.astrbot_launcher
• MacOS / Linux: /Users/你的用户名/.astrbot_launcher 或者 /home/你的用户名/.astrbot_launcher

机器人在群聊无法聊天

1. 群聊情况下，由于防止消息泛滥，不会对每条监听到的消息都回复，请尝试 @ 机器人或者使用唤醒词来聊天，比如默认的 /，输入 /你好。

没有权限操作管理员指令

1. /reset, /persona, /dashboard_update, /op, /deop, /wl, /dewl 是默认的管理员指令。可以通过 /sid 指令得到用户的 ID，然后在 配置 -> 其他配置 中添加到管理员 ID 名单中。

本地渲染 Markdown 图片（t2i）时中文乱码

可以自定义字体。详见 -> #957

推荐 Maple Mono 字体。

API 返回的 completion 无法解析

这是由于供应商的 API 返回了空文本，尝试以下步骤：

1. 检查 API Key 是否仍然有效
2. 检查是否达到 API 调用限制或配额
3. 检查网络连接
4. 尝试 reset
5. 降低最大对话次数设置
6. 切换使用同一供应商的其他模型，或不同供应商的模型

插件相关

插件安装不上

1. 插件通过 GitHub 安装，在国内访问 GitHub 确实有时候连不上。可以挂代理，然后进入 其他配置 -> HTTP 代理 设置代理，或者直接下载插件压缩包后上传。

安装插件后报错 No module named 'xxx'

这个是因为插件依赖的库没有被正常安装。一般情况下，AstrBot 会在安装好插件后自动为插件安装依赖库，如果出现了以下情况可能造成安装失败：

1. 网络问题导致依赖库无法下载
2. 插件作者没有填写 requirements.txt 文件
3. Python 版本不兼容

解决方法：

结合报错信息，参考插件的 README 手动安装依赖库。你可以在 AstrBot WebUI 的 平台日志 -> 安装 Pip 库 中安装依赖库。

如果发现插件作者没有填写 requirements.txt 文件，请在插件仓库提交 Issue，提醒作者补充。

OneBot v11 实现端 NapCat 连接相关

我明明按照文档的步骤做了，为什么 NapCat 连不上 Astrbot？

1. 如果你两个全都是使用 Docker 部署，请尝试在终端运行：

sudo docker network create newnet           # 创建新网络 
sudo docker network connect newnet astrbot  
sudo docker network connect newnet napcat   # 让两个容器连到一起
sudo docker restart astrbot
sudo docker restart napcat                  # 重启容器

运行无报错则回到 NapCat 的 WebUI，网络配置中，将你之前填写的 ws://127.0.0.1:6199/ws 修改为 ws://astrbot:6199/ws。

2. 如果只有 NapCat 是 Docker 部署，请将 NapCat 的 WebUI 网络配置中的 ws://127.0.0.1:6199/ws 修改为 ws://宿主机IP:6199/ws（宿主机 IP 请自行搜索如何查看）。
3. 如果都不是 Docker 部署，则请将 NapCat 的 WebUI 网络配置中的 ws://127.0.0.1:6199/ws 修改为 ws://localhost:6199/ws 或 ws://127.0.0.1:6199/ws。