
现在打开手机,QQ、微信、飞书、钉钉……每个群的消息都满天飞,光看记录就够人头疼了。要是 AI 能直接“住”在聊天软件里,随叫随到,那该多省心?
还真有人认认真真做了这件事。
项目简介
AstrBot 是一个开源的 AI Agent 助手平台,不是“套个 GPT 机器人”那么简单。它把 IM 平台、大模型、插件、知识库和 Agent 编排整合到了一起。

QQ、微信、飞书、钉钉、Telegram、Discord、Slack,主流 IM 基本全覆盖,也有官方维护的平台适配器列表。

模型支持同样丰富:OpenAI、Anthropic、Gemini、DeepSeek、智谱、Ollama 等等,还能对接 Dify、阿里云百炼、Coze 这些 Agent 平台。如果你在多个模型 API 之间来回切换、管理起来很麻烦,也可以搭配 RouteFast.ai 这类模型 API 聚合中转服务,统一接入会省不少事。
插件生态超过 1000 个,一键安装。个人玩梗、群管、客服、企业知识库,都能搭起来。
GitHub 上已经拿了 4w+ star,社区相当活跃。

功能特性
01 多平台接入,一套能力到处跑
这是 AstrBot 最实在的地方。
不需要为每个平台单独写一套逻辑。接一次,QQ 能用,飞书能用,企业微信也能用。官方维护的平台列表拉出来一大串,连 Satori、KOOK、Misskey 这类相对小众的都支持。
02 它是 Agent,不只是“聊天”
内置 Agent 运行时,支持工具调用、子智能体、复杂工作流和上下文管理。原生支持 MCP 和 Skills,可以把外部能力标准化地接进来。
更关键的是 Agent 沙盒——代码执行、Shell 调用全部跑在隔离环境里,还能按时复用会话资源。跑得开,也关得住。

再配合定时任务和运行时控制,它能在你没盯着的时候把活干完。
03 知识库,让它真懂你的数据
内置知识库系统,用 Microsoft Markitdown 解析 PDF、DOCX、Markdown,把文档转换成 Agent 能读懂的知识。
检索上采用混合检索:稠密向量 + 稀疏检索(BM25)结合,中文和跨语言场景下命中率更稳。一次对话还能同时引用多个知识库。

文档拖进去就行,TXT、PDF、Markdown 都支持,单个文件最大 128MB,分块参数也可以自己调。
04 1000+ 插件,一键装完
插件是 AstrBot 最活跃的部分。
官方插件市场已经有 1000+ 插件,面板里点一下就能装,覆盖效率工具、群管理、内容处理、外部服务对接等场景。

插件、MCP 服务器、Skills、扩展市场,全在同一个工作区里管理,不用到处翻菜单。
05 会记得你,也像个人
AstrBot 还有一个挺有人情味的方向:情感陪伴。
它支持分段回复,模仿真人聊天的节奏,不再是一大段砸过来。配合插件还能做主动对话、长期记忆、亲密度系统、用户画像,聊得越久它越懂你。

快速安装、使用
AstrBot 提供了好几种部署方式,挑一个适合你的。
uv 一键部署(推荐给熟悉命令行的朋友):
uv tool install astrbot --python 3.12
astrbot init
astrbot run
首次运行 astrbot init 初始化环境,之后 astrbot run 启动。
更新也简单:
uv tool upgrade astrbot --python 3.12
macOS 用户注意:第一次跑 astrbot 命令会慢一点,大概 10-20 秒,是系统安全检查导致的,属正常现象。
升级:
uv tool upgrade astrbot --python 3.12
其他部署方式:
- Docker / Docker Compose:适合长期稳定运行、部署在服务器上的场景
- 桌面版(AstrBot App):想当本地应用用、主要以 ChatUI 为主的话选它
- Launcher:桌面用户想多实例、隔离运行选它
- 面板部署:宝塔、1Panel、CasaOS 都有现成的应用商店方案
启动后浏览器打开 WebUI 面板,剩下的配置基本都能在界面里点。
模型提供商、平台适配器、插件、知识库、人设,全是图形化管理,不用碰配置文件。
写在最后
AstrBot 这个项目,把“AI 助手”这件事想得挺明白。
它不只是一个聊天机器人框架,更像是一个 Agent 运行平台。多平台接入、沙箱执行、知识库、插件生态,该有的都有。代码开源,文档完整,社区也在持续更新。
如果你想让 AI 住进你的聊天软件里,帮你干点实事,AstrBot 值得试试。对这类开源工具感兴趣的话,也可以到 云栈社区 和更多开发者一起交流。
https://github.com/AstrBotDevs/AstrBot