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/astrbotPython 安装
pip install astrbot
astrbot桌面端
提供 Windows/macOS 桌面应用,带图形界面管理。
🛠️ 配置与使用
启动后访问 http://localhost:6185 进入 WebUI:
- 配置 AI 提供商:支持 OpenAI、Claude、Gemini、DeepSeek 等,也兼容 OpenAI 格式接口
- 接入聊天平台:填写对应平台的 Bot Token
- 安装插件:从插件市场一键安装所需功能
- 设置知识库:上传文档,配置检索参数
配置完成后,机器人就会在指定平台响应消息了。
🔌 插件生态
官方插件市场已有 1000+ 插件,涵盖:
- 工具类:网页搜索、代码执行、图像生成
- 娱乐类:表情包、语音合成、角色扮演
- 生产力:RSS 订阅、定时提醒、群管功能
- 开发类:GitHub 通知、API 调试、日志监控
插件使用 Python 编写,有完整的开发文档,可以自定义私有插件。
⚠️ 注意事项
- 微信个人号接入需要额外配置,建议使用企业微信或公众号
- 部分平台(如 QQ)需要申请开发者权限
- 知识库检索质量取决于文档质量和分块策略
- 插件运行在沙箱中,但仍建议审查代码安全性
✅ 总结
AstrBot 是目前功能最完整的开源 AI 机器人框架之一。多平台支持、MCP 协议、知识库、插件生态,该有的都有。
适合场景:
- 个人:搭建专属 AI 助手,管理多个聊天账号
- 团队:群聊机器人、自动化工作流、信息聚合
- 开发者:快速原型验证、自定义 Bot 功能
GitHub 目前 1.2k+ Stars,周活跃用户 20 万+,社区活跃度不错。想部署自己的 AI 助手,值得一试。