AstrBot -Logo-Simplified\” style=\”max-width: 100%;\”>
English ｜ 日本语｜ 查看文档｜ 问题提交
AstrBot是一个开源的一站式Agentic 聊天机器人平台及开发框架。
主要功能
- 大模型对话。支持接入多种大模型服务。支持多模态、工具调用、MCP、原生知识库、人设等功能。
- 多消息平台支持。支持接入QQ、企业微信、微信公众号、飞书、Telegram、钉钉、Discord、KOOK 等平台。支持速率限制、白名单、百度内容审核。
- Agent 。完善适配的Agentic 能力。支持多轮工具调用、内置沙盒代码执行器、网页搜索等功能。
- 插件扩展。深度优化的插件机制，支持开发插件扩展功能，社区插件生态丰富。
- WebUI 。可视化配置和管理机器人，功能齐全。
使用方式
Docker 部署
推荐使用Docker / Docker Compose 方式部署AstrBot 。
请参阅官方文档使用Docker 部署AstrBot 。
宝塔面板部署
AstrBot与宝塔面板合作，已上架至宝塔面板。
请参阅官方文档宝塔面板部署。
1Panel 部署
AstrBot已由1Panel 官方上架至1Panel 面板。
请参阅官方文档1Panel 部署。
在雨云上部署
AstrBot已由雨云官方上架至云应用平台，可一键部署。
在Replit 上部署
社区贡献的部署方式。
Windows 一键安装器部署
请参阅官方文档使用Windows 一键安装器部署AstrBot 。
CasaOS 部署
社区贡献的部署方式。
请参阅官方文档CasaOS 部署。
手动部署
推荐使用uv。
首先，安装uv：
pip install uv
通过Git Clone 安装AstrBot ：
AstrBot
uv run main.py\”>
git clone https://g*it**hub.com/AstrBotDevs/ AstrBot && cd AstrBot uv run main.py
或者请参阅官方文档通过源码部署AstrBot 。
⚡ 消息平台支持情况
| 平台 | 支持性 |
|---|---|
| QQ(官方机器人接口) | ✔ |
| QQ(OneBot) | ✔ |
| Telegram | ✔ |
| 企业微信 | ✔ |
| 微信客服 | ✔ |
| 微信公众号 | ✔ |
| 飞书 | ✔ |
| 钉钉 | ✔ |
| Slack | ✔ |
| Discord | ✔ |
| KOOK | ✔ |
| VoceChat | ✔ |
| 微信对话开放平台 | ? |
| ? | |
| 小爱音响 | ? |
⚡ 提供商支持情况
| 名称 | 支持性 | 类型 | 备注 |
|---|---|---|---|
| OpenAI API | ✔ | 文本生成 | 也支持DeepSeek、Gemini、Kimi、xAI 等兼容OpenAI API 的服务 |
| Claude API | ✔ | 文本生成 | |
| Google Gemini API | ✔ | 文本生成 | |
| Dify | ✔ | LLMOps | |
| 阿里云百炼应用 | ✔ | LLMOps | |
| Ollama | ✔ | 模型加载器 | 本地部署DeepSeek、Llama 等开源语言模型 |
| LM Studio | ✔ | 模型加载器 | 本地部署DeepSeek、Llama 等开源语言模型 |
| LLMTuner | ✔ | 模型加载器 | 本地加载lora 等微调模型 |
| 优云智算 | ✔ | 模型API 及算力服务平台 | |
| 302.AI | ✔ | 模型API 服务平台 | |
| 硅基流动 | ✔ | 模型API 服务平台 | |
| PPIO 派欧云 | ✔ | 模型API 服务平台 | |
| OneAPI | ✔ | LLM 分发系统 | |
| Whisper | ✔ | 语音转文本 | 支持API、本地部署 |
| SenseVoice | ✔ | 语音转文本 | 本地部署 |
| OpenAI TTS API | ✔ | 文本转语音 | |
| GSVI | ✔ | 文本转语音 | GPT-Sovits-Inference |
| GPT-SoVITs | ✔ | 文本转语音 | GPT-Sovits-Inference |
| FishAudio | ✔ | 文本转语音 | GPT-Sovits 作者参与的项目 |
| Edge TTS | ✔ | 文本转语音 | Edge 浏览器的免费TTS |
| 阿里云百炼TTS | ✔ | 文本转语音 | |
| Azure TTS | ✔ | 文本转语音 | Microsoft Azure TTS |
❤️ 贡献
欢迎任何Issues/Pull Requests！只需要将你的更改提交到此项目：)
如何贡献
你可以通过查看问题或帮助审核PR（拉取请求）来贡献。任何问题或PR 都欢迎参与，以促进社区贡献。当然，这些只是建议，你可以以任何方式进行贡献。对于新功能的添加，请先通过Issue 讨论。
开发环境
AstrBot使用ruff 进行代码格式化和检查。
git clone https://git*hu*b.*com/Soulter/AstrBot pip install pre-commit pre-commit install
? 支持
- Star 这个项目！
- 在爱发电支持我！
Demo
点击展开多张Demo 截图?
基于Docker 的沙箱化代码执行器（Beta 测试）
多模态、网页搜索、长文本转图片（可配置）
插件系统——部分插件展示
WebUI
❤️ Special Thanks
特别感谢所有Contributors 和插件开发者对AstrBot的贡献❤️
此外，本项目的诞生离不开以下开源项目：
- NapNeko/NapCatQQ – 伟大的猫猫框架
- wechatpy/wechatpy
Star History
Tip
如果本项目对您的生活/ 工作产生了帮助，或者您关注本项目的未来发展，请给项目Star，这是我维护这个开源项目的动力<3
私は、高性能ですから!
