AstrBot：易上手的多平台 LLM 聊天机器人及开发框架

如果你想快速搭建一个支持多平台、插件扩展和多种 LLM 接入能力的聊天机器人框架，AstrBot 是一个相当容易上手的选择。

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

主要亮点

  1. 大语言模型对话
    支持各种大语言模型，包括 OpenAI API、Google Gemini、Llama、Deepseek、ChatGLM 等；也支持通过 Ollama、LLMTuner 接入本地部署模型。具备多轮对话、人格情境、多模态能力，并支持图片理解、语音转文字（Whisper）。

  2. 多消息平台接入
    支持接入 QQ（OneBot）、QQ 频道、微信（Gewechat）、飞书、Telegram，后续还将支持钉钉、Discord、WhatsApp、小爱音响。同时支持速率限制、白名单、关键词过滤、百度内容审核。

  3. Agent 能力
    原生支持部分 Agent 能力，如代码执行器、自然语言待办、网页搜索。还能对接 Dify 平台，方便接入 Dify 智能助手、知识库和工作流。

  4. 插件扩展
    深度优化的插件机制，支持 开发插件 扩展功能，开发体验相对轻量，目前也已经支持安装多个插件。

  5. 可视化管理面板
    支持可视化修改配置、插件管理、日志查看等功能，降低配置难度；并集成 WebChat，可直接在面板中与大模型对话。

  6. 高稳定性与高模块化
    基于事件总线和流水线的架构设计，整体模块化程度高、耦合度低，更适合后续持续扩展。

使用方式

Docker 部署

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

Windows 一键安装器部署

需要电脑上安装有 Python（>3.10）。请参阅官方文档：使用 Windows 一键安装器部署 AstrBot

Replit 部署

直接访问：https://repl.it/github/Soulter/AstrBot

CasaOS 部署

社区贡献的部署方式。

请参阅官方文档：通过 CasaOS 部署 AstrBot

手动部署

请参阅官方文档：通过源码部署 AstrBot

🚀 路线图

垂类功能方向

  1. 更好的上下文管理：限制 token 总数、对话上下文总结

  2. AstrBot in Minecraft

平台与能力扩展

⚡ 消息平台支持情况

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

⚡ 提供商支持情况

名称 支持性 类型 备注
OpenAI API ✔ 文本生成 同时也支持 DeepSeek、Google Gemini、GLM（智谱）、Moonshot（月之暗面）、阿里云百炼、硅基流动、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 ✔ 文本转语音
Fishaudio ✔ 文本转语音 GPT-Sovits 作者参与的项目
Edge-TTS ✔ 文本转语音 Edge 浏览器的免费 TTS

小结

如果你需要一个兼顾多平台接入、插件扩展、Agent 能力和多模型兼容性的聊天机器人框架，AstrBot 的完成度已经比较高，尤其适合想快速落地机器人应用的人先跑起来再逐步扩展。