产品与定位
AstrBot 是一个开源一站式 Agent 聊天机器人平台,把「大模型 + 消息平台 + 插件生态」整合成一套可自托管的基础设施。它的目标不是做一个玩具对话机器人,而是让你在即时通讯软件里快速搭出可上线的 AI 应用 —— 个人 AI 陪伴、智能客服、自动化助手、企业知识库都可以基于它构建。
它的核心优势是消息平台覆盖度:官方维护的适配器就有 14 个,国内平台(QQ、企业微信、微信公众号、个人微信、飞书、钉钉)与海外平台(Telegram、Slack、Discord、LINE 等)都在官方支持范围内,这在开源项目里相当少见。
功能速览
| 功能 | 说明 |
|---|---|
| 多平台接入 | QQ、企业微信、微信公众号、个人微信、飞书、钉钉、Telegram、Slack、Discord、LINE、Satori、KOOK、Misskey、Mattermost |
| MCP 支持 | v3.5.0 起支持,WebUI「插件 → MCP」中管理,可挂多个服务器 |
| Agent Skills | v4.13.0 起按需加载 SKILL.md |
| Agent 沙箱 | 隔离执行代码与 shell 调用,支持会话级资源复用 |
| 插件市场 | 官方称 1000+ 插件可一键安装 |
| 能力面 | 多模态、知识库、人格设定、自动上下文压缩、SubAgent 编排、主动型 Agent、网页搜索 |
| Agent 平台对接 | 可外接 Dify、阿里云百炼应用、Coze 等 |
| 语音能力 | 多家 STT(Whisper、SenseVoice、MiMo Omni)与 TTS(OpenAI、Gemini、GPT-Sovits、Edge TTS、Azure TTS、MiniMax 等) |
| 双界面 | WebUI 管理面板 + 内置 ChatUI 网页对话 |
| 国际化 | 内置 i18n 支持,官方提供 6 种语言 README |
注意:「微信」在 AstrBot 中是三个独立适配器 —— 个人微信、微信公众号、企业微信(含企微智能机器人),配置与限制各不相同。此外 WhatsApp 官方标注为 Coming Soon,当前尚未支持。
快速部署
# 需先安装 uv
uv tool install astrbot --python 3.12
astrbot init # 首次运行初始化环境
astrbot run
# 升级
uv tool upgrade astrbot --python 3.12
其他部署方式:Docker / Docker Compose(生产推荐)、AstrBot 桌面客户端、AstrBot Launcher、宝塔面板 / 1Panel / CasaOS 应用商店、Kubernetes,或雨云一键云部署。
支持的消息平台补充
除官方适配器外,社区还维护了 Matrix、Rocket.Chat、VoceChat 适配器。文档站提供 18+ 平台的接入指南。
版本与更新注意
- 当前版本 v4.28.1(2026-09-14 发布),仓库
AstrBotDevs/AstrBot,约 40,850 stars、2,960 forks(截至 2026-09-22),最近提交 2026-09-21,维护非常活跃。 - 许可证是 AGPL-3.0,且项目另有单独的
EULA.md。AGPL 对网络服务有传染性要求:如果你修改后对外提供网络服务,需按 AGPL 开放源码。商用前务必确认合规性,或联系官方获取商业授权。 - 需要 Python 3.12+;
.astrbot数据目录与插件需自行备份。 - 平台适配器数量多,但各平台的风控政策不同 —— 尤其个人微信存在账号风险,生产环境建议优先使用官方机器人通道。
- 版本迭代频繁,
v4.x系列仍在快速演进,升级前建议阅读 Release Notes。
选型建议
- 主要诉求是在 IM 里跑一个可用的 AI 助手 → AstrBot 的平台覆盖度是同类中最广的。
- 需要国内平台(QQ / 企业微信 / 飞书 / 钉钉 / 公众号) → 官方适配器直接可用,不用自己造轮子。
- 需要与 Dify / Coze / 百炼等既有 Agent 平台打通 → 支持作为前端接入,复用已有编排。
- 想自托管个人 Agent 框架、偏好 Python 且需要 WebUI + 终端 + 聊天软件三入口 → nanobot 更偏「Agent 框架」而非「机器人平台」。
- 需要与 Claude Code 生态的技能格式互通 → 两者都支持
SKILL.md,可共享技能库。