基于 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
这个命令会:
- 创建项目目录
- 下载官方提供的 docker-compose 配置文件
- 启动两个容器服务:
- NapCat:QQ 机器人中间件。

