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

发布日期：2026-02-18 19:08:06 浏览次数： 5920

作者：各种折腾

微信搜一搜，关注“各种折腾”

简介

什么是 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 更快捷

# 新建文件夹 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 文件

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 登录到您的群晖，执行下面的命令：

# 新建文件夹 astrbot 和 子目录
mkdir -p /volume1/docker/astrbot/data

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

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

# 一键启动
docker-compose up -d