![logo](https://github.com/user-attachments/assets/07649e07-3b8e-4feb-9aa9-bf13af4f3476)

_✨ 易上手的多平台 LLM 聊天机器人及开发框架 ✨_ [![GitHub release (latest by date)](https://img.shields.io/github/v/release/Soulter/AstrBot)](https://github.com/Soulter/AstrBot/releases/latest)

[![wakatime](https://wakatime.com/badge/user/915e5316-99c6-4563-a483-ef186cf000c9/project/018e705a-a1a7-409a-a849-3013485e6c8e.svg)](https://wakatime.com/badge/user/915e5316-99c6-4563-a483-ef186cf000c9/project/018e705a-a1a7-409a-a849-3013485e6c8e) [![codecov](https://codecov.io/gh/Soulter/AstrBot/graph/badge.svg?token=FF3P5967B8)](https://codecov.io/gh/Soulter/AstrBot) [

](https://api.gitsponsors.com/api/badge/link?p=XEpbdGxlitw/RbcwiTX93UMzNK/jgDYC8NiSzamIPMoKvG2lBFmyXhSS/b0hFoWlBBMX2L5X5CxTDsUdyvcIEHTOfnkXz47UNOZvMwyt5CzbYpq0SEzsSV1OJF1cCo90qC/ZyYKYOWedal3MhZ3ikw==) 查看文档｜问题提交

AstrBot 是一个松耦合、异步、支持多消息平台部署、具有易用的插件系统和完善的大语言模型（LLM）接入功能的聊天机器人及开发框架。 ## ✨ 主要功能 1. **大语言模型对话**。支持各种大语言模型，包括 OpenAI API、Google Gemini、Llama、Deepseek、ChatGLM 等，支持接入本地部署的大模型，通过 Ollama、LLMTuner。具有多轮对话、人格情境、多模态能力，支持图片理解、语音转文字（Whisper）。 2. **多消息平台接入**。支持接入 QQ（OneBot）、QQ 频道、微信（Gewechat、VChat）、Telegram。后续将支持钉钉、飞书、Discord、WhatsApp、小爱音响。支持速率限制、白名单、关键词过滤、百度内容审核。 3. **Agent**。原生支持部分 Agent 能力，如代码执行器、自然语言待办、网页搜索。对接 [Dify 平台](https://astrbot.app/others/dify.html)，便捷接入 Dify 智能助手、知识库和 Dify 工作流。 4. **插件扩展**。深度优化的插件机制，支持[开发插件](https://astrbot.app/dev/plugin.html)扩展功能，极简开发。已支持安装多个插件。 5. **可视化管理面板**。支持可视化修改配置、插件管理、日志查看等功能，降低配置难度。集成 WebChat，可在面板上与大模型对话。 6. **高稳定性、高模块化**。基于事件总线和流水线的架构设计，高度模块化，低耦合。 > [!TIP] > 管理面板在线体验 Demo: [https://demo.astrbot.app/](https://demo.astrbot.app/) > > 用户名: `astrbot`, 密码: `astrbot`。未配置 LLM，无法在聊天页使用大模型。（不要再修改 demo 的登录密码了 😭） ## ✨ 使用方式 #### Docker 部署请参阅官方文档 [使用 Docker 部署 AstrBot](https://astrbot.app/deploy/astrbot/docker.html#%E4%BD%BF%E7%94%A8-docker-%E9%83%A8%E7%BD%B2-astrbot) 。 #### Windows 一键安装器部署需要电脑上安装有 Python（>3.10）。请参阅官方文档 [使用 Windows 一键安装器部署 AstrBot](https://astrbot.app/deploy/astrbot/windows.html) 。 #### Replit 部署 [![Run on Repl.it](https://repl.it/badge/github/Soulter/AstrBot)](https://repl.it/github/Soulter/AstrBot) #### CasaOS 部署社区贡献的部署方式。请参阅官方文档 [通过源码部署 AstrBot](https://astrbot.app/deploy/astrbot/casaos.html) 。 #### 手动部署请参阅官方文档 [通过源码部署 AstrBot](https://astrbot.app/deploy/astrbot/cli.html) 。 ## ⚡ 消息平台支持情况 | 平台 | 支持性 | 详情 | 消息类型 | | -------- | ------- | ------- | ------ | | QQ | ✔ | 私聊、群聊 | 文字、图片、语音 | | QQ 官方API | ✔ | 私聊、群聊，QQ 频道私聊、群聊 | 文字、图片 | | 微信 | ✔ | [Gewechat](https://github.com/Devo919/Gewechat)。微信个人号私聊、群聊 | 文字、图片、语音 | | [Telegram](https://github.com/Soulter/astrbot_plugin_telegram) | ✔ | 私聊、群聊 | 文字、图片 | | 微信对话开放平台 | 🚧 | 计划内 | - | | 飞书 | 🚧 | 计划内 | - | | Discord | 🚧 | 计划内 | - | | WhatsApp | 🚧 | 计划内 | - | | 小爱音响 | 🚧 | 计划内 | - | # 🦌 接下来的路线图 > [!TIP] > 欢迎在 Issue 提出更多建议 <3 - [ ] 完善并保证目前所有平台适配器的功能一致性 - [ ] 优化插件接口 - [ ] 默认支持更多 TTS 服务，如 GPT-Sovits - [ ] 完善“聊天增强”部分，支持持久化记忆 - [ ] 规划 i18n ## ❤️ 贡献欢迎任何 Issues/Pull Requests！只需要将你的更改提交到此项目：) 对于新功能的添加，请先通过 Issue 讨论。 ## 🌟 支持 - Star 这个项目！ - 在[爱发电](https://afdian.com/a/soulter)支持我！ - 在[微信](https://drive.soulter.top/f/pYfA/d903f4fa49a496fda3f16d2be9e023b5.png)支持我~ ## ✨ Demo > [!NOTE] > 代码执行器的文件输入/输出目前仅测试了 Napcat(QQ), Lagrange(QQ)

_✨基于 Docker 的沙箱化代码执行器（Beta 测试中）✨_

_✨ 多模态、网页搜索、长文本转图片（可配置） ✨_

_✨ 自然语言待办事项 ✨_

_✨ 插件系统——部分插件展示 ✨_

_✨ 管理面板 ✨_ ![webchat](https://drive.soulter.top/f/vlsA/ezgif-5-fb044b2542.gif) _✨ 内置 Web Chat，在线与机器人交互 ✨_

## ⭐ Star History > [!TIP] > 如果本项目对您的生活 / 工作产生了帮助，或者您关注本项目的未来发展，请给项目 Star，这是我维护这个开源项目的动力 <3 [![Star History Chart](https://api.star-history.com/svg?repos=soulter/astrbot&type=Date)](https://star-history.com/#soulter/astrbot&Date) _アトリは、高性能ですから!_