AstrBot + NapCat 快速部署智能 QQ 机器人及 cpolar 公网访问
本教程将演示如何通过 Docker 一键部署 AstrBot 与 NapCat,接入 DeepSeek AI 实现智能对话,并利用 cpolar 实现公网访问。AstrBot 是一个专为 AI 大模型设计的开源聊天机器人框架,NapCat 则是基于 NTQQ 的 OneBot 协议实现,两者配合即可让 QQ 账号变身智能助手。
项目介绍
AstrBot 是什么?
GitHub 仓库:https://github.com/AstrBotDevs/AstrBot
AstrBot 让你轻松把 ChatGPT、DeepSeek、Claude 等 AI 接入到 QQ、企业微信、Discord 等平台。
核心特点:
- 原生支持主流 AI 模型:DeepSeek、OpenAI、Claude、GLM、通义千问等开箱即用
- 丰富的插件生态:天气查询、图片生成、语音合成等功能一键安装
- 多平台适配:支持 QQ、QQ 频道、Discord、Telegram 等多个平台
- 开箱即用:提供 Docker 镜像和 WebUI 管理界面,无需复杂配置
- 模块化设计:通过 OneBot 标准协议对接各类消息平台,扩展性强
简单来说,AstrBot 就是一个"AI 机器人中枢",帮你把"AI 能力"和"聊天平台"连接起来。
NapCat 是什么?
仓库地址:https://github.com/NapNeko/NapCatQQ
NapCat 是一个基于 NTQQ(QQ 官方 Linux 版本)的 OneBot 协议实现框架。它能让你的 QQ 账号通过标准化接口被机器人程序调用。
为什么要用 NapCat?
因为 QQ 本身不提供公开的 API 接口给开发者,而 NapCat 就像一个"翻译官",把 QQ 的操作翻译成标准的 OneBot 协议接口,让 AstrBot 这样的机器人框架可以通过 HTTP/WebSocket 来控制你的 QQ 账号收发消息。
简单来说:NapCat 负责登录 QQ 并提供接口,AstrBot 负责处理逻辑和调用 AI,两者配合就能让你的 QQ 变成智能机器人。
使用 Docker 一键部署
本教程演示在 Windows 11 操作系统上的 Docker 一键部署,Linux 环境也类似。
安装好 Docker 以后,打开 PowerShell 窗口,输入如下命令执行一键部署脚本:
irm https://gitee.com/jun-wan/script/raw/master/astrbot/deploy_astrbot.ps1 | iex
命令执行后会检查 Docker 状态、创建文件夹、下载 astrbot.yml 配置文件并启动容器,最后输出容器的访问地址。
如果是 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
控制台提示部署好后,我们可以访问 AstrBot 和 NapCat 的管理界面。


