Docker 快速部署 AstrBot+NapCat 搭建 QQ 智能客服机器人

基于 Docker 的 AstrBot+NapCat 智能 QQ 机器人实战指南

1. 环境准备与基础概念

在开始部署之前，我们需要先了解几个核心组件及其相互关系。AstrBot 是一个支持多平台的多功能聊天机器人框架，而 NapCat 则是专门为 QQ 设计的机器人中间件。两者结合可以快速搭建一个具备大语言模型能力的 QQ 智能客服系统。

必备环境清单：

• Docker Engine 20.10.0 或更高版本
• Docker Compose 2.0.0 或更高版本
• 至少 4GB 可用内存
• 一个可用于机器人的 QQ 账号（建议使用小号）

注意：QQ 账号需要已经完成设备锁验证，否则可能无法正常登录

对于 Windows 用户，建议使用 WSL2 来运行 Docker。以下是 WSL2 的快速安装命令（以管理员身份运行 PowerShell）：

wsl --install -d Ubuntu 

2. 一键部署流程

2.1 快速启动服务

通过以下命令可以一键部署完整的 AstrBot+NapCat 环境：

mkdir -p ~/astrbot && cd ~/astrbot wget https://raw.githubusercontent.com/NapNeko/NapCat-Docker/main/compose/astrbot.yml docker compose -f astrbot.yml up -d 

这个命令会：

1. 创建项目目录
2. 下载官方提供的 docker-compose 配置文件
3. 启动两个容器服务：
   • NapCat：QQ 机器人中间件。