AstrBotDevs/AstrBot

这是什么？

核心功能

• 01可接入 QQ、Telegram、Slack、Discord、飞书、钉钉等多个消息平台。
• 02支持 OpenAI 兼容接口、Anthropic、Gemini、Ollama 等多种大模型服务。
• 03内置 MCP 支持、知识库、人设配置和自动上下文压缩。
• 04提供 Agent 沙箱，用于隔离执行代码和 Shell 命令。
• 05提供插件系统与插件市场，并附带 WebUI 进行管理。

适用场景

• 在 QQ 或 Telegram 中运行个人 AI 陪伴助手。
• 为团队的即时通讯平台搭建客服机器人。
• 在聊天应用中基于内部知识库回答问题。
• 通过 Agent 工具和插件自动化日常任务。

快速上手

1. 1

   安装 uv（前置条件）

2. 2

   使用 uv 安装 AstrBot

   uv tool install astrbot --python 3.12
3. 3

   初始化环境（仅首次执行）

   astrbot init
4. 4

   启动 AstrBot

   astrbot run

使用前须知

• !快速安装需要 Python 3.12+ 环境和 uv。
• !接入大模型和大多数即时通讯平台需要你自己的 API 密钥或平台账号。
• !依赖第三方即时通讯平台和模型服务的可用性。

标签

常见问题

AstrBot 是什么？

开源 Agent 聊天机器人平台，将 LLM、插件与智能体能力接入 QQ、Telegram、Slack 等即时通讯应用。 AstrBot 是一个开源的一体化 Agent 聊天机器人平台，把大语言模型接入主流即时通讯应用。个人用户、开发者和团队可以在已经使用的聊天工具里搭建个人助手、客服机器人、自动化助手或内部知识库机器人。

AstrBot 可以免费使用吗？用的什么许可证？

AstrBot 以 AGPL-3.0 许可证开源。用于商业产品前，请先确认许可证条款。

AstrBot 还在维护吗？

活跃维护中。AstrBot 最近一次提交是在 2026年10月20日。

AstrBot 适合用来做什么？

在 QQ 或 Telegram 中运行个人 AI 陪伴助手。 为团队的即时通讯平台搭建客服机器人。 在聊天应用中基于内部知识库回答问题。 通过 Agent 工具和插件自动化日常任务。

AstrBot 怎么安装和运行？

安装 uv（前置条件） 使用 uv 安装 AstrBot: uv tool install astrbot --python 3.12 初始化环境（仅首次执行）: astrbot init 启动 AstrBot: astrbot run

在哪里获取 AstrBot？

源代码和安装说明在 GitHub 上：https://github.com/AstrBotDevs/AstrBot