AstrBot：轻松将大模型接入QQ、微信等消息平台，打造多功能AI聊天机器人的开发框架，附详细教程

最新推荐文章于 2025-03-21 09:15:00 发布

蚝油菜花

最新推荐文章于 2025-03-21 09:15:00 发布

阅读量3.7k

点赞数 33

分类专栏：每日 AI 项目与应用实例文章标签：微信人工智能机器人人工智能开源

本文链接：https://blog.csdn.net/qq_19841021/article/details/145536247

版权

每日 AI 项目与应用实例专栏收录该内容

659 篇文章

订阅专栏

❤️ 如果你也关注 AI 的发展现状，且对 AI 应用开发感兴趣，我会每日分享大模型与 AI 领域的开源项目和应用，提供运行实例和实用教程，帮助你快速上手AI技术！

🥦 微信公众号｜搜一搜：蚝油菜花 🥦

大家好，我是蚝油菜花，今天跟大家分享一下 AstrBot 这个开源的多消息平台聊天机器人及开发框架。

🚀 快速阅读

AstrBot 是一个多平台聊天机器人及开发框架，支持多种大语言模型和消息平台。

核心功能：支持 OpenAI GPT、Google Gemini、Llama 等大语言模型，以及 QQ、Telegram、微信等消息平台。
技术原理：基于异步通信架构、事件驱动机制和流水线处理，确保高效稳定的系统性能。

AstrBot 是什么

AstrBot

AstrBot 是一个开源的多平台聊天机器人及开发框架，支持多种大语言模型（如 OpenAI GPT、Google Gemini、Llama 等）和多种消息平台（如 QQ、Telegram、微信等）。它具备多轮对话、语音转文字、网页搜索等功能，提供代码执行器和可视化管理面板，方便用户配置和扩展。

AstrBot 基于模块化设计，支持插件开发，能一键部署到多种环境（如 Docker、Windows、Replit 等），具有高稳定性和可扩展性。

AstrBot 的主要功能

多语言模型支持：支持 OpenAI GPT、Google Gemini、Llama、DeepSeek、ChatGLM 等多种大语言模型，且支持基于 Ollama 和 LLMTuner 接入本地部署的大模型。
多平台接入：支持 QQ（OneBot）、QQ频道、微信（Gewechat、企业微信）、Telegram 等消息平台，后续将支持钉钉、飞书、Discord 等。
Agent 功能：原生支持代码执行器、自然语言待办事项、网页搜索等功能，能对接 Dify 平台，实现智能助手和知识库的接入。
插件扩展：提供深度优化的插件机制，支持开发者基于插件扩展功能，降低开发门槛。
可视化管理：提供可视化面板，支持配置修改、插件管理、日志查看等功能，集成 WebChat，在面板上与机器人直接对话。
多模态交互：支持图片理解和语音转文字（Whisper），具备多轮对话和人格情境功能。

AstrBot 的技术原理

异步通信架构：基于异步编程模型，高效处理多平台的消息交互，提升系统响应速度和并发处理能力。
事件驱动机制：基于事件总线设计，将消息接收、处理和发送解耦，让各个模块独立运行，提高系统的灵活性和可扩展性。
流水线处理：消息处理采用流水线模式，将消息解析、预处理、模型调用、后处理等步骤按顺序执行，便于功能扩展和维护。
插件系统：基于插件机制，开发者能轻松扩展机器人功能。插件支持独立开发和部署，不影响主程序运行。
多语言模型接入：支持多种大语言模型的接入，基于标准化的接口与不同模型进行通信，实现灵活的模型切换和扩展。

如何使用 Docker 部署 AstrBot

环境准备

在开始部署 AstrBot 之前，请确保您的环境中已经安装了 Docker。如果尚未安装，请参考Docker 文档进行安装。

如果您在中国大陆，可能无法正常拉取 Docker 镜像。建议使用国内镜像源，或者在 Docker 设置中配置代理。可以参考国内可用 Docker 镜像源汇总。

Docker 文档：https://docs.docker.com/get-docker/
国内可用 Docker 镜像源汇总：https://www.coderjia.cn/archives/dba3f94c-a021-468a-8ac6-e840f85867ea

通过 Docker Compose 部署

1. 克隆 AstrBot 仓库

首先，使用以下命令将 AstrBot 仓库克隆到本地：

git clone https://github.com/Soulter/AstrBot
cd AstrBot

2. 运行 Docker Compose

接下来，使用 docker compose 命令启动 AstrBot：

sudo docker compose up -d

注意：在 Windows 系统上不需要使用 sudo。

3. 配置沙箱代码执行器（可选）

默认情况下，docker-compose.yml 文件没有映射宿主机的 docker.sock 文件，因此无法使用沙箱代码执行器。如果您需要使用沙箱代码执行器，可以在 docker-compose.yml 文件中添加以下内容：

volumes:
  - /var/run/docker.sock:/var/run/docker.sock

通过 Docker 部署

1. 创建目录并运行容器

如果您不想使用 Docker Compose，可以直接通过 Docker 命令来部署 AstrBot。首先，创建一个目录用于存储数据：

mkdir astrbot

然后，使用以下命令启动 AstrBot 容器：

sudo docker run -itd -p 6180-6200:6180-6200 -p 11451:11451 -v $PWD/data:/AstrBot/data --name astrbot soulter/astrbot:latest

注意：在 Windows 系统上不需要使用 sudo。

2. 查看日志

通过以下命令查看 AstrBot 的日志输出：

sudo docker logs -f astrbot

3. 配置沙箱代码执行器（可选）

如果您需要使用沙箱代码执行器，可以在启动容器时添加以下参数：

sudo docker run -itd -p 6180-6200:6180-6200 -p 11451:11451 -v $PWD/data:/AstrBot/data -v /var/run/docker.sock:/var/run/docker.sock --name astrbot soulter/astrbot:latest