AstrBot 是开源、一站式 Agentic 多平台 AI 聊天助手（Python 开发），定位不是单纯聊天机器人框架，而是带智能体运行时、RAG 知识库、插件生态、Web 管理后台的完整对话 AI 基础设施，可直接部署在 IM 聊天软件内，用于个人 AI 助手、群机器人、私有知识库、智能客服等场景。
项目组织：AstrBotDevs，开源免费，社区驱动。
一、核心架构（事件总线 + 流水线模型）
整体模块化，基于事件总线 EventBus驱动消息流转，所有组件解耦，插件、平台适配器、模型服务都可以独立启停 / 热重载：
- 消息适配器层：统一消息抽象 UMO，对接各类 IM 平台，屏蔽不同聊天软件 API 差异；
- 事件总线：消息进来后分发到流水线、插件、Agent；
- AI 核心层：LLM 模型调度器、Agent 引擎、MCP、RAG 知识库、人格 (Persona) 管理器；
- 插件 / 技能层：插件市场 + Skills + MCP 工具协议；
- Web 后台层：管理面板 + 独立 Web Chat 对话界面；
- Agent 沙箱：隔离安全环境，执行代码、Shell、工具调用，防止恶意代码破坏主机；
- 定时任务模块：内置 Cron，支持定时消息、自动化任务。
二、核心能力
1. 多 IM 平台接入（18 + 适配器）
支持：QQ（OneBot/NapCat）、企业微信、飞书、钉钉、Telegram、Discord、Slack 等，单实例同时挂载多个机器人，一套配置跑多个 IM 渠道。
2. 全模型兼容 + 多模态
- 兼容 OpenAI、DeepSeek、Claude、Gemini、Ollama 本地模型、阿里云百炼等几乎所有 OpenAI 兼容 API；
- 支持图片理解、图文多模态；
- 模型故障自动回落：主模型挂了自动切备用模型；
- 自动上下文压缩：长对话自动摘要，控制 token 开销，避免上下文溢出；
- 人格 Persona 管理：可预设多套角色设定，会话切换人格。
3. Agent 智能体（核心亮点）
- 原生工具调用、网页搜索、多步骤工作流编排；
- SubAgent 子智能体：主 Agent 把任务委派给专业子 Agent（实验特性），拆分复杂任务，降低主模型提示词负担；
- MCP 协议原生支持：MCP（Model Context Protocol），可以快速接入大量外部工具能力；
- Agent 沙箱：安全隔离环境执行 Python 代码、Shell 命令；
- 运行时控制：支持中途停止 Agent 任务、动态注入提示词；
- Cron 定时任务，支持定时推送、自动化巡检。
4. 内置 RAG 知识库（开箱即用，无需额外向量库）
- 文件解析：Microsoft Markitdown，支持 PDF、DOCX、Markdown；
- 混合检索：BM25 稀疏检索 + 向量稠密检索，针对中文优化；
- 多知识库同时挂载，同一个对话会话可以引用多个知识库；
- 直接上传文档，即可实现私有文档问答。
5. 插件生态
- 社区插件市场，上千款插件一键安装，支持插件热重载，不用重启主程序；
- 常见插件：文生图、翻译、代码执行、群管、RSS 订阅、联网搜索、游戏、提醒；
- 提供插件 SDK，开发者可以快速编写自定义插件。
6. Web 可视化管理面板
- Web Dashboard：模型配置、IM 适配器管理、知识库上传、插件市场、日志、Token 用量监控；
- 独立 Web ChatUI：类似 OpenWebUI，浏览器直接对话，可以单独分享对话页面；
- 内置管理员指令：
/reset清空上下文、/stop终止 Agent 任务、/new新建会话、/stats查看 token 消耗、/help查看指令等。
三、部署方式（多方案可选）
- Windows 一键启动器：最简单，适合本地个人使用；
- Docker / Docker Compose：服务器首选；
- pip 安装：
pip install AstrBot，适合开发者； - 源码部署；
- 已适配宝塔、1Panel 等面板一键部署镜像。
环境：Python ≥3.10
四、典型使用场景
- 个人 IM AI 助手：QQ/Telegram 私聊 AI，文档问答；
- 群聊机器人：群内问答、群管理、定时推送；
- 私有知识库：上传公司 / 笔记文档，IM 内直接检索问答；
- 轻量智能客服；
- Agent 自动化：联网查询、代码运行、定时任务；
- 角色扮演 AI。
五、优缺点总结
✅ 优点
- 一站式打包，RAG、Agent、MCP、WebUI 全部内置，不用自行拼接多个开源项目；
- 中文原生优化；
- 多 IM 统一抽象，一套逻辑同时跑多个聊天平台；
- 插件热加载，上手门槛低，新手可视化操作；
- 可对接 Dify、Coze、百炼等外部 Agent 应用。
❌ 缺点
- Agent 沙箱有安全风险，公网部署需要做好权限隔离；
- SubAgent 子智能体还属于实验功能；
- 知识库是内置轻量向量方案，超大规模文档场景性能不如独立向量数据库（Milvus/Chroma）。
六、和同类项目简单对比
| 项目 | 定位 | 特点 |
|---|---|---|
| AstrBot | 一站式 Agent 机器人平台 | 内置 RAG、MCP、WebUI、沙箱，IM 多平台，开箱即用 |
| NoneBot | Python 机器人开发框架 | 偏底层框架，RAG/Agent 需要自己集成 |
| OpenWebUI | 网页对话 UI | 只 Web 界面，没有 IM 机器人能力 |
七、官方地址
- 官网：https://astrbot.app/
- 文档：https://docs.astrbot.app/
- GitHub：AstrBotDevs/AstrBot