Harness 与 Agent 工程 · AI研发与测试工程 · 2025-11-25

5分钟部署AstrBot+NapCat:用Docker把 DeepSeekAI接入你的QQ

5分钟搞定!用Docker轻松将DeepSeekAI接入QQ,让AI帮你自动回复、管理群聊,解放双手。

核心内容:

  1. AstrBot与NapCat的强强联合:一站式解决QQ机器人搭建难题
  2. 详细部署指南:仅需一条docker-compose命令,5分钟完成配置
  3. 开箱即用的AI功能:支持DeepSeek等主流模型,丰富插件生态

前言

每天在 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 等各种聊天平台。

核心特点:

简单来说,AstrBot 就是一个"AI 机器人中枢",帮你把"AI 能力"和"聊天平台"连接起来,让你专注于功能本身,而不用操心底层实现。

1.2 NapCat 是什么?

仓库地址:https://github.com/NapNeko/NapCatQQ

NapCat 是一个基于 NTQQ(QQ 官方 Linux 版本)的 OneBot 协议实现框架,说人话就是:它能让你的 QQ 账号通过标准化接口被机器人程序调用。

在以前,大家常用的 go-cqhttp 已经停止维护,而 NapCat 作为新一代解决方案,具有以下优势:

核心特点:

为什么要用 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的按钮,然后设置一个名称(用于辨识),创建完成后点击复制按钮

— 以上为试看内容(约 40%),开通会员后阅读全文 —

原文出处:https://www.53ai.com/news/OpenSourceLLM/2025112581293.html