AstrBot/README.md at c8e34ff26ff27de269569be0615c827c992e178d

opensource/AstrBot

Fork 0

mirror of https://github.com/AstrBotDevs/AstrBot.git synced 2026-09-24 16:39:52 +08:00

Files

T

Soulter 68aa107689 docs: update readme

2025-10-29 13:58:58 +08:00

8.8 KiB

Raw Blame History

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(官方平台)	✔
QQ(OneBot)	✔
Telegram	✔
企微应用	✔
企微智能机器人	✔
微信客服	✔
微信公众号	✔
飞书	✔
钉钉	✔
Slack	✔
Discord	✔
Satori	✔
Misskey	✔
Whatsapp	将支持
LINE	将支持

社区维护

平台	支持性
KOOK	✔
VoceChat	✔
Bilibili 私信	✔
wxauto	✔

⚡ 提供商支持情况

大模型服务

名称	支持性	备注
OpenAI	✔	支持任何兼容 OpenAI API 的服务
Anthropic	✔
Google Gemini	✔
Moonshot AI	✔
智谱 AI	✔
DeepSeek	✔
Ollama	✔	本地部署 DeepSeek 等开源语言模型
LM Studio	✔	本地部署 DeepSeek 等开源语言模型
优云智算	✔
302.AI	✔
小马算力	✔
硅基流动	✔
PPIO 派欧云	✔
ModelScope	✔
OneAPI	✔
Dify	✔
阿里云百炼应用	✔
Coze	✔

语音转文本服务

名称	支持性	备注
Whisper	✔	支持 API、本地部署
SenseVoice	✔	本地部署

文本转语音服务

名称	支持性	备注
OpenAI TTS	✔
Gemini TTS	✔
GSVI	✔	GPT-Sovits-Inference
GPT-SoVITs	✔	GPT-Sovits
FishAudio	✔
Edge TTS	✔	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

私は、高性能ですから!

8.8 KiB Raw Blame History Unescape Escape