AstrBot：让每个聊天软件都拥有AI Agent

发表于 分类于 Waline： 阅读次数： 本文字数： 3.1k 阅读时长 ≈ 3 分钟
AstrBot 是一个开源、可扩展的一站式 Agentic 个人与群聊助手，支持 QQ、企业微信等数十种平台和近800个插件。

简介

什么是 AstrBot ？

AstrBot 是一个开源、免费的一站式 Agentic 个人与群聊助手。它提供了一个可靠、可扩展的对话式智能基础设施，能够集成多种即时通讯平台（如QQ、企业微信、Telegram等）、大型语言模型（LLMs）、功能插件和各种AI能力。你可以将其视为一个强大的、可自行部署的个人 AI 伙伴、智能客服、自动化助手，和企业知识库。

主要特点

  • 免费与开源：项目完全免费并遵循 AGPL-3.0 许可证。
  • 强大的AI能力：支持多模态、Agent、知识库、人格设定和自动对话压缩等高级 AI 功能。
  • Agent 能力：完善的 Agentic 能力，支持多轮工具调用、MCP、Skills、内置沙箱代码执行器、网页搜索等
  • 广泛的平台支持：支持 QQ、企业微信、飞书、钉钉、Telegram 等数十款主流即时通讯软件。
  • 丰富的插件生态：拥有近 800 个一键安装的插件，极大地扩展了机器人的功能。
  • 高可扩展性：支持接入 Dify、阿里云百炼、Coze 等多种智能体平台，并支持 OpenAI、Gemini、智谱 AI、Ollama 等几乎所有主流的大模型服务。
  • 安全与隔离：提供 Agent Sandbox（沙箱环境），可以安全地执行代码和调用 Shell。
  • 可视化管理面板：提供 WebUI 管理面板，支持配置修改、插件管理、日志查看，集成 WebChat 可直接与机器人对话
  • 多样的部署方式：支持 Docker、Windows一键安装包、CasaOS 部署等多种便捷的部署方案。

应用场景

  • 个人AI助手：作为你的私人 AI 伙伴，提供对话、情感陪伴和自动化任务处理。
  • 智能客服：在各种平台上快速搭建智能客服，自动回答用户问题。
  • 企业知识库问答：通过知识库插件 + RAG 技术，让机器人基于私有数据进行精准问答
  • 群聊管理助手：在 QQ 群、微信群中部署群管机器人，实现自动回复、内容审核等功能
  • 自动化工作流：结合 Dify 工作流或插件，实现定时推送、数据采集、消息转发等自动化任务
  • AI 角色扮演：利用人格设定功能，打造个性化的 AI 角色

AstrBot 是一个功能强大且灵活的 AI 聊天机器人，适用于广泛的应用场景，满足个人用户和企业的需求。

安装

在群晖上以 Docker 方式安装。

在注册表中搜索 astrbot ，选择 soulter/astrbot，版本选择 latest。

本文写作时， latest 版本对应为 v4.17.3；

docker cli 安装

如果你熟悉命令行，可能用 docker cli 更快捷

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# 新建文件夹 astrbot 和 子目录
mkdir -p /volume1/docker/astrbot/data

# 进入 astrbot 目录
cd /volume1/docker/astrbot

# 运行容器
docker run -d \
   --restart unless-stopped \
   --name astrbot \
   -p 6185:6185 \
   -p 6199:6199 \
   -v $(pwd)/data:/AstrBot/data \
   -v /etc/localtime:/etc/localtime:ro \
   -e TZ=Asia/Shanghai \
   soulter/astrbot:latest
  • -p 6185:6185：将主机的 6185 端口映射到容器的 6185 端口，用于访问 AstrBot 的 WebUI。
  • -p 6199:6199：将主机的 6199 端口映射到容器的 6199 端口，用于 QQ 个人号的 WebSocket（可选）。
  • -e TZ=Asia/Shanghai：设置容器的时区，确保时间显示准确。
  • -v $(pwd)/data:/AstrBot/data：将主机中的 data 目录挂载到容器的 /AstrBot/data，用于数据的持久化存储。

如果需要使用 Agent Sandbox（沙箱代码执行器），请额外添加 -v /var/run/docker.sock:/var/run/docker.sock 参数。

docker-compose 安装

也可以用 docker-compose 安装，将下面的内容保存为 docker-compose.yml 文件

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
version: '3.8'

# 当接入 QQ NapCat 时，请使用这个 compose 文件一键部署: https://github.com/NapNeko/NapCat-Docker/blob/main/compose/astrbot.yml
services:
  astrbot:
    image: soulter/astrbot:latest
    container_name: astrbot
    restart: always
    ports: # mappings description: https://github.com/AstrBotDevs/AstrBot/issues/497
      - "6185:6185" # 必选，AstrBot WebUI 端口
      - "6199:6199" # 可选, QQ 个人号 WebSocket 端口
      # - "6195:6195" # 可选, 企业微信 Webhook 端口
      # - "6196:6196" # 可选, QQ 官方接口 Webhook 端口
    environment:
      - TZ=Asia/Shanghai
    volumes:
      - ./data:/AstrBot/data
      # - /etc/timezone:/etc/timezone:ro
      - /etc/localtime:/etc/localtime:ro

然后通过 SSH 登录到您的群晖，执行下面的命令：

1
2
3
4
5
6
7
8
9
10
# 新建文件夹 astrbot 和 子目录
mkdir -p /volume1/docker/astrbot/data

# 进入 astrbot 目录
cd /volume1/docker/astrbot

# 将 docker-compose.yml 放入当前目录

# 一键启动
docker-compose up -d

运行

部署成功后，在浏览器中输入 http://群晖IP:6185 就能看到登录界面

默认账户和密码均为：astrbot

第一次登录成功，需要修改默认的密码

大模型

模型提供商 –> 新增

支持的提供商比较多

只要添加 硅基流动 的 Key 就可以

如果 Key 没问题，点 获取模型列表 会显示可用的模型

目前硅基流动（SiliconFlow）注册就送 16 元的代金券

注册地址：

https://cloud.siliconflow.cn/i/NkUiXVhQ

和之前的不同，现在的券虽然多了2块钱，但是有有效期，不过可以用于 Pro/ 开始的模型

后续准备试试七牛，据说可以用国外的大模型

注册地址：

https://s.qiniu.com/2ENRR3

点模型后面的 + 号添加指定的模型，然后再启用一下

可以切换到纯聊天模式

机器人

机器人 –> 创建机器人

支持的机器人种类比较多，不仅仅是国内的，也支持国外的

以 QQ 机器人 为例，获取 QQ 机器人凭证的方法，可参照前文👇

文章传送门： 将QQ接入OpenClaw的详细教程

我们已经完成了基本设置

可以开始在 QQ 中聊天了

参考文档

AstrBotDevs/AstrBot: Agentic IM Chatbot infrastructure that integrates lots of IM platforms, LLMs, plugins and AI features. Your openclaw alternative. ✨
地址：https://github.com/AstrBotDevs/AstrBot

AstrBot - 多平台大模型机器人基础设施
地址：https://astrbot.app/

AstrBot
地址：https://docs.astrbot.app/