AstrBot - 易于上手的跨平台 LLM 聊天机器人及开发框架

---

---

一、关于 AstrBot

AstrBot 是一个松耦合、异步、支持多消息平台部署、具有易用的插件系统和完善的大语言模型（LLM）接入功能的聊天机器人及开发框架。

---

✨ 近期更新

1、AstrBot 现已支持接入 MCP 服务器！

---

✨ 主要功能

注：我们正基于前沿科研成果，设计并实现适用于角色扮演和情感陪伴的长短期记忆模型及情绪控制模型，旨在提升对话的真实性与情感表达能力。敬请期待 v3.6.0 版本！

1、大语言模型对话。支持各种大语言模型，包括 OpenAI API、Google Gemini、Llama、Deepseek、ChatGLM 等，支持接入本地部署的大模型，通过 Ollama、LLMTuner。具有多轮对话、人格情境、多模态能力，支持图片理解、语音转文字（Whisper）。
2、多消息平台接入。支持接入 QQ（OneBot）、QQ 频道、微信（Gewechat）、飞书、Telegram。后续将支持钉钉、Discord、WhatsApp、小爱音响。支持速率限制、白名单、关键词过滤、百度内容审核。
3、Agent。原生支持部分 Agent 能力，如代码执行器、自然语言待办、网页搜索。对接 Dify 平台，便捷接入 Dify 智能助手、知识库和 Dify 工作流。
4、插件扩展。深度优化的插件机制，支持开发插件扩展功能，极简开发。已支持安装多个插件。
5、可视化管理面板。支持可视化修改配置、插件管理、日志查看等功能，降低配置难度。集成 WebChat，可在面板上与大模型对话。
6、高稳定性、高模块化。基于事件总线和流水线的架构设计，高度模块化，低耦合。

---

相关链接资源

• 官网：https://astrbot.app/
• github : https://github.com/AstrBotDevs/AstrBot
• gitcode : https://gitcode.com/Soulter/AstrBot
• 官方文档：https://astrbot.app/what-is-astrbot.html
• WebUI 在线体验 Demo: https://demo.astrbot.app/
  用户名: astrbot, 密码: astrbot
• 社区：Discord | Telegram(https://t.me/+hAsD2Ebl5as3NmY1)
• 🌟 支持 ：爱发电 | 微信

---

实现方式

下面的拓扑图简述了 AstrBot 与插件、消息平台适配器、语言模型提供商、消息协议实现端的关系。

---

二、使用方式✨

---

Docker 部署

请参阅官方文档 使用 Docker 部署 AstrBot 。

---

Windows 一键安装器部署

请参阅官方文档 使用 Windows 一键安装器部署 AstrBot 。

---

宝塔面板部署

请参阅官方文档 宝塔面板部署 。

---

CasaOS 部署

社区贡献的部署方式。

请参阅官方文档 CasaOS 部署 。

---

手动部署

推荐使用 uv。

git clone https://github.com/AstrBotDevs/AstrBot && cd AstrBot
pip install uv
uv run main.py

---

---

或者请参阅官方文档 通过源码部署 AstrBot 。

---

Replit 部署

https://repl.it/github/Soulter/AstrBot

---

三、支持情况⚡

消息平台支持情况

平台	支持性	详情	消息类型
QQ(官方机器人接口)	✔	私聊、群聊，QQ 频道私聊、群聊	文字、图片
QQ(OneBot)	✔	私聊、群聊	文字、图片、语音
微信(个人号)	✔	微信个人号私聊、群聊	文字、图片、语音
Telegram	✔	私聊、群聊	文字、图片
微信(企业微信)	✔	私聊	文字、图片、语音
飞书	✔	私聊、群聊	文字、图片
钉钉	✔	私聊、群聊	文字、图片
微信对话开放平台	🚧	计划内	-
Discord	🚧	计划内	-
WhatsApp	🚧	计划内	-
小爱音响	🚧	计划内	-

---

提供商支持情况

名称	支持性	类型	备注
OpenAI API	✔	文本生成	也支持 DeepSeek、Google Gemini、GLM、Kimi、硅基流动、xAI 等兼容 OpenAI API 的服务
Claude API	✔	文本生成
Google Gemini API	✔	文本生成
Dify	✔	LLMOps
DashScope(阿里云百炼应用)	✔	LLMOps
Ollama	✔	模型加载器	本地部署 DeepSeek、Llama 等开源语言模型
LM Studio	✔	模型加载器	本地部署 DeepSeek、Llama 等开源语言模型
LLMTuner	✔	模型加载器	本地加载 lora 等微调模型
OneAPI	✔	LLM 分发系统
Whisper	✔	语音转文本	支持 API、本地部署
SenseVoice	✔	语音转文本	本地部署
OpenAI TTS API	✔	文本转语音
GSVI	✔	文本转语音	GPT-Sovits-Inference
Fishaudio	✔	文本转语音	GPT-Sovits 作者参与的项目
Edge-TTS	✔	文本转语音	Edge 浏览器的免费 TTS

---

开发环境

AstrBot 使用 ruff 进行代码格式化和检查。

git clone https://github.com/Soulter/AstrBot
pip install pre-commit
pre-commit install

---

---

四、Demo✨

✨基于 Docker 的沙箱化代码执行器（Beta 测试）✨

---

✨ 多模态、网页搜索、长文本转图片（可配置） ✨

---

---

✨ 插件系统——部分插件展示 ✨

---

✨ WebUI ✨

---

伊织 xAI 2025-05-01（二）