AstrBotDevs/AstrBot

AstrBot 是一个开源的一站式 Agentic 个人和群聊助手，可在 QQ、Telegram、企业微信、飞书、钉钉、Slack、等数十款主流即时通讯软件上部署，此外还内置类似 OpenWebUI 的轻量化 ChatUI，为个人、开发者和团队打造可靠、可扩展的对话式智能基础设施。无论是个人 AI 伙伴、智能客服、自动化助手，还是企业知识库，AstrBot 都能在你的即时通讯软件平台的工作流中快速构建 AI 应用。

主要功能

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

💙 角色扮演 & 情感陪伴	✨ 主动式 Agent	🚀 通用 Agentic 能力	🧩 900+ 社区插件

快速开始

Docker 部署(推荐 🥳)

推荐使用 Docker / Docker Compose 方式部署 AstrBot。

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

uv 部署

uv tool install astrbot
astrbot

启动器一键部署（AstrBot Launcher）

进入 AstrBot Launcher 仓库，在 Releases 页最新版本下找到对应的系统安装包安装即可。

宝塔面板部署

AstrBot 与宝塔面板合作，已上架至宝塔面板。

请参阅官方文档 宝塔面板部署 。

1Panel 部署

AstrBot 已由 1Panel 官方上架至 1Panel 面板。

请参阅官方文档 1Panel 部署 。

在 雨云 上部署

AstrBot 已由雨云官方上架至云应用平台，可一键部署。

在 Replit 上部署

社区贡献的部署方式。

Windows 一键安装器部署

请参阅官方文档 使用 Windows 一键安装器部署 AstrBot 。

CasaOS 部署

社区贡献的部署方式。

请参阅官方文档 CasaOS 部署 。

手动部署

首先安装 uv：

pip install uv

通过 Git Clone 安装 AstrBot：

git clone https://github.com/AstrBotDevs/AstrBot && cd AstrBot
uv run main.py

或者请参阅官方文档 通过源码部署 AstrBot 。

系统包管理器安装

Arch Linux

yay -S astrbot-git
# 或者使用 paru
paru -S astrbot-git

桌面端 Electron 打包

桌面端（Electron 打包，pnpm 工作流）构建流程请参阅：desktop/README.md。

支持的消息平台

官方维护

• QQ (官方平台 & OneBot)
• Telegram
• 企微应用 & 企微智能机器人
• 微信客服 & 微信公众号
• 飞书
• 钉钉
• Slack
• Discord
• Satori
• Misskey
• Whatsapp (将支持)
• LINE (将支持)

社区维护

• Matrix
• KOOK
• VoceChat

支持的模型服务

大模型服务

• OpenAI 及兼容服务
• Anthropic
• Google Gemini
• Moonshot AI
• 智谱 AI
• DeepSeek
• Ollama (本地部署)
• LM Studio (本地部署)
• AIHubMix
• 优云智算
• 302.AI
• 小马算力
• 硅基流动
• PPIO 派欧云
• ModelScope
• OneAPI

LLMOps 平台

• Dify
• 阿里云百炼应用
• Coze

语音转文本服务

• 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 群组

• 1 群：322154837
• 3 群：630166526
• 5 群：822130018
• 6 群：753075035
• 7 群：743746109
• 8 群：1030353265
• 开发者群：975206796

Telegram 群组

Discord 群组

❤️ Special Thanks

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

此外，本项目的诞生离不开以下开源项目的帮助：

• NapNeko/NapCatQQ - 伟大的猫猫框架

⭐ Star History

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