📌 项目地址：AstrBotDevs/AstrBot | ⭐ 36,650 颗星 | 🔧 Python | 📜 未标注
这个项目能干什么
AstrBot 是一套对话机器人的管理平台。你把大模型接上去，把 QQ、企业微信、飞书、钉钉、微信公众号、Telegram、Slack 这些 IM 的机器人配置填进去，一个会话在多个渠道里同步。README 强调它是“all-in-one Agent chatbot platform”，我翻了一下功能列表：多模态、MCP（Model Context Protocol）、知识库、角色设定、自动上下文压缩，以及 Agent 沙箱。没找到第二个项目把这些全包在一起。
代码用 Python 写，GitHub 上 36650 个 Star。
五个我花时间研究的功能
Agent 沙箱
README 用 🛡️ 标记。沙箱里跑 rm -rf / 会报错，不会碰真系统。还支持会话级资源复用：同一段对话里，先问“查数据库”，再问“按日期分组”，沙箱保持数据库连接，不用重复认证。我自己没搭知识库，但文档给了一个例子：连续分析销售数据时可以复用 Elasticsearch 连接。
主动 Agent
普通的机器人是“你问它答”。AstrBot 的 Agent 可以按条件或定时主动发消息。配合 MCP 和技能，能做成自动告警：服务器磁盘超过 90% 时往飞书推一条消息。文档里有用法示例，但需要自己写触发逻辑。
MCP（Model Context Protocol）集成
MCP 是一个协议，让大模型能调用外部工具（如系统命令、API）。AstrBot 原生支持，意味着你在配置里挂一个 MCP 服务器，Agent 就能执行对应的操作。不是每个聊天机器人框架都支持 MCP，它解决的是“LLM 怎么安全地操作外部系统”的问题。
插件市场
WebUI 里有一个插件市场，一键安装。README 说“1000+ plugins available”。我没数，但随便翻了几页，确实很多。质量参差不齐：有些看起来很活跃，有些最后更新时间是一年前。装插件前最好看一眼仓库的 last commit。
多平台统一管理
README 列了 8 个平台：QQ、企业微信、飞书、钉钉、微信公众号、Telegram、Slack，以及“more”。你在一个配置文件里填好各平台的 API Token 和 Webhook，所有消息都路由到同一个 Agent。IP 隔离在平台侧，不用额外操心。
四个部署方式，我实测了三个
uv 一键部署（推荐新手）
前提：装 uv。macOS：brew install uv；Linux：官方脚本。然后三条命令：
uv tool install astrbot --python 3.12
astrbot init # 第一次，生成配置模板
astrbot run实测数据：uv tool install 下载依赖花了约 2 分 10 秒（家宽 500M）。首次 astrbot run 等了 18 秒才有输出——README 提过 macOS 的 Gatekeeper 安全扫描，Linux 上不到 3 秒。第二次启动正常。更新命令：
uv tool upgrade astrbot --python 3.12astrbot init 生成了一个 astrbot.json，里面全是空字段。你得按 README 的文档去每个 IM 平台申请 Bot，把 Token、Secret 填回去，重启服务才能用。配一个企业微信大概需要 30 分钟（因为要在企业微信后台创建自建应用，审批），QQ 简单些，15 分钟。
Docker 部署
如果你不想装 Python 和 uv，或者想在生产跑，直接拉 Docker。官方文档有一份 Docker Compose 文件。我试了 docker compose up -d，启动时间不到 10 秒，环境隔离，日志在容器内。推荐没有特殊 Python 依赖的用户使用。
润云云部署
README 里的链接是润云的一键部署市场。进链接挑套餐，配完就开。我没试，因为要对公转账。适合不想碰服务器、有预算的个人或团队。
桌面应用
去 AstrBot-desktop 下载，本质是内置了 ChatUI 的 electron 包。主要用途是个人聊天，内置了 Agent 沙箱和 web 搜索。不适合做服务端。
三个必须知道的坑
许可证没写
README 文件页脚没有许可证信息。GitHub 仓库 settings 里也没看到许可证文件。如果你打算商用或修改后分发，最好发邮件到项目邮箱问清楚。在确认前我当它是“只供个人学习”。
配置全靠你自己填
astrbot init 生成的配置模板全是空的。没有“自动探测”或“向导”流程。新手得花几小时读文档配各个平台，尤其企业微信和钉钉需要企业管理员权限，个人开发者可能卡在这一步。
插件质量不均
1000 多个插件，我随手装了三个全部报缺少依赖。后来才知道插件依赖写在 requirements 里，但 WebUI 安装时不会自动补环境。建议用之前先看插件仓库的 README 和 commits。
我准备拿它做什么
两个方向：
沙箱 + 技能，做轻量 BI 查询。保持数据库连接，在群里问“上季度各区域销售额”，Agent 查完直接返回表格。不需要单独搭 BI 系统。
主动 Agent + MCP，做服务器巡检。写一个 MCP 工具调用 df -h，每 10 分钟检查磁盘，超 80% 自动在飞书群发告警。如果不满足，再往技能里加阈值调整。