AstrBot+NapCat 一键部署智能 QQ 机器人及 cpolar 公网访问
本教程演示如何使用 Docker 一键部署 AstrBot + NapCat,将 DeepSeek AI 接入 QQ。AstrBot 是专为 AI 大模型设计的开源聊天机器人框架,NapCat 是基于 NTQQ 的 OneBot 协议实现。
1. 项目介绍
1.1 AstrBot 是什么?
GitHub 仓库:https://github.com/AstrBotDevs/AstrBot
AstrBot 是一个专为 AI 大模型设计的开源聊天机器人框架,支持将 ChatGPT、DeepSeek、Claude 等 AI 接入到 QQ、企业微信、Discord 等平台。
核心特点:
- 原生支持主流 AI 模型:DeepSeek、OpenAI、Claude、GLM、通义千问等开箱即用
- 丰富的插件生态:天气查询、图片生成、语音合成等功能一键安装
- 多平台适配:支持 QQ、QQ 频道、Discord、Telegram 等多个平台
- 开箱即用:提供 Docker 镜像和 WebUI 管理界面
- 模块化设计:通过 OneBot 标准协议对接各类消息平台
1.2 NapCat 是什么?
仓库地址:https://github.com/NapNeko/NapCatQQ
NapCat 是一个基于 NTQQ(QQ 官方 Linux 版本)的 OneBot 协议实现框架,能让 QQ 账号通过标准化接口被机器人程序调用。
核心特点:
- 稳定可靠:基于官方 QQ Linux 版本
- 持续维护:项目活跃开发中
- 标准协议:完整实现 OneBot v11 协议
- Docker 友好:官方提供 Docker 镜像
2. 使用 Docker 一键部署 AstrBot + NapCat
本教程演示在 Windows 11 操作系统上的 Docker 一键部署,Linux 环境部署方式类似。
2.1 Windows 部署
打开 PowerShell 窗口,输入如下命令:
irm https://gitee.com/jun-wan/script/raw/master/astrbot/deploy_astrbot.ps1 | iex
命令执行后会自动检查 Docker 状态、创建文件夹、下载 docker-compose 文件并启动容器。
2.2 Linux 部署
依次执行如下命令:
mkdir astrbot
cd astrbot
wget https://raw.githubusercontent.com/NapNeko/NapCat-Docker/main/compose/astrbot.yml
sudo docker compose -f astrbot.yml up -d
或者执行一键部署命令:
curl -fsSL https://gitee.com/jun-wan/script/raw/master/astrbot/deploy_astrbot.sh | bash
部署完成后,访问以下地址:


