跳转到主要内容
Home / 实用工具 / 2026.04.20

AstrBot:30K Star 的开源 IM 聊天机器人,一条命令接入 15 个聊天平台

AstrBot 是目前最活跃的开源 Agent 聊天机器人框架,GitHub 30.8K Star,支持 QQ、Telegram、飞书、钉钉等 15 个 IM 平台一键接入,内置 1000+ 插件市场、知识库、MCP 工具调用和 Agent 沙箱。Python 一行命令部署,Docker Compose 开箱即用。

AstrBot 今天更新到了 v4.23.6。这个版本号本身就能说明一些事情——从 2025 年 9 月 v4.0.0 重构发布到现在,7 个月里迭代了 200+ 个版本,GitHub Star 从零涨到 30,800,Fork 数 2,100+,提交数 4,561。在中国开源聊天机器人这个赛道上,这个增长速度没有第二家。

AstrBot 的定位很清晰:一个开源的一站式 Agent 聊天机器人平台,让任何人都能在 5 分钟内把 AI 接入自己最常用的聊天工具。不管你用的是 QQ、Telegram、飞书还是钉钉,不管你后端想接 OpenAI、Gemini 还是本地 Ollama,AstrBot 都能帮你串起来。

这工具好在哪

市面上聊天机器人框架不少,但 AstrBot 解决了一个被长期忽视的核心痛点:IM 平台割裂

你想在 QQ 上用 AI 助手,得找 QQ 机器人框架;想在 Telegram 上用,得写 Bot API;想在飞书上用,得对接飞书开放平台——三个平台,三套协议,三份代码。AstrBot 把这些全统一了:一个后端,同时接入 15 个 IM 平台,配置一次,处处运行。

这种"一次配置,全平台可达"的设计,对个人用户意味着不用在每个聊天工具里分别折腾 AI 接入;对企业用户意味着一套系统覆盖所有内部沟通渠道。

AstrBot 的核心价值不在"又做了一个聊天机器人"——而在于它把 IM 平台的碎片化问题变成了一个配置问题。从"每个平台写一套代码"到"每个平台填一个配置",这是量级差异。

核心功能

15 个 IM 平台一键接入

平台 协议 维护状态
QQ OneBot v11(NapCatQQ) 官方维护
企业微信 企业微信 API 官方维护
企业微信 AI 助手 企业微信 AI Bot API 官方维护
微信公众号 公众平台 API 官方维护
Telegram Bot API 官方维护
飞书(Lark) 开放平台 API 官方维护
钉钉 开放平台 API 官方维护
Slack Bot API 官方维护
Discord Bot API 官方维护
LINE Messaging API 官方维护
KOOK Bot API 官方维护
Misskey API 官方维护
Mattermost API 官方维护
Satori 协议适配 官方维护
WhatsApp 即将支持
Matrix 社区维护
Rocket.Chat 社区维护
VoceChat 社区维护

15 个平台官方维护是什么概念?对比同类项目:NoneBot2 支持 6 个适配器(社区维护为主),LangChain 没有原生 IM 集成。AstrBot 在 IM 覆盖面上目前没有竞品。

20+ 大模型后端支持

类别 支持的服务
通用 LLM OpenAI 及兼容接口、Anthropic Claude、Google Gemini
国产 LLM DeepSeek、智谱 AI、月之暗面 Moonshot
自托管 LLM Ollama、LM Studio
API 网关 AIHubMix(全模型支持)、OneAPI、302.AI、SiliconFlow、TokenPony、CompShare、PPIO 云、ModelScope
LLMOps 平台 Dify、阿里云百炼、Coze
语音识别(STT) OpenAI Whisper、SenseVoice、小米 MiMo Omni
语音合成(TTS) OpenAI TTS、Gemini TTS、GPT-Sovits、FishAudio、Edge TTS、Azure TTS、Minimax TTS、火山引擎 TTS、阿里云百炼 TTS、小米 MiMo TTS

值得单独提的是 LLMOps 平台集成——如果你已经在 Dify 上搭了一套工作流,不需要迁移,AstrBot 直接作为 Dify 的前端对话接口。这种"不替换你现有工具,而是帮你接入 IM"的思路,是 AstrBot 和纯聊天框架的核心区别。

Agent 沙箱

AstrBot 内置了 Agent 沙箱环境,支持:

  • 代码执行(Python)
  • Shell 命令调用
  • 会话级资源复用(变量在会话内持久化)
  • 沙箱隔离(不会影响宿主系统)

这意味着你可以让 AI 直接在聊天里帮你写代码、跑脚本、操作文件——而不需要离开对话窗口。沙箱隔离确保了安全性:AI 可以执行代码,但动不了你的系统。

1000+ 插件市场

AstrBot 的插件系统是它生态扩张最快的部分。1000+ 插件覆盖了:

插件类别 典型功能
角色扮演 AI 女友/男友、虚拟角色对话
效率工具 翻译、总结、代码审查
知识库 RAG 文档问答、企业知识管理
多媒体 图片生成、语音合成、视频处理
自动化 定时任务、Webhook 触发、工作流编排
游戏 文字冒险、猜词、桌游

插件一键安装,WebUI 里搜索、点击、启用——不需要手动下载或编辑配置文件。

MCP 工具调用

MCP(Model Context Protocol)是 2025 年最热门的 AI 工具调用协议。AstrBot 原生支持 MCP,意味着你可以让 AI 调用外部工具:搜索引擎、数据库查询、API 调用——只要是 MCP 兼容的工具,AstrBot 都能直接用。

知识库 + 人格设定

  • 知识库:上传文档(PDF/Word/TXT),AstrBot 自动构建向量索引,对话时自动检索相关内容
  • 人格设定:自定义 AI 的角色、语气、行为规则——从"专业客服"到"二次元老婆"一行配置

怎么部署

方式一:uv 一键部署(推荐)

# 安装 uv(如果还没有)
curl -LsSf https://astral.sh/uv/install.sh | sh

# 一键安装 AstrBot
uv tool install astrbot --python 3.12

# 初始化(仅首次执行)
astrbot init

# 启动
astrbot run

启动后访问 http://localhost:6185 打开 WebUI 管理面板。

更新到最新版:

uv tool upgrade astrbot --python 3.12

AstrBot 要求 Python ≥ 3.12。--python 3.12 参数确保 uv 创建正确的 Python 环境,不需要你系统全局安装 Python 3.12。

方式二:Docker Compose 部署

# 创建目录
mkdir astrbot && cd astrbot

# 下载 compose 文件
curl -O https://raw.githubusercontent.com/AstrBotDevs/AstrBot/master/compose.yml

# 启动
docker compose up -d

compose.yml 内容:

version: '3.8'
services:
  astrbot:
    image: soulter/astrbot:latest
    container_name: astrbot
    restart: always
    security_opt:
      - no-new-privileges:true
    ports:
      - "6185:6185"  # WebUI
      - "6199:6199"  # OneBot v11(可选)
    environment:
      - TZ=Asia/Shanghai
    volumes:
      - ./data:/AstrBot/data
      - /etc/localtime:/etc/localtime:ro

Docker 方式适合服务器长期运行,数据持久化在 ./data 目录。

方式三:其他部署方式

方式 适合场景
RainYun 一键云部署 不想管理服务器
AstrBot Desktop App 桌面用户,主要用 ChatUI
AstrBot Launcher 桌面多实例管理
AUR(yay -S astrbot-git Arch Linux 用户
宝塔面板 服务器已有宝塔
1Panel 应用商店 服务器已有 1Panel
CasaOS NAS / 家庭服务器
Replit 在线演示和轻量试用

怎么用

1. 配置大模型

打开 WebUI(http://localhost:6185)→ 进入"模型配置" → 选择你的 LLM 提供商 → 填入 API Key → 保存。

本地部署用户选择 Ollama,填入 http://localhost:11434 即可,无需 API Key。

2. 接入聊天平台

WebUI → "平台配置" → 选择平台 → 填入对应的 Token / Bot Key → 保存 → 重启。

以 Telegram 为例:找 @BotFather 创建 Bot → 拿到 Token → 填入 AstrBot → 你的 Telegram Bot 立刻拥有 AI 对话能力。

3. 安装插件

WebUI → "插件市场" → 搜索 → 点击"安装" → 启用。不需要重启,热加载生效。

4. 配置知识库

WebUI → "知识库" → 上传文档 → 自动构建索引 → 在对话中 AI 会自动检索相关内容回答。

5. 设定人格

WebUI → "人格设定" → 编写 System Prompt → 保存。支持多套人格方案切换。

定价方案

版本 价格 说明
AstrBot 开源版 免费 全部功能,无限制,AGPL-3.0 许可证
云端托管(RainYun) 按云服务商定价 不需要自己管服务器

AstrBot 本身完全免费。费用只产生在你使用的 LLM API 上——用 OpenAI 就付 OpenAI 的钱,用 Ollama 本地模型则零成本。没有中间商加价,没有平台抽成。

场景 月成本估算
个人使用 + Ollama 本地模型 ¥0(电费除外)
个人使用 + DeepSeek API ¥5-20
小团队 + OpenAI GPT-4o ¥50-200
企业客服 + 专业知识库 ¥200-1000

竞品对比

维度 AstrBot NoneBot2 ChatGPT-Next-Web Dify
定位 IM 聊天机器人平台 聊天机器人框架 ChatGPT Web 客户端 LLMOps 平台
IM 平台支持 15 个 6 个(社区适配器) 无(纯 Web) 无(需自行接入)
插件生态 1000+ 200+ 主题/模型扩展 工具节点
Agent 能力 MCP + 沙箱 + 技能 需自行实现 工作流编排
知识库 内置 RAG 需插件 内置
部署难度 一条命令 需 Python 开发经验 Docker Docker
WebUI ✅ 管理面板 + ChatUI ✅ NoneFlow(可选) ✅ 聊天界面 ✅ 工作流编辑器
开源协议 AGPL-3.0 MIT MIT 自定义(部分功能闭源)
GitHub Star 30.8K 22K+ 78K+ 90K+
目标用户 普通用户 + 开发者 开发者 普通用户 开发者 + 企业

NoneBot2 是开发者框架——你需要写 Python 代码来实现功能。AstrBot 是平台——你通过 WebUI 配置来完成。这是本质区别:NoneBot2 给你造车的零件,AstrBot 给你一辆能开的车。

ChatGPT-Next-Web 只是 Web 聊天界面,没有 IM 集成能力。Dify 是 LLMOps 平台,擅长工作流编排但不直接对接聊天工具——实际上 AstrBot 可以作为 Dify 的 IM 前端,两者互补。

AstrBot 填补了一个市场空白:它是唯一一个"开箱即用 + 全平台 IM 覆盖 + Agent 能力"三位一体的开源聊天机器人平台。NoneBot2 需要开发能力,ChatGPT-Next-Web 没有 IM 集成,Dify 不直接对话——AstrBot 是那个把这三件事一起做了的项目。

写在最后

30K Star 和 12 个满员的 QQ 群说明一件事:把 AI 接入 IM 这件事,需求远比大多数人想象的大。不是每个人都需要在自己的终端里跑 AI——更多的人想在 QQ 群里 @ 一下就能用,在飞书里直接问,在 Telegram 里随手聊。AstrBot 的价值不在技术多先进,而在于它把这个过程从"写代码"变成了"填配置"。

当所有人都在做更强的模型时,AstrBot 做了一件同样重要的事——让模型到你手边的距离,从"打开浏览器访问 API"缩短到"在你最常用的聊天工具里 @ 一下"。技术民主化不只是模型开源,还有接入方式的零门槛化。