ContextQMD
Back to Astrbot

README Zh

README_zh.md

4.24.214.2 KB
Original Source

<div align="center">

<a href="https://github.com/AstrBotDevs/AstrBot/blob/master/README.md">English</a> ｜ <a href="https://github.com/AstrBotDevs/AstrBot/blob/master/README_zh-TW.md">繁體中文</a> ｜ <a href="https://github.com/AstrBotDevs/AstrBot/blob/master/README_ja.md">日本語</a> ｜ <a href="https://github.com/AstrBotDevs/AstrBot/blob/master/README_fr.md">Français</a> ｜ <a href="https://github.com/AstrBotDevs/AstrBot/blob/master/README_ru.md">Русский</a>

<div> <a href="https://trendshift.io/repositories/12875" target="_blank"></a> <a href="https://hellogithub.com/repository/AstrBotDevs/AstrBot" target="_blank"></a> </div> <div>

<a href="https://zread.ai/AstrBotDevs/AstrBot" target="_blank"></a> <a href="https://hub.docker.com/r/soulter/astrbot"></a>

</div>

<a href="https://astrbot.app/">主页</a> ｜ <a href="https://astrbot.app/">文档</a> ｜ <a href="https://blog.astrbot.app/">博客</a> ｜ <a href="https://astrbot.featurebase.app/roadmap">路线图</a> ｜ <a href="https://github.com/AstrBotDevs/AstrBot/issues">问题提交</a> ｜ <a href="mailto:[email protected]">Email</a>

</div>

AstrBot 是一个开源的一站式 Agentic 个人和群聊助手，可在 QQ、Telegram、企业微信、飞书、钉钉、Slack 等数十款主流即时通讯软件上部署，此外还内置类似 OpenWebUI 的轻量化 ChatUI，为个人、开发者和团队打造可靠、可扩展的对话式智能基础设施。无论是个人 AI 伙伴、智能客服、自动化助手，还是企业知识库，AstrBot 都能在你的即时通讯软件平台的工作流中快速构建 AI 应用。

主要功能

  1. 💯 免费 & 开源。
  2. ✨ AI 大模型对话，多模态，Agent，MCP，Skills，知识库，人格设定，自动压缩对话。
  3. 🤖 支持接入 Dify、阿里云百炼、Coze 等智能体平台。
  4. 🌐 多平台，支持 QQ、企业微信、飞书、钉钉、微信公众号、Telegram、Slack 以及更多。
  5. 📦 插件扩展，已有 1000+ 个插件可一键安装。
  6. 🛡️ Agent Sandbox 隔离化环境，安全地执行任何代码、调用 Shell、会话级资源复用。
  7. 💻 WebUI 支持。
  8. 🌈 Web ChatUI 支持，ChatUI 内置代理沙盒、网页搜索等。
  9. 🌐 国际化（i18n）支持。
<table align="center"> <tr align="center"> <th>💙 角色扮演 & 情感陪伴</th> <th>✨ 主动式 Agent</th> <th>🚀 通用 Agentic 能力</th> <th>🧩 1000+ 社区插件</th> </tr> <tr> <td align="center"><p align="center"></p></td> <td align="center"><p align="center"></p></td> <td align="center"><p align="center"></p></td> <td align="center"><p align="center"></p></td> </tr> </table>

快速开始

一键部署

对于想快速体验 AstrBot、且熟悉命令行并能够自行安装 uv 环境的用户，我们推荐使用 uv 一键部署方式 ⚡️。

bash
uv tool install astrbot --python 3.12
astrbot init # 仅首次执行此命令以初始化环境
astrbot run

需要安装 uv。 AstrBot 需要 Python 3.12 或更高版本。--python 3.12 会确保 uv 使用 Python 3.12 创建 tool 环境。

[!NOTE] 对于 macOS 用户：由于 macOS 安全检查，首次运行 astrbot 命令可能需要较长时间（约 10-20 秒）。

更新 astrbot：

bash
uv tool upgrade astrbot --python 3.12

[!WARNING] 通过 uv 部署的 AstrBot 不支持在 WebUI 中进行版本升级。如需更新，请通过命令行执行上述命令。

Docker 部署

对于熟悉容器、希望获得更稳定且更适合生产环境部署方式的用户，我们推荐使用 Docker / Docker Compose 部署 AstrBot。

请参考官方文档 使用 Docker 部署 AstrBot。

在 雨云 上部署

对于希望一键部署 AstrBot 且不想自行管理服务器的用户，我们推荐使用雨云的一键云部署服务 ☁️：

桌面客户端部署

对于希望在桌面端使用 AstrBot、并以 ChatUI 为主要入口的用户，我们推荐使用 AstrBot App。

前往 AstrBot-desktop 下载并安装；该方式面向桌面使用，不推荐服务器场景。

启动器部署

同样在桌面端，希望快速部署并实现环境隔离多开的用户，我们推荐使用 AstrBot Launcher。

前往 AstrBot Launcher 下载并安装。

在 Replit 上部署

Replit 部署由社区维护，适合在线演示和轻量试用场景。

AUR

AUR 方式面向 Arch Linux 用户，适合希望通过系统包管理器安装 AstrBot 的场景。

在终端执行下方命令安装 astrbot-git 包，安装完成后即可启动使用。

bash
yay -S astrbot-git

更多部署方式

若你需要面板化或更高自定义部署，可参考 宝塔面板（BT Panel 应用商店安装）、1Panel（1Panel 应用商店安装）、CasaOS（NAS / 家庭服务器可视化部署）和 手动部署（基于源码与 uv 的完整自定义安装）。

支持的消息平台

将 AstrBot 连接到你常用的聊天平台。

平台维护方
QQ官方维护
OneBot v11官方维护
Telegram官方维护
企微应用 & 企微智能机器人官方维护
微信客服 & 微信公众号官方维护
飞书官方维护
钉钉官方维护
Slack官方维护
Discord官方维护
LINE官方维护
Satori官方维护
KOOK官方维护
Misskey官方维护
Mattermost官方维护
WhatsApp（将支持）官方维护
Matrix社区维护
Rocket.Chat社区维护
VoceChat社区维护

支持的模型提供商

提供商类型
自定义任何 OpenAI API 兼容的服务
OpenAILLM
AnthropicLLM
Google GeminiLLM
Moonshot AILLM
智谱 AILLM
DeepSeekLLM
Ollama (本地部署)LLM
LM Studio (本地部署)LLM
AIHubMixLLM (API 网关, 支持所有模型)
优云智算LLM (API 网关, 支持所有模型)
硅基流动LLM (API 网关, 支持所有模型)
PPIO 派欧云LLM (API 网关, 支持所有模型)
302.AILLM (API 网关, 支持所有模型)
小马算力LLM (API 网关, 支持所有模型)
ModelScopeLLM
OneAPILLM
DifyLLMOps 平台
阿里云百炼应用LLMOps 平台
CozeLLMOps 平台
OpenAI Whisper语音转文本
SenseVoice语音转文本
Xiaomi MiMo Omni语音转文本
OpenAI TTS文本转语音
Gemini TTS文本转语音
GPT-Sovits-Inference文本转语音
GPT-Sovits文本转语音
FishAudio文本转语音
Edge TTS文本转语音
阿里云百炼 TTS文本转语音
Azure TTS文本转语音
Minimax TTS文本转语音
Xiaomi MiMo TTS文本转语音
火山引擎 TTS文本转语音

❤️ 贡献

欢迎任何 Issues/Pull Requests！只需要将你的更改提交到此项目 ：)

如何贡献

你可以通过查看问题或帮助审核 PR（拉取请求）来贡献。任何问题或 PR 都欢迎参与，以促进社区贡献。当然，这些只是建议，你可以以任何方式进行贡献。对于新功能的添加，请先通过 Issue 讨论。

开发环境

AstrBot 使用 ruff 进行代码格式化和检查。

bash
git clone https://github.com/AstrBotDevs/AstrBot
pip install pre-commit
pre-commit install

🌍 社区

QQ 群组

  • 12 群：916228568 (新)
  • 9 群：1076659624 (人满)
  • 10 群：1078079676 (人满)
  • 11 群：704659519 (人满)
  • 1 群：322154837 (人满)
  • 3 群：630166526 (人满)
  • 4 群：1077826412 (人满)
  • 5 群：822130018 (人满)
  • 6 群：753075035 (人满)
  • 7 群：743746109 (人满)
  • 8 群：1030353265 (人满)
  • 开发者群（偏闲聊吹水）：975206796
  • 开发者群（正式）：1039761811

Discord 频道

❤️ Special Thanks

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

<a href="https://github.com/AstrBotDevs/AstrBot/graphs/contributors"> </a>

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

开源项目友情链接：

  • NoneBot2 - 优秀的 Python 异步 ChatBot 框架
  • Koishi - 优秀的 Node.js ChatBot 框架
  • MaiBot - 优秀的拟人化 AI ChatBot
  • nekro-agent - 优秀的 Agent ChatBot
  • LangBot - 优秀的多平台 AI ChatBot
  • ChatLuna - 优秀的多平台 AI ChatBot Koishi 插件
  • Operit AI - 优秀的 AI 智能助手 Android APP

⭐ Star History

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

<div align="center">

</div> <div align="center">

陪伴与能力从来不应该是对立面。我们希望创造的是一个既能理解情绪、给予陪伴，也能可靠完成工作的机器人。

私は、高性能ですから!

</div>