AstrBot 是一款开源 AI 聊天机器人框架,支持 QQ、微信、Telegram、Discord 等 10+ 平台接入。内置 MCP 协议、知识库系统、子代理沙箱,1000+ 插件生态,几行配置即可部署你的专属 AI 助手。

🤔 引言

想在自己的 QQ 群、微信群或 Telegram 频道里部署一个 AI 助手?市面上方案不少,但要么收费昂贵,要么配置复杂。

AstrBot 是个开源的 AI 聊天机器人框架,支持 10+ 主流平台接入,自带插件市场和 MCP 协议支持。不用写代码,几行配置就能跑起来。


⭐ 核心功能

多平台接入

支持 QQ、微信生态(个人号/企业微信)、Telegram、Discord、Slack、飞书、钉钉、KOOK 等。一个框架覆盖国内主流 IM 场景。

Agent 能力

不只是聊天。支持子代理(Sub-Agents)、工作流编排、工具调用、定时任务。可以搭建复杂的自动化流程。

MCP 协议原生支持

Model Context Protocol,让 AI 能调用外部工具和服务。官方插件市场已有 1000+ 插件,覆盖搜索、绘图、代码执行等场景。

知识库系统

内置 RAG 知识库,支持 PDF、Word、Markdown 等格式。混合检索(稠密+稀疏)针对中文做了优化。

子代理沙箱

隔离运行环境,防止插件或代理任务影响主系统稳定性。


📥 部署方式

AstrBot 提供了多种部署选项:

一键启动器(推荐新手)

Windows 用户下载 exe,双击运行即可。

Docker

docker pull soulter/astrbot:latest
docker run -d --name astrbot -p 6185:6185 soulter/astrbot

Python 安装

pip install astrbot
astrbot

桌面端

提供 Windows/macOS 桌面应用,带图形界面管理。


🛠️ 配置与使用

启动后访问 http://localhost:6185 进入 WebUI:

  1. 配置 AI 提供商:支持 OpenAI、Claude、Gemini、DeepSeek 等,也兼容 OpenAI 格式接口
  2. 接入聊天平台:填写对应平台的 Bot Token
  3. 安装插件:从插件市场一键安装所需功能
  4. 设置知识库:上传文档,配置检索参数

配置完成后,机器人就会在指定平台响应消息了。


🔌 插件生态

官方插件市场已有 1000+ 插件,涵盖:

  • 工具类:网页搜索、代码执行、图像生成
  • 娱乐类:表情包、语音合成、角色扮演
  • 生产力:RSS 订阅、定时提醒、群管功能
  • 开发类:GitHub 通知、API 调试、日志监控

插件使用 Python 编写,有完整的开发文档,可以自定义私有插件。


⚠️ 注意事项

  • 微信个人号接入需要额外配置,建议使用企业微信或公众号
  • 部分平台(如 QQ)需要申请开发者权限
  • 知识库检索质量取决于文档质量和分块策略
  • 插件运行在沙箱中,但仍建议审查代码安全性

✅ 总结

AstrBot 是目前功能最完整的开源 AI 机器人框架之一。多平台支持、MCP 协议、知识库、插件生态,该有的都有。

适合场景:

  • 个人:搭建专属 AI 助手,管理多个聊天账号
  • 团队:群聊机器人、自动化工作流、信息聚合
  • 开发者:快速原型验证、自定义 Bot 功能

GitHub 目前 1.2k+ Stars,周活跃用户 20 万+,社区活跃度不错。想部署自己的 AI 助手,值得一试。