AstrBot
AstrBot 是一个开源的一站式 Agentic 个人和群聊助手，可在 QQ、Telegram、企业微信、飞书、钉钉、Slack、等数十款主流即时通讯软件上部署，此外还内置类似 OpenWebUI 的轻量化 ChatUI，为个人、开发者和团队打造可靠、可扩展的对话式智能基础设施。
无论是个人 AI 伙伴、智能客服、自动化助手，还是企业知识库，AstrBot 都能在你的即时通讯软件平台的工作流中快速构建 AI 应用。
主要功能
- 💯 免费 & 开源。
- ✨ AI 大模型对话，多模态，Agent，MCP，Skills，知识库，人格设定，自动压缩对话。
- 🤖 支持接入 Dify、阿里云百炼、Coze 等智能体平台。
- 🌐 多平台，支持 QQ、企业微信、飞书、钉钉、微信公众号、Telegram、Slack 以及更多。
- 📦 插件扩展，已有 1000+ 个插件可一键安装。
- 🛡️ Agent Sandbox 隔离化环境，安全地执行任何代码、调用 Shell、会话级资源复用。
- 💻 WebUI 支持。
- 🌈 Web ChatUI 支持，ChatUI 内置代理沙盒、网页搜索等。
- 🌐 国际化（i18n）支持。
| 💙 角色扮演 & 情感陪伴 | ✨ 主动式 Agent | 🚀 通用 Agentic 能力 | 🧩 1000+ 社区插件 |
|---|---|---|---|
快速开始
一键部署
对于想快速体验 AstrBot、且熟悉命令行并能够自行安装 uv 环境的用户，我们推荐使用 uv 一键部署方式 ⚡️。
uv tool install astrbot
astrbot init # 仅首次执行此命令以初始化环境
astrbot
需要安装 uv。
[!NOTE] 对于 macOS 用户：由于 macOS 安全检查，首次运行
astrbot命令可能需要较长时间（约 10-20 秒）。
更新 astrbot：
uv tool upgrade astrbot
Docker 部署
对于熟悉容器、希望获得更稳定且更适合生产环境部署方式的用户，我们推荐使用 Docker / Docker Compose 部署 AstrBot。
请参考官方文档 使用 Docker 部署 AstrBot。
在 雨云 上部署
对于希望一键部署 AstrBot 且不想自行管理服务器的用户，我们推荐使用雨云的一键云部署服务 ☁️：
桌面客户端部署
对于希望在桌面端使用 AstrBot、并以 ChatUI 为主要入口的用户，我们推荐使用 AstrBot App。
前往 AstrBot-desktop 下载并安装；该方式面向桌面使用，不推荐服务器场景。
启动器部署
同样在桌面端，希望快速部署并实现环境隔离多开的用户，我们推荐使用 AstrBot Launcher。
前往 AstrBot Launcher 下载并安装。
在 Replit 上部署
Replit 部署由社区维护，适合在线演示和轻量试用场景。
AUR
AUR 方式面向 Arch Linux 用户，适合希望通过系统包管理器安装 AstrBot 的场景。
在终端执行下方命令安装 astrbot-git 包，安装完成后即可启动使用。
yay -S astrbot-git
更多部署方式
若你需要面板化或更高自定义部署，可参考 宝塔面板（BT Panel 应用商店安装）、1Panel（1Panel 应用商店安装）、CasaOS（NAS / 家庭服务器可视化部署）和 手动部署（基于源码与 uv 的完整自定义安装）。
支持的消息平台
将 AstrBot 连接到你常用的聊天平台。
| 平台 | 维护方 |
|---|---|
| 官方维护 | |
| OneBot v11 | 官方维护 |
| Telegram | 官方维护 |
| 企微应用 & 企微智能机器人 | 官方维护 |
| 微信客服 & 微信公众号 | 官方维护 |
| 飞书 | 官方维护 |
| 钉钉 | 官方维护 |
| Slack | 官方维护 |
| Discord | 官方维护 |
| LINE | 官方维护 |
| Satori | 官方维护 |
| Misskey | 官方维护 |
| Whatsapp (将支持) | 官方维护 |
| Matrix | 社区维护 |
| KOOK | 社区维护 |
| VoceChat | 社区维护 |
支持的模型提供商
| 提供商 | 类型 |
|---|---|
| 自定义 | 任何 OpenAI API 兼容的服务 |
| OpenAI | LLM |
| Anthropic | LLM |
| Google Gemini | LLM |
| Moonshot AI | LLM |
| 智谱 AI | LLM |
| DeepSeek | LLM |
| Ollama (本地部署) | LLM |
| LM Studio (本地部署) | LLM |
| AIHubMix | LLM (API 网关, 支持所有模型) |
| 优云智算 | LLM (API 网关, 支持所有模型) |
| 硅基流动 | LLM (API 网关, 支持所有模型) |
| PPIO 派欧云 | LLM (API 网关, 支持所有模型) |
| 302.AI | LLM (API 网关, 支持所有模型) |
| 小马算力 | LLM (API 网关, 支持所有模型) |
| ModelScope | LLM |
| OneAPI | LLM |
| Dify | LLMOps 平台 |
| 阿里云百炼应用 | LLMOps 平台 |
| Coze | LLMOps 平台 |
| OpenAI Whisper | 语音转文本 |
| SenseVoice | 语音转文本 |
| OpenAI TTS | 文本转语音 |
| Gemini TTS | 文本转语音 |
| GPT-Sovits-Inference | 文本转语音 |
| GPT-Sovits | 文本转语音 |
| FishAudio | 文本转语音 |
| Edge TTS | 文本转语音 |
| 阿里云百炼 TTS | 文本转语音 |
| Azure TTS | 文本转语音 |
| Minimax TTS | 文本转语音 |
| 火山引擎 TTS | 文本转语音 |
❤️ 贡献
欢迎任何 Issues/Pull Requests！只需要将你的更改提交到此项目 ：)
如何贡献
你可以通过查看问题或帮助审核 PR（拉取请求）来贡献。任何问题或 PR 都欢迎参与，以促进社区贡献。当然，这些只是建议，你可以以任何方式进行贡献。对于新功能的添加，请先通过 Issue 讨论。
开发环境
AstrBot 使用 ruff 进行代码格式化和检查。
git clone https://github.com/AstrBotDevs/AstrBot
pip install pre-commit
pre-commit install
🌍 社区
QQ 群组
- 9 群: 1076659624 (新)
- 10 群: 1078079676 (新)
- 1 群：322154837
- 3 群：630166526
- 5 群：822130018
- 6 群：753075035
- 7 群：743746109
- 8 群：1030353265
- 开发者群（偏闲聊吹水）：975206796
- 开发者群（正式）：1039761811
Discord 频道
❤️ Special Thanks
特别感谢所有 Contributors 和插件开发者对 AstrBot 的贡献 ❤️
此外，本项目的诞生离不开以下开源项目的帮助：
- NapNeko/NapCatQQ - 伟大的猫猫框架
开源项目友情链接：
- NoneBot2 - 优秀的 Python 异步 ChatBot 框架
- Koishi - 优秀的 Node.js ChatBot 框架
- MaiBot - 优秀的拟人化 AI ChatBot
- nekro-agent - 优秀的 Agent ChatBot
- LangBot - 优秀的多平台 AI ChatBot
- ChatLuna - 优秀的多平台 AI ChatBot Koishi 插件
- Operit AI - 优秀的 AI 智能助手 Android APP
⭐ Star History
[!TIP] 如果本项目对您的生活 / 工作产生了帮助，或者您关注本项目的未来发展，请给项目 Star，这是我们维护这个开源项目的动力 <3
