AstrBotDevs/AstrBot

AstrBot 是一个开源的一站式 Agent 聊天机器人平台，可接入主流即时通讯应用，为个人、开发者和团队提供可靠、可扩展的对话式 AI 基础设施。无论你要构建个人 AI 伙伴、智能客服、自动化助手还是企业知识库，AstrBot 都能帮助你在即时通讯平台的工作流中快速构建可用于生产环境的 AI 应用。

主要功能

1. 💯 免费 & 开源。
2. ✨ AI 大模型对话，多模态，Agent，MCP，Skills，知识库，人格设定，自动压缩对话。
3. 🤖 支持接入 Dify、阿里云百炼、Coze 等智能体平台。
4. 🌐 多平台，支持 QQ、企业微信、飞书、钉钉、微信公众号、Telegram、Slack 以及更多。
5. 📦 插件扩展，已有 1000+ 个插件可一键安装。
6. 🛡️ Agent Sandbox 隔离化环境，安全地执行任何代码、调用 Shell、会话级资源复用。
7. 💻 WebUI 支持。
8. 🌈 Web ChatUI 支持，ChatUI 内置代理沙盒、网页搜索等。
9. 🌐 国际化（i18n）支持。

快速开始

在雨云上一键部署

对于希望一键部署并让 AstrBot 24 小时在线、且不想自行管理服务器的用户，我们推荐使用雨云的一键云部署服务 ☁️：

一键部署

[!NOTE] 需要安装 uv。 对于 macOS 用户：由于 macOS 安全检查，首次运行 astrbot 命令可能需要较长时间（约 10-20 秒）。

对于想快速体验 AstrBot、且熟悉命令行并能够自行安装 uv 环境的用户，我们推荐使用 uv 一键部署方式 ⚡️。

uv tool install astrbot --python 3.12
astrbot init # 仅首次执行此命令以初始化环境
astrbot run

后续更新 astrbot：

uv tool upgrade astrbot --python 3.12

Docker 部署

对于熟悉容器、希望获得更稳定且更适合生产环境部署方式的用户，我们推荐使用 Docker / Docker Compose 部署 AstrBot。

请参考官方文档 使用 Docker 部署 AstrBot。

桌面客户端部署

对于希望在桌面端使用 AstrBot、并以 ChatUI 为主要入口的用户，我们推荐使用 AstrBot App。

前往 AstrBot-desktop 下载并安装；该方式面向桌面使用，不推荐服务器场景。

启动器部署

同样在桌面端，希望快速部署并实现环境隔离多开的用户，我们推荐使用 AstrBot Launcher。

前往 AstrBot Launcher 下载并安装。

更多部署方式

若你需要面板化或更高自定义部署，可参考 宝塔面板、1Panel、CasaOS 和 源码部署。

❤️ 赞助商

欢迎通过 Afdian 或者通过邮件 赞助我们。

支持的消息平台

将 AstrBot 连接到你常用的聊天平台。

平台	维护方
QQ	官方维护
OneBot v11	官方维护
Telegram	官方维护
企微应用 & 企微智能机器人	官方维护
微信公众号	官方维护
飞书	官方维护
钉钉	官方维护
Slack	官方维护
Discord	官方维护
LINE	官方维护
Satori	官方维护
KOOK	官方维护
Misskey	官方维护
Mattermost	官方维护
WhatsApp（将支持）	官方维护
Matrix	社区维护
Rocket.Chat	社区维护
VoceChat	社区维护

支持的模型提供商

提供商	类型
OpenAI 及兼容服务	LLM
Anthropic	LLM
Google Gemini	LLM
Moonshot AI	LLM
智谱 AI	LLM
DeepSeek	LLM
Ollama (本地部署)	LLM
LM Studio (本地部署)	LLM
MiraRouter	LLM (API 网关, 支持所有模型)
胜算云	LLM
AIHubMix	LLM (API 网关, 支持所有模型)
优云智算	LLM (API 网关, 支持所有模型)
302.AI	LLM (API 网关, 支持所有模型)
小马算力	LLM (API 网关, 支持所有模型)
硅基流动	LLM (API 网关, 支持所有模型)
PPIO 派欧云	LLM (API 网关, 支持所有模型)
ModelScope	LLM
OneAPI	LLM
Dify	LLMOps 平台
阿里云百炼应用	LLMOps 平台
Coze	LLMOps 平台
OpenAI Whisper	语音转文本
SenseVoice	语音转文本
Xiaomi MiMo Omni	语音转文本
OpenAI TTS	文本转语音
Gemini TTS	文本转语音
GPT-Sovits-Inference	文本转语音
GPT-Sovits	文本转语音
FishAudio	文本转语音
Edge TTS	文本转语音
阿里云百炼 TTS	文本转语音
Azure TTS	文本转语音
Minimax TTS	文本转语音
Xiaomi MiMo 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 群组

我们有 15 个以上的交流群，详情请参阅社区。

Discord 频道

❤️ Special Thanks

特别感谢所有 Contributors 和插件开发者对 AstrBot 的贡献 ❤️

开源伙伴 ❤️

• NapNeko/NapCatQQ - 出色的猫猫框架
• Mai-with-u/MaiBot - QQ 中强大的“数字生命”！

⭐ Star History

[!TIP] 如果本项目对您的生活 / 工作产生了帮助，或者您关注本项目的未来发展，请给项目 Star，这是我们维护这个开源项目的动力 <3