Skip to content

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. 将转换后的字符粘贴至配置文件, 注意保留""

Bot 本体相关

机器人在群聊无法聊天

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

没有权限操作管理员指令

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

本地渲染 Markdown 图片(t2i)时中文乱码

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

推荐 Maple Mono 字体。

API 返回的 completion 无法解析 & llm 返回<empty content>

这是由于供应商的 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,提醒作者补充。