AstrBotDevs/AstrBot

简体中文 ｜ 繁體中文 ｜ 日本語 ｜ Français ｜ Русский

文档 ｜ 博客 ｜ 路线图 ｜ 问题追踪 ｜ 邮件支持

AstrBot 是一个开源的一体化 Agent 聊天机器人平台，集成了主流即时通讯应用。它为个人、开发者和团队提供了可靠且可扩展的对话式 AI 基础设施。无论您是在构建个人 AI 伴侣、智能客服、自动化助手，还是企业知识库，AstrBot 都能让您在 IM 平台的工作流中快速构建生产级的 AI 应用。

核心特性

1. 💯 免费且开源。
2. ✨ 支持 AI LLM 对话、多模态、Agent、MCP、技能（Skills）、知识库、角色设定、自动上下文压缩。
3. 🤖 支持集成 Dify、阿里云百炼、Coze 等 Agent 平台。
4. 🌐 多平台支持：QQ、企业微信、飞书、钉钉、微信公众号、Telegram、Slack 以及更多。
5. 📦 插件扩展：拥有 1000+ 可用插件，支持一键安装。
6. 🛡️ Agent Sandbox：用于隔离、安全地执行代码、Shell 调用及会话级资源重用。
7. 💻 支持 WebUI。
8. 🌈 支持 Web ChatUI，内置 Agent Sandbox 和网页搜索功能。
9. 🌐 支持国际化 (i18n)。

快速开始

一键部署

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

uv tool install astrbot
astrbot init # 仅在首次运行时执行此命令以初始化环境
astrbot run

需要安装 uv。

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

更新 astrbot：

uv tool upgrade astrbot

Docker 部署

对于熟悉容器化技术且追求更稳定、生产级部署的用户，我们推荐使用 Docker / Docker Compose 部署 AstrBot。

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

在 RainYun 上部署

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

桌面应用部署

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

访问 AstrBot-desktop 进行下载和安装；此方式专为桌面使用设计，不建议在服务器场景下使用。

启动器 (Launcher) 部署

对于希望快速部署且需要隔离多实例使用的桌面用户，我们推荐 AstrBot Launcher。

访问 AstrBot Launcher 进行下载和安装。

在 Replit 上部署

Replit 部署方式由社区维护，适用于在线演示和轻量级试用。

AUR 部署

AUR 部署适用于倾向于通过系统包管理工作流安装 AstrBot 的 Arch Linux 用户。

运行以下命令安装 astrbot-git，然后在本地环境中启动 AstrBot。

yay -S astrbot-git

更多部署方式

如果您需要基于面板的管理或更深度的自定义配置，请查看 BT-Panel 部署（宝塔面板）、1Panel 部署、CasaOS 部署（用于 NAS/家庭服务器可视化部署），以及 手动部署（基于 uv 的完全自定义源码安装）。

支持的即时通讯平台

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

平台	维护者
QQ	官方
OneBot v11 协议实现	官方
Telegram	官方
企业微信 (Wecom) & 企业微信 AI Bot	官方
微信公众号	官方
飞书 (Feishu/Lark)	官方