AstrBot 开源 AI Agent 框架

AstrBot 是 AstrBotDevs 团队维护的开源一站式 Agent 聊天机器人平台，目前在 GitHub 上有约 4 万 star（40,075）、2,876 fork，采用 AGPL 协议。它的定位不是「又一个聊天机器人」，而是把大模型接入、工具调用、知识库、工作流和插件系统整合到一起，让你把 AI 能力直接装进已经在用的聊天平台里。

一、它解决的到底是什么问题

一句话定位：AstrBot 是「聊天平台 ↔ 大模型 ↔ 工具/知识库」之间的中间层。你在 QQ、飞书、企业微信里发一句话，它负责把消息交给大模型、按需调用工具或检索知识库，再把结果送回聊天窗口。

换句话说，它省掉的是你自己写「接 IM 协议 → 管会话 → 调模型 → 管插件」这一整套骨架的活。你要做的是配模型和插件，而不是从零搭框架。

二、核心能力清单

能力 说明
大模型对话官方列出 OpenAI、Anthropic（Claude）、Gemini 等主流模型接入
多模态支持图片等多模态输入
MCP / 工具调用支持 MCP 协议与 Agent 工具调用
知识库内置知识库，可做文档问答、企业知识库
Skills / 工作流技能与流程编排
Agent Sandbox隔离环境里安全执行代码、调用 Shell，支持会话级资源复用
人格设定可配置人设
上下文自动压缩长对话自动压缩，省 token
WebUI / ChatUI可视化管理面板 + 网页聊天界面（内置沙盒、网页搜索）

三、能接哪些聊天平台

官方文档和中文 README 列出的平台包括：QQ、企业微信、飞书、钉钉、微信公众号、Telegram、Slack、Discord 等。推文里提到的是 QQ、飞书、企业微信、Telegram、Slack，官方清单其实还多出钉钉、微信公众号和 Discord。

补一句：接入 QQ 这类平台通常需要配合 NapCat 等协议端，属于「AstrBot + 协议端」的组合，不是 AstrBot 单包搞定。部署前建议先看官方文档里对应平台的接入页。

四、插件生态：实际 1329 个

README 写的是「1000+ 插件可一键安装」，我们用官方插件市场的接口实际查了一下，当前数量是 1329 个 —— 推文说「超过 1000 个」没夸大，甚至偏保守。

除此之外，它还能接入 Dify、阿里云百炼、Coze 等智能体平台，等于把别人的 Agent 能力也当成一种扩展源。

五、怎么部署

官方给了三条路，按门槛从低到高排：

1）uv 一键部署（最快体验，需要装 uv）

1
2
3
uv tool install astrbot --python 3.12
astrbot init   # 仅首次执行，初始化环境
astrbot run

后续升级：

1
uv tool upgrade astrbot --python 3.12

2）Docker / Docker Compose（推荐生产环境）：官方有一整套 compose 方案，具体配置文件以官方文档的 Docker 部署页为准，不要照抄第三方博客里的旧 compose。

3）雨云一键云部署：不想自己管服务器、要 24 小时在线的，可以直接用官方推荐的云部署模板。

六、适合谁、不适合谁

适合
  • 想把 AI 接进 QQ / 飞书 / 企业微信等现有聊天平台的个人或小团队
  • 想要知识库 + 工具调用组合能力，但不想自己写框架骨架
  • 想本地或私有化部署、模型自己可控的场景
  • 喜欢用现成插件快速试功能的折腾型用户
不适合
  • 只想买一个开箱即用的 SaaS 客服产品、不想运维的人
  • 完全没有命令行和服务器基础、装环境都要人帮的纯新手
  • 需要闭源商用的场景 —— 它是 AGPL 协议，有传染性，商业集成前务必确认合规

七、值不值得研究

如果你的目标是「在 IM 里跑一个能调工具、能查知识库、能装插件的 Agent」，AstrBot 目前是同类里完成度相当高、且社区活跃（4 万 star）的选择，值得一试。

但别把它当成零门槛产品：部署、协议端对接、模型 Key 配置这几件事仍然要自己动手，AGPL 协议也需要提前看清。

AstrBot开源AGPL

开源一站式 AI Agent 聊天机器人框架，接入大模型与工具调用。

★ 40287
GitHub Star
⑂ 2902
Fork
AGPL
开源协议
AI Agent聊天机器人大模型