前言
每天在 QQ 上处理消息、群聊、管理杂事,你可能也想过:要是能让 AI 帮你回复、整理、自动处理任务,那该多轻松。可当你真的尝试搭建 QQ 机器人时,却会被各种门槛劝退——协议不稳定、环境冲突、依赖难装,甚至连 QQ 登录都变成一件麻烦事。但转折点就在这里:如今你不再需要折腾复杂环境。NapCat 帮你稳定登录 QQ,AstrBot 负责 AI 与功能逻辑,两者通过 OneBot 协议无缝桥接,再配合 Docker,一切都能"一键拉起"。
这篇教程会带你用最简单的方式:只用一份 docker-compose,一次命令,5 分钟以内完成 AstrBot + NapCat 部署,把 DeepSeekAI 接入你的 QQ。AstrBot 本身就是为 AI 而生的现代化机器人框架,插件丰富、支持 DeepSeek/OpenAI 等大模型、带 WebUI、可扩展性强,真正做到"搭好就能用"。照着做,你马上就能拥有属于自己的 QQ AI 机器人。
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 标准协议对接各类消息平台,扩展性强
简单来说,AstrBot 就是一个"AI 机器人中枢",帮你把"AI 能力"和"聊天平台"连接起来,让你专注于功能本身,而不用操心底层实现。
1.2 NapCat 是什么?
仓库地址:https://github.com/NapNeko/NapCatQQ
NapCat 是一个基于 NTQQ(QQ 官方 Linux 版本)的 OneBot 协议实现框架,说人话就是:它能让你的 QQ 账号通过标准化接口被机器人程序调用。
在以前,大家常用的 go-cqhttp 已经停止维护,而 NapCat 作为新一代解决方案,具有以下优势:
核心特点:
- ✅ 稳定可靠:基于官方 QQ Linux 版本,不是逆向破解,稳定性更好
- 🔄 持续维护:项目活跃开发中,及时跟进 QQ 版本更新
- 📡 标准协议:完整实现 OneBot v11 协议,兼容性强
- 🚀 功能完善:支持消息收发、群管理、文件传输、语音图片等全部常用功能
- 🐳 Docker 友好:官方提供 Docker 镜像,部署简单
- 🔐 安全登录:支持扫码登录,无需担心密码泄露
为什么要用 NapCat?
因为 QQ 本身不提供公开的 API 接口给开发者,而 NapCat 就像一个"翻译官",把 QQ 的操作翻译成标准的 OneBot 协议接口,让 AstrBot 这样的机器人框架可以通过 HTTP/WebSocket 来控制你的 QQ 账号收发消息。
简单来说:NapCat 负责登录 QQ 并提供接口,AstrBot 负责处理逻辑和调用 AI,两者配合就能让你的 QQ 变成智能机器人。
2 使用Docker一键部署AstrBot + NapCat
本教程演示在Windows11操作系统上的Docker一键部署,部署方式在其他环境也一致。如果您还没有安装Docker的话,可以参考如下教程:Docker安装——Linux、Windows、MacOS
安装好Docker以后,电脑键盘按快捷键Windows + R键,输入powershell回车,打开Windows PowerShell窗口,输入如下命令:
irm https://gitee.com/jun-wan/script/raw/master/astrbot/deploy_astrbot.ps1 | iex
可以看到,命令执行了检查Docker及状态,创建文件夹,下载astrbot的docker-compose文件astrbot.yml,然后启动容器,以及输出容器的访问地址等。
如果是Linux部署,可以依次执行如下命令即可(官方命令):
mkdir astrbotcd astrbotwget https://raw.githubusercontent.com/NapNeko/NapCat-Docker/main/compose/astrbot.ymlsudo docker compose -f astrbot.yml up -d
也可以执行如下Linux一键部署命令:
curl-fsSL https://gitee.com/jun-wan/script/raw/master/astrbot/deploy_astrbot.sh | bash
控制台提示部署好后,我们依次访问一下,首先访问Astrbot(访问的IP请查看控制台输出的IP,或者使用本地回环地址localhost也可以):
http://localhost:6185
可以发现,成功的访问到啦,接下来再试试访问NapCat:
http://localhost:6099
好啦,都访问成功啦!
3 配置NapCat
首先,在浏览器中打开如下地址,访问NapCat的web登录界面:
http://localhost:6099/
页面上提示,需要输入token进行登录,我们回到控制台,可以看到有一行输出了Token:
如果控制台日志清了,可以通过查看docker容器日志找到,输入如下命令进行查看:
docker logs napcat | Select-String "Token"
将token复制下来,填写web页面中,即可进行登录:
接着,登录上你想要作为机器人的QQ账号,可以选择侧边的扫码登录,登录完成后,会自动跳转到首页:
4 配置AstrBot关联上NapCat
4.1 初始化AstrBot配置
输入AstrBot的访问地址,访问到AstrBot的Web登录界面:
http://localhost:6185
输入用户名和密码astrbot,然后点击登录,登录成功后首次会提示修改账号信息,修改一下然后重新登录即可:
4.2 AstrBot关联NapCat
登录进来后,点击侧边的机器人,然后在页面点击创建机器人按钮,在弹出的窗口中,消息类别选择QQ个人号,并且启用,保存即可:
保存弹出安全提醒的话,直接无视警告并继续创建即可(因为是在本地进行,所以也无需设置Token,当然也可以设置一下),创建好后,会有成功提示:
点击展开平台日志,然后用另一个QQ账号给机器人账号发送消息测试,是否成功通信:
可以看到,成功的接收到了来自另一个账号发送的消息。
5 配置DeepSeek接入AstrBot中
5.1 获取DeepSeek的Api密钥
首先,前往DeepSeek官网的用量信息页面,未登录会先跳转登录页面,登录即可,在该页面可以看到余额和消耗:
https://platform.deepseek.com
接着,点击API keys,进入该页面:
在页面上点击创建 API key的按钮,然后设置一个名称(用于辨识),创建完成后点击复制按钮