AstrBot
一站式 AI Agent 开发与聊天平台，集成了 QQ、微信、飞书、Telegram 等十余种 IM 平台和数十种 LLM 服务，内置 Agent Sandbox、知识库、角色设定、MCP 等能力，并拥有超 1000 款社区插件一键安装。相比同类开源项目，AstrBot 强调生产级稳定性与跨平台覆盖，同时保持对个人/团队免费开源，适合快速构建从客服到智能助手的各类应用。
README
简体中文 ｜ 繁體中文 ｜ 日本語 ｜ Français ｜ Español ｜ Русский
AstrBot 是一个开源的一体化 Agent 聊天机器人平台，可与主流即时通讯应用集成。它为个人、开发者和团队提供可靠且可扩展的对话式 AI 基础设施。无论你是构建个人 AI 伴侣、智能客服、自动化助手还是企业知识库，AstrBot 都能让你在 IM 平台工作流中快速搭建生产就绪的 AI 应用。
核心特性
- 💯 免费且开源。
- ✨ AI LLM 对话、多模态、Agent、MCP、技能、知识库、人格设定、自动上下文压缩。
- 🤖 支持集成 Dify、阿里云百炼、Coze 等 Agent 平台。
- 🌐 多平台：QQ、企业微信、飞书、钉钉、微信公众号、Telegram、Slack 以及更多。
- 📦 插件扩展，1000+ 插件可供一键安装。
- 🛡️ Agent 沙箱，用于隔离安全地执行代码、Shell 调用及会话级资源复用。
- 💻 支持 WebUI。
- 🌈 支持 Web ChatUI，内置 Agent 沙箱和网络搜索。
- 🌐 支持国际化（i18n）。
| 💙 角色扮演与情感陪伴 | ✨ 主动式 Agent | 🚀 通用 Agent 能力 | 🧩 1000+ 社区插件 |
|---|---|---|---|
|
|
|
|
快速开始
一键部署
[!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
云端一键部署（RainYun）
对于希望一键部署且不想自行管理服务器的用户，推荐使用 RainYun 的云端一键部署服务 ☁️：
Docker 部署
对于熟悉容器技术并寻求更稳定、生产级部署方式的用户，推荐使用 Docker / Docker Compose 部署 AstrBot。
请参考官方文档：使用 Docker 部署 AstrBot。
桌面端应用部署
对于希望在桌面端使用 AstrBot 且主要使用 ChatUI 的用户，推荐使用 AstrBot App。
请访问 AstrBot-desktop 下载安装；此方式面向桌面使用场景，不建议用于服务器场景。
启动器部署
对于同时需要快速部署和隔离多实例使用的桌面用户，推荐使用 AstrBot Launcher。
请访问 AstrBot Launcher 下载安装。
在 Replit 上部署
Replit 部署由社区维护，适用于在线演示和轻量试用。
AUR
AUR 部署面向希望以系统包管理方式安装 AstrBot 的 Arch Linux 用户。
运行以下命令安装 astrbot-git，然后在本地环境中启动 AstrBot。
yay -S astrbot-git
更多部署方式
如需面板管理或更深度定制，可参阅 宝塔面板部署（宝塔应用商店安装）、1Panel 部署（1Panel 应用市场部署）、CasaOS 部署（NAS/家庭服务器可视化部署），以及 手动部署（使用 uv 进行完全自定义的源码安装）。
❤️ 赞助者
支持的即时通讯平台
将 AstrBot 连接到您喜欢的聊天平台。
| 平台 | 维护者 |
|---|---|
| 官方 | |
| OneBot v11 协议实现 | 官方 |
| Telegram | 官方 |
| 企业微信及企业微信 AI 机器人 | 官方 |
| 微信公众号 | 官方 |
| 飞书 | 官方 |
| 钉钉 | 官方 |
| 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 服务 |
| AIHubMix | LLM 服务（API 网关，支持所有模型） |
| CompShare | LLM 服务 |
| 302.AI | LLM 服务 |
| TokenPony | LLM 服务 |
| SiliconFlow | LLM 服务 |
| PPIO Cloud | LLM 服务 |
| ModelScope | LLM 服务 |
| OneAPI | LLM 服务 |
| Dify | LLMOps 平台 |
| 阿里云百炼应用 | LLMOps 平台 |
| Coze | LLMOps 平台 |
| OpenAI Whisper | 语音转文字服务 |
| SenseVoice | 语音转文字服务 |
| 小米 MiMo Omni | 语音转文字服务 |
| OpenAI TTS | 文本转语音服务 |
| Gemini TTS | 文本转语音服务 |
| GPT-Sovits-Inference | 文本转语音服务 |
| GPT-Sovits | 文本转语音服务 |
| FishAudio | 文本转语音服务 |
| Edge TTS | 文本转语音服务 |
| 阿里云百炼 TTS | 文本转语音服务 |
| Azure TTS | 文本转语音服务 |
| Minimax TTS | 文本转语音服务 |
| 小米 MiMo TTS | 文本转语音服务 |
| 火山引擎 TTS | 文本转语音服务 |
❤️ 贡献指南
Issues 和 Pull Requests 始终欢迎！随时提交你的更改到本项目 :)
如何贡献
你可以通过审查 Issues 或帮助审核 Pull Requests 来贡献。任何 Issues 或 PR 都欢迎，以鼓励社区参与。当然，这些只是建议——你可以以任何你喜欢的方式做出贡献。对于添加新功能，请先通过 Issue 讨论。
开发环境
AstrBot 使用 ruff 进行代码格式化和 lint。
git clone https://github.com/AstrBotDevs/AstrBot
pip install pre-commit
pre-commit install
🌍 社区
QQ 群
我们有 15+ 个聊天群，详情请查看：社区。
Discord 服务器
❤️ 特别感谢
特别感谢所有贡献者和插件开发者对 AstrBot 的贡献 ❤️
开源伙伴 ❤️
- NapNeko/NapCatQQ - 超棒的猫框架
- Mai-with-u/MaiBot - 你 QQ 中强大的“数字生命”！
⭐ Star 历史
[!TIP] 如果本项目在你的生活或工作中给了你帮助，或者你对其未来发展感兴趣，请给项目点个 Star。这是维持这个开源项目的动力 <3
陪伴与能力不应相互对立。我们想要创造的是一个能理解情感、提供真实陪伴，并能可靠完成任务的机器人。
私は、高性能ですから!
