AstrBotDevs/AstrBot

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

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

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

核心功能

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

快速开始

一键部署

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

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

需要安装 uv。 AstrBot 需要 Python 3.12 或更高版本。--python 3.12 参数确保 uv 在 Python 3.12 环境下创建工具。

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

更新 astrbot：

uv tool upgrade astrbot --python 3.12

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

Docker 部署

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

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

RainYun 部署

对于想要一键部署且不想自行维护服务器的用户，我们推荐 RainYun 的一键云部署服务 ☁️：

桌面端应用部署

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

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

启动器 (Launcher) 部署

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

访问 AstrBot Launcher 进行下载安装。

Replit 部署

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

AUR

AUR 部署针对喜欢通过系统包管理流程安装 AstrBot 的 Arch Linux 用户。

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

yay -S astrbot-git

更多部署方式

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