AstrBot 是一个开源的一站式 Agentic 个人和群聊助手框架,GitHub 已收获 37.4K Star。一次配置,就能让你的 AI 助手同时出现在 QQ、飞书、钉钉、Telegram、Slack、Discord 等十几款主流聊天软件中,真正实现"一个助手,无处不在"。

项目介绍
AstrBot 由 AstrBotDevs 团队开发维护,代码完全开源免费。其核心理念是:"陪伴与能力从来不应该是对立面——创造既能理解情绪、给予陪伴,也能可靠完成工作的机器人。"


核心亮点
1. 多平台覆盖
AstrBot 支持的消息平台堪称豪华阵容:
- 官方维护:QQ、OneBot v11、Telegram、企业微信、微信公众号、飞书、钉钉、Slack、Discord、LINE、Satori、KOOK、Misskey、Mattermost
- 社区维护:Matrix、Rocket.Chat、VoceChat
- 即将支持:WhatsApp
2. 模型生态
LLM 服务:OpenAI、Anthropic、Google Gemini、Moonshot AI、智谱 AI、DeepSeek、Ollama(本地部署)、LM Studio(本地部署)、硅基流动、PPIO 派欧云、ModelScope、OneAPI 等 18+ 服务。
LLMOps 平台:Dify、阿里云百炼、Coze。
语音服务:Whisper、SenseVoice、GPT-Sovits、FishAudio、Edge TTS、火山引擎 TTS 等 12+ 语音转文本/文本转语音方案。
3. 1000+ 插件生态
超过 1000 个社区插件可一键安装,覆盖生活服务(天气、快递、点歌)、办公效率(文档处理、日程管理、代码解释)、娱乐互动(游戏、表情包生成)、工具助手(计算器、翻译、网页搜索)。通过 WebUI 界面即可完成安装管理,无需代码知识。
4. Agent Sandbox(智能体沙箱)
内置 Agent Sandbox 环境,可安全地执行代码、调用 Shell 命令,支持会话级资源复用。AI 助手不仅能聊天,还能编写运行 Python 代码、执行 Shell 脚本、搜索网页、处理文件和数据,所有操作在隔离环境中进行。
5. 人格设定与情感陪伴
支持角色扮演和情感陪伴能力,可设定不同人格:温柔助手、幽默段子手、专业程序员、生活顾问等。通过精心设计的人格设定,AstrBot 能够理解情绪并给予恰当回应。

功能特性
- 多模态对话:支持文本、图片、语音等多种交互形式
- 知识库功能:上传文档资料,构建专属知识库

- MCP 与 Skills:支持 MCP 标准,接入第三方工具和服务,内置 Skills 系统完成复杂任务编排
- 自动上下文压缩:长时间对话中自动压缩和摘要历史对话,避免上下文过长导致效率下降和成本增加
- WebUI 管理界面:直观的可视化管理面板,无需命令行操作
快速上手
方式一:uv 一键部署(推荐)
# 安装 uv
curl -LsSf https://astral.sh/uv/install.sh | sh
# 安装 AstrBot
uv tool install astrbot --python 3.12
# 初始化环境(仅首次执行)
astrbot init
# 启动服务
astrbot run
启动成功后,访问 http://localhost:6185 即可打开管理面板。首次登录用户名是 astrbot,密码在启动日志中查找。
# 更新 AstrBot
uv tool upgrade astrbot --python 3.12
方式二:Docker 部署
git clone https://github.com/AstrBotDevs/AstrBot
cd AstrBot
docker compose up -d
国内用户可修改 compose.yml,将镜像源替换为:m.daocloud.io/docker.io/soulter/astrbot:latest
方式三:桌面客户端
前往 AstrBot Desktop 下载对应系统安装包,安装后即可使用。
方式四:启动器部署
前往 AstrBot Launcher 下载安装,适合快速部署并实现环境隔离多开。
总结
AstrBot 解决了多平台 AI 接入的核心痛点,同时提供完整的 Agentic 能力、丰富的插件生态和安全的执行环境。无论是个人用户想要一个随时陪伴的 AI 伙伴,还是企业用户想搭建智能客服系统,AstrBot 都能满足需求。
项目地址:https://github.com/AstrBotDevs/AstrBot