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 部署等多种便捷的部署方案。

! [界面预览]

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

安装

这里以在群晖 NAS 上通过 Docker 方式安装为例。

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

注意：具体版本号可能随时间更新，建议始终使用 latest 获取最新特性。

! [界面预览]

命令行方式部署

对于习惯命令行的朋友，直接运行以下指令更快捷。

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

! [界面预览]

运行

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

默认账户和密码均为：astrbot

! [界面预览]

第一次登录成功，需要修改默认的密码以确保安全。

! [界面预览]

大模型配置

进入后台后，点击 模型提供商 --> 新增。

! [界面预览]

支持的提供商比较多，只要添加对应的 Key 就可以。

! [界面预览]

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

! [界面预览]

目前部分服务商注册会有代金券赠送，可用于 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/