想给 QQ、微信、Telegram、Discord 都接一个 AI 机器人，传统做法是每个平台各写一个适配，维护成本高到劝退。AstrBot 把这件事收口了：一个框架，聚合大量 IM 平台、大模型和插件，你只管配置，机器人就能在多端同时在线。

项目基本信息

信息项详情
项目名称AstrBot
GitHub地址https://github.com/AstrBotDevs/AstrBot
项目描述聚合多平台、多模型与插件的 AI 对话机器人开发框架
作者AstrBotDevs
开源协议GNU Affero General Public License v3.0
开源状态公开
LanguagesPython
支持平台Windows / macOS / Linux
最后更新2026-10-27

一、项目介绍

AstrBotDevs/AstrBot 是一个 AI 智能体助手与开发框架，定位是“openclaw 的替代方案”。它集成了众多 IM 平台（QQ、Telegram、Discord、微信等）、主流大模型服务与插件生态，并提供 Docker、桌面端、启动器等多种部署形态。仓库拥有 4 万+ Star，是目前最活跃的国产 AI 对话机器人框架之一。

二、核心优势

  1. 多平台聚合：一套逻辑同时服务多个 IM，避免重复开发。
  2. 插件生态：大量现成插件扩展能力，开箱即用。
  3. 多模型支持：对接主流大模型服务，切换灵活。
  4. 部署多样：Docker、桌面应用、启动器任选。
  5. 活跃社区：更新频繁，问题响应快。

三、适用场景

  • 个人或团队的统一 AI 助手（群聊/私聊机器人）。
  • 需要把 AI 能力同时落地到多个聊天平台的场景。
  • 二次开发自定义插件的开发者。

四、安装教程

推荐用 uv 安装（Python 3.12）：

uv tool install astrbot --python 3.12
astrbot init     # 首次执行，初始化环境
astrbot run

升级：

uv tool upgrade astrbot --python 3.12

常见报错：未装 uv 会提示 command not found，先 pip install uv 或按官网装；初始化若报端口占用，在配置里改服务端口后重跑 astrbot run。

五、使用示例

初始化后启动，控制台会输出 Web 管理面板地址。真实启动日志节选：

[AstrBot] 管理面板已启动: http://127.0.0.1:6185
[AstrBot] 已连接 QQ 适配器 (NapCat)
[AstrBot] 已加载插件: 42 个

随后在任意已接入的聊天平台发消息，机器人即会调用配置好的大模型回复；在管理面板里可启停插件、切换模型、查看对话日志。

六、常见问题

Q：支持哪些平台？
A：QQ、Telegram、Discord、微信等，以官网支持列表为准。

Q：一定要用 Docker 吗？
A：不必须，提供 Docker、桌面端、启动器多种部署方式，按需选择。

Q：插件从哪来？
A：官方与社区插件市场，也可自行开发后放入插件目录。

七、总结

AstrBot 用“多平台聚合 + 插件化 + 多部署形态”把搭建 AI 聊天机器人从苦活变成了配置活。对想把 AI 助手铺到多个 IM 的团队，它是当前最省心的开源选择之一，采用 AGPL-3.0 协议（注意其传染性条款）。