AstrBot: A Python repository from AstrBot AI

English ｜日本語｜文档｜ Blog ｜路线图｜问题提交

AstrBot 是一个开源的一站式 Agent 聊天机器人平台及开发框架。

主要功能

大模型对话。支持接入多种大模型服务。支持多模态、工具调用、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：

pip install uv

通过 Git Clone 安装 AstrBot：

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

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

🌍 社区

QQ 群组

1 群：322154837
3 群：630166526
5 群：822130018
6 群：753075035
开发者群：975206796

Telegram 群组

Discord 群组

支持的消息平台

官方维护

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

社区维护

支持的模型服务

大模型服务

OpenAI 及兼容服务
Anthropic
Google Gemini
Moonshot AI
智谱 AI
DeepSeek
Ollama (本地部署)
LM Studio (本地部署)
优云智算
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

❤️ Special Thanks

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

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

NapNeko/NapCatQQ - 伟大的猫猫框架

⭐ Star History

Tip

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

私は、高性能ですから!

AstrBotDevs/AstrBot