QQ 接入 DeepSeekDocker 部署 AstrBot NapCat 打造 AI 智能机器人超详细教程前言每天打开QQ处理消息时我产生了一个想法既然大模型已经可以回答问题、整理内容和调用工具能不能把这些能力直接放进QQ而不是每次都单独打开一个AI网页真正动手之后会发现让QQ账号接收消息、调用大模型并自动回复并不是只安装一个机器人程序就能完成。这里至少需要三部分协作NapCat负责登录QQ并提供OneBot接口AstrBot负责消息处理、模型调用和插件逻辑DeepSeek则提供实际的大模型能力。把这三部分连接起来之后QQ就不再只是一个聊天窗口。它可以回答问题、切换不同人格、调用点歌插件还能通过MCP服务查询车次等外部信息。后续继续添加插件或工具还可以扩展出更多使用方式。本文将在Windows 11的Docker环境中部署AstrBot和NapCat完成QQ扫码登录、OneBot消息连接和DeepSeek API配置并继续测试人格设定、分段回复、插件市场和MCP服务。最后还会使用cpolar为AstrBot管理页面建立远程访问入口方便在其他网络环境中维护配置。正式操作前建议准备一个专门用于测试的QQ账号并妥善保存NapCat Token、AstrBot密码和大模型API Key。1 项目介绍1.1 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 是什么NapCat 是一个基于 NTQQQQ 官方 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的话可以到cpolar官网参考如下教程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部署可以依次执行如下命令即可官方命令mkdirastrbotcdastrbotwgethttps://raw.githubusercontent.com/NapNeko/NapCat-Docker/main/compose/astrbot.ymlsudodockercompose-fastrbot.yml up-d也可以执行如下Linux一键部署命令curl-fsSLhttps://gitee.com/jun-wan/script/raw/master/astrbot/deploy_astrbot.sh|bash控制台提示部署好后我们依次访问一下首先访问Astrbot(访问的IP请查看控制台输出的IP或者使用本地回环地址localhost也可以)http://localhost:6185可以发现成功的访问到啦接下来再试试访问NapCathttp://localhost:6099好啦都访问成功啦3 配置NapCat首先在浏览器中打开如下地址访问NapCat的web登录界面http://localhost:6099/页面上提示需要输入token进行登录我们回到控制台可以看到有一行输出了Token:如果控制台日志清了可以通过查看docker容器日志找到输入如下命令进行查看dockerlogs napcat|Select-StringToken将token复制下来填写web页面中即可进行登录接着登录上你想要作为机器人的QQ账号可以选择侧边的扫码登录登录完成后会自动跳转到首页4 配置AstrBot关联上NapCat4.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的按钮然后设置一个名称用于辨识创建完成后点击复制按钮进行复制注意只会显示一次不用刻意记忆忘记删除重新创建即可好了这样就获取到了deepseek的Api密钥了留着备用。5.2 将API密钥配置到AstrBot中首先在AstrBot的后台侧边栏点击模型提供商菜单然后点击页面上的新增模型提供商按钮在弹出的窗口中选择接入DeepSeek在配置页面中点击修改按钮将前面获取到DeepSeek的API密钥填入其中然后点击保存保存后即可看到新增的模型提供商了点击测试按钮可以测试是否可用5.3 简单对话测试是否可用使用另一个账号给前面扫码登录NapCat账号即机器人发送消息进行测试是否成功接入了AI可用看到成功的回复响应了我们的提问。6 更换人设和配置文件相关修改到这一步你的 QQ AI 机器人已经能正常工作了。从如下图中可用看到默认的回答很标准机器人一样这是因为AstrBot的默认人设给的提示词为你是一个乐于助人、友好的助手……我们可用创建一个新的人格设定首先打开AstrBot后台页面选择侧边栏的更多功能下的人格设定项然后在该页面点击创建人格在弹出的窗口中输入人格ID,和系统提示词即可这里提供一些收集到的人设自行获取即可人设全部为官方群获取群友上传非个人创建个别人设可能有点…你懂的123云盘永久链接https://www.123865.com/s/3jOKVv-GSNzH?pwd1314#提取码1314填写完成后点击保存即可即可在人格设定页面看到保存的人格创建好人格后我们可以在对话框中直接输入指令进行查看和切换输入如下指令,可以查看人格相关的指定/persona接着查看一下人格情景列表看看之前在后台创建的人格设定是否能够查询到/persona list可以看到成功的查询到了添加的人格设定接着切换一个测试一下/persona 猫娘(请替换为你创建好的人格ID名称)接着来发送消息测试一下可以看到人格生效了但是回复的内容太长了我们可以让它分段回复更加适合聊天的方式。回到后台页面点击配置文件下拉找到流式回复启用它不支持流式回复的会自动实时分段回复然后点击右下角的保存按钮即可接着再来发送测试一下可以看到现在就能够分段式的回复了。想要切换其他人设同样使用如下命令切换即可但是要注意上下文所以一定要执行/reset清空上下文# 切换人设/persona你要切换的人格设定ID名称# 清空上下文防止原人格对话影响现人格/reset再次测试一下新的人格设定是否生效可以看到成功的生效且分段回复啦到这儿人格设定创建和切换就搞定啦!7 AstrBot插件功能前面我们已经配置好了人设相关配置了接下来我们来添加一些插件让它支持更多功能。我们回到后台页面点击插件侧边菜单栏在插件市场中可以看到许多的插件这里安装一个插件测试一下以点歌插件为例在右上角搜索音乐找到点歌插件进行安装在弹出的窗口中可以选择使用GitHub加速然后测试一下连通性选择一个较低延迟的点击安装安装完成后弹出说明文档接着回到对话框发送指令测试一下/点歌 恋人你想要点歌的歌曲名字可以看到成功的推送了这首歌的歌曲卡片给我安装上了插件就拥有了更多的玩法啦8 AstrBot的MCP服务到这一步你的 QQ AI 机器人已经具备了基础对话能力和丰富的插件功能。但你可能会想**能不能让 AI 机器人更智能一点比如自动查天气、查车票、搜索资料、执行复杂任务**这就是MCPModel Context Protocol模型上下文协议要解决的问题。8.1 什么是 MCPMCP 是一个由 Anthropic 提出的开放协议它让 AI 模型能够通过标准化接口调用外部工具和服务。简单来说MCP 就像给 AI 装上了手和脚让它不再局限于纯文本对话而是能主动调用工具、获取实时信息、执行具体操作。而 AstrBot 正是支持 MCP 协议的机器人框架之一。通过配置 MCP 服务你的 QQ AI 机器人可以️实时查询天气、新闻、股票等信息联网搜索最新资料并总结回复️执行自定义工具比如数据库查询、API 调用等处理复杂任务让 AI 自主选择合适的工具组合完成目标接下来我们就来看看如何在 AstrBot 中启用和配置 MCP 服务让你的 QQ AI 机器人真正智能起来。8.2 安装Mpc服务回到AstrBot后台页面点击侧边菜单栏的MCP然后点击页面上的同步服务器按钮在弹出的窗口中点击蓝色字体ModelScope 平台,进行跳转即如下地址,以12306-mcp为例点击进入https://www.modelscope.cn/mcp进入后点击滚动到下方找到MCP服务器配置点击复制按钮进行复制{mcpServers:{12306-mcp:{command:npx,args:[-y,12306-mcp]}}}复制下来后回到astrbot后台页面点击新增服务器按钮然后在弹出的窗口中设置一个服务器名称服务器配置部分内容粘贴先前复制下来的mcp配置最后点击测试测试可用直接点击保存即可8.3 测试MCP服务接着我们直接回到聊天对话窗口询问一下我们之前配置好的AI机器人可以看到完整的告诉了我普通的快速列车和高铁动车的相关车票信息包含具体的列车号、出发时间、到达时间、座位及价格完美的将12306的MCP服务接入进来啦9 穿透AstrBot实现公网访问到这一步,你的 QQ AI 机器人已经跑得很完美了——能聊天、能切换人设、能调用插件、还支持 MCP 服务。但很快你就会发现一个问题人在外面想调整配置?不行,必须连家里的局域网。机器人突然不回复了? 机器人直接失联。这时候你会意识到,本地部署虽然简单,但只能本地用这个限制实在太致命。不过转折就在这里用 cpolar 做个内网穿透,几条命令搞定,你的 AstrBot 立刻拥有一个公网域名——这意味着你可以在地铁上用手机调机器人切换API key相关操作,可以把管理面板发给异地的朋友访问查看。接下来,我们就用 cpolar 打通这最后一公里。9.1 什么是cpolar?cpolar 是一款内网穿透工具可以将你在局域网内运行的服务如本地 Web 服务器、SSH、远程桌面等通过一条安全加密的中间隧道映射至公网让外部设备无需配置路由器即可访问。广泛支持Windows、macOS、Linux、树莓派、群晖 NAS等平台并提供一键安装脚本方便部署。9.2 下载cpolar打开cpolar官网的下载页面点击立即下载 64-bit按钮,下载cpoalr的安装包:下来下来是一个压缩包,解压后执行目录种的应用程序,一路默认安装即可,安装完成后,打开cmd窗口输入如下命令确认安装:cpolar version出现如上版本即代表安装成功!9.3 注册及登录cpolar web ui管理界面访问cpolar官网点击免费注册按钮进行账号注册进入到如下的注册页面进行账号注册注册完成后,在浏览器中输入如下地址访问 web ui管理界面:http://127.0.0.1:9200输入刚才注册好的cpolar账号登录即可进入后台页面:9.4 穿透AstrBot9.4.1 随机域名方式(免费方案)随机域名方式适合预算有限的用户。使用此方式时系统会每隔24 小时左右自动更换一次域名地址。对于长期访问的不太友好但是该方案是免费的如果您有一定的预算可以查看大纲9.4.2的固定域名方式且访问更稳定。点击左侧菜单栏的隧道管理展开进入隧道列表页面页面下默认会有 2 个隧道remoteDesktop隧道指向3389端口tcp协议website隧道指向8080端口http协议http协议默认会生成2个公网地址一个是http另一个https免去配置ssl证书的繁琐步骤点击编辑website的隧道修改成我们AstrBot需要的信息接着点击左侧菜单的状态菜单接着点击在线隧道列表菜单按钮可以看到有2个astrbot-6185的隧道一个为http协议,另一个为https协议:注意每个用户创建的隧道显示的公网地址都不一样接下来在浏览器中访问astrbot-6185隧道生成的公网地址http和https皆可这里以https为例可以看到成功访问啦!9.4.2 固定域名方式通过前面的配置我们已经成功实现了AstrBot的远程访问但免费随机域名方案的局限性也逐渐显现每24小时左右自动更换域名地址意味着你需要频繁更新书签、重新分享链接甚至可能因为忘记更新而无法访问。固定域名方案正是为了解决这些痛点而生能够让你拥有一个永久不变的专属地址。好啦接下来开始固定保留二级子域名教程首先进入官网的预留页面:https://dashboard.cpolar.com/reserved选择预留菜单即可看到保留二级子域名项填写其中的地区、名称、描述可不填项然后点击保留按钮操作步骤图如下列表中显示了一条已保留的二级子域名记录地区显示为China Top。二级域名显示为astrbot。注二级域名是唯一的每个账号都不相同请以自己设置的二级域名保留的为主接着进入侧边菜单栏的隧道管理下的隧道列表可以看到名为astrbot-6185的隧道点击编辑按钮进入编辑页面修改域名类型为二级子域名然后填写前面配置好的子域名点击更新按钮来到状态菜单下的在线隧道列表可以看到隧道名称为astrbot-6185的公网地址已经变更为二级子域名固定域名主体及后缀的形式了这里以https协议做访问测试加载稍慢需耐心等待一下:访问成功这样一来你就拥有了一个永久不变的专属域名再也不用担心24小时域名更换的问题。总结完成以上配置后AstrBot、NapCat和DeepSeek已经组成了一套完整的QQ AI机器人链路NapCat负责QQ消息的接收与发送AstrBot决定如何处理消息DeepSeek负责生成回复。基础对话跑通以后这套系统真正有意思的地方才开始出现。通过人格设定可以改变机器人的回答方式通过流式或分段回复可以让聊天节奏更接近普通QQ对话通过插件可以继续加入点歌等功能通过MCP还能让模型调用外部工具完成查询任务。这也意味着AstrBot并不只是给QQ增加一个自动回复功能而是把QQ变成了一个可以不断扩展的AI使用入口。后续可以根据自己的需求增加知识库、搜索、日程、家庭服务或其他工具但每增加一个插件或MCP服务也会增加新的权限和依赖。通过cpolar为6185端口建立公网隧道后可以在外部网络中打开AstrBot管理页面。固定二级子域名能够减少地址变化带来的麻烦但这个地址对应的是管理后台而不是普通展示页面。AstrBot后台中可能保存DeepSeek API Key、插件配置、MCP命令和机器人连接信息因此公网开放前必须修改默认密码限制地址分享范围也不建议把后台链接直接发给其他人体验。其他用户只需要通过QQ向机器人发送消息即可。NapCat Token、AstrBot账号和API Key也不应出现在公开截图或容器日志中。使用插件和MCP服务前应确认代码及软件包来源尤其是会自动下载并执行依赖的配置不要因为测试成功就忽略其权限范围。QQ机器人能否长期运行还会受到QQ登录状态、平台风控、Docker服务、网络环境和模型API余额等因素影响。更适合使用独立测试账号逐步验证不要一开始就将重要个人账号和大量群聊交给机器人处理。从一次简单的AI回复开始再逐步加入人格、插件和工具这套组合的价值不在于“一键拥有全能机器人”而在于你可以按照自己的实际需求一点点把QQ改造成更顺手的AI入口。