AstrBot安卓版官方最新版

AstrBot多平台聊天机器人及开发框架，支持多种大语言模型，AstrBot具备多轮对话、语音转文字、网页搜索等功能，提供代码执行器和可视化管理面板，方便用户配置和扩展。AstrBot 基于模块化设计，支持插件开发，能一键部署到多种环境。

AstrBot官网：https://astrbot.app/

GitHub仓库：https://github.com/Soulter/AstrBot

什么是AstrBot

AstrBot 是一个易于上手的多平台聊天机器人及开发框架。通过它，你能够在多种消息平台上部署一个支持大语言模型（LLM）的聊天机器人。并以此实现但不限于 AI 知识库问答、角色扮演、群聊管理、LLM Agent 等功能。

可以灵活将 AstrBot 配置为理想的 AI 伴侣、高效的 智能客服，或专业的企业知识库。通过 AstrBot，你能够轻松地在各种主流消息平台上部署和开发支持大语言模型（LLM）的智能聊天机器人。

AstrBot功能介绍

多语言模型支持：

支持 OpenAI GPT、Google Gemini、Llama、DeepSeek、ChatGLM 等多种大语言模型，且支持基于 Ollama 和 LLMTuner 接入本地部署的大模型。

多平台接入：

支持 QQ（OneBot）、QQ频道、微信（Gewechat、企业微信）、Telegram 等消息平台，后续将支持钉钉、飞书、Discord 等。

Agent 功能：

原生支持代码执行器、自然语言待办事项、网页搜索等功能，能对接 Dify 平台，实现智能助手和知识库的接入。

插件扩展：

提供深度优化的插件机制，支持开发者基于插件扩展功能，降低开发门槛。

可视化管理：

提供可视化面板，支持配置修改、插件管理、日志查看等功能，集成 WebChat，在面板上与机器人直接对话。

多模态交互：

支持图片理解和语音转文字（Whisper），具备多轮对话和人格情境功能。

高稳定性与模块化：

基于事件总线和流水线架构设计，高度模块化，低耦合，便于扩展和维护。

AstrBot应用优势

完善的 Agentic 能力

支持多轮工具调用、内置沙盒代码执行、网页搜索，实现高阶任务处理。

LLM 对话引擎

接入多种大模型，支持多模态、工具调用、原生知识库和人设定制。

广泛平台支持

一键部署至 QQ、企业微信、微信公众号、飞书、Telegram、钉钉、Discord 等主流平台，提供安全与稳定保障。

插件与 WebUI

深度优化插件扩展机制，以及可视化 WebUI 进行配置和管理。

AstrBot常见问题

安装相关

Windows安装失败

Windows出现venv安装失败、启动失败，请优先尝试手动uv部署。

Linux安装失败

可能是因为python版本不兼容。Astrbot兼容python3.10~3.13版本，如果需要排查，请自行搜索（或者问AI，豆包、deepseek都可以）

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

管理面板相关

当管理面板打开时遇到 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 本体相关

机器人在群聊无法聊天

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

没有权限操作管理员指令

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

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

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

1、检查 API-key 是否仍然有效

2、检查是否达到 API 调用限制或配额

3、检查网络连接

4、尝试 reset

5、降低最大对话次数设置

6、切换使用同一供应商的其他模型/不同供应商的模型