9.4 KiB
AstrBot 是一个松耦合、异步、支持多消息平台部署、具有易用的插件系统和完善的大语言模型（LLM）接入功能的聊天机器人及开发框架。
✨ 主要功能
- 大模型对话。支持接入多种大模型服务。支持多模态、工具调用、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：
git clone https://github.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://github.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
私は、高性能ですから!