AstrBot 开源 AI 聊天机器人部署与配置指南

简介

什么是 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。

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'
services:
  astrbot:
    image: soulter/astrbot:latest
    container_name: astrbot
    restart: always
    ports:
      - "6185:6185"
      - "6199:6199"
    environment:
      - TZ=Asia/Shanghai
    volumes:
      - ./data:/AstrBot/data
      - /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

运行

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

默认账户和密码均为：astrbot

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

大模型

模型提供商 --> 新增。

支持的提供商比较多。

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

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

目前硅基流动（SiliconFlow）注册送代金券。

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

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

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

可以切换到纯聊天模式。

机器人

机器人 --> 创建机器人。

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

以 QQ 机器人 为例，获取 QQ 机器人凭证的方法，可参照相关文档。

我们已经完成了基本设置。

可以开始在 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/