吾爱破解 - 52pojie.cn

 找回密码
 注册[Register]

QQ登录

只需一步,快速开始

查看: 5135|回复: 18
收起左侧

[Python 原创] 基于NapCatQQ和Python的QQ机器人开发——连接NapCatQQ和W1ndysBot

[复制链接]
Windys629 发表于 2025-3-5 14:04
本帖最后由 Windys629 于 2025-3-5 16:23 编辑

博客 https://blog.w1ndys.top/posts/cdcbc710.html
Github源码 https://github.com/W1ndysBot/W1ndysBot

部署 NapCatQQ

Windows 安装

{% note info %}
下面是无头非绿色版本,你也可以选择 NapCatQQ 的无头绿色版本,内置 QQ,不需要下载 QQ 本体,直接下载框架即可。由于绿色版开袋即用,启动就是登录,与非绿色版唯一的区别就是启动文件名字不同,绿色版的启动文件名字是 napcat.bat,非绿色版的启动文件名字是 launcher***.bat,这里不详细介绍。
{% endnote %}

下载 QQ 本体

直接去 QQ 官网下载 QQ 本体,必须是 NT 的新版 QQ

下载地址 QQ-轻松做自己

安装框架

去 NapCatQQ 的 release 页下载 框架下载地址

下载之后解压看到下面一些文件

image-20250125121852680

根据你的电脑系统选择启动脚本

  1. 确保 QQ 版本安装且最新
  2. 双击目录下 launcher.bat 即可启动 如果是 win10 则使用 launcher-win10.bat
登录

运行上面所属文件之后,你将看到如下界面,你有两种方法进行登录,推荐第一种

image-20250125122103940

如果你使用的绿色版本,则启动就会直接到这一步

登录方法一

上方红框里有两个链接,复制到浏览器里

点击扫码登录

image-20250125122134955

手机 QQ 进行扫码登录

登录成功后将会进入首页

登录方法二

直接扫描控制台里的二维码(但由于不同电脑字符不一样,有的电脑显示的二维码可能不能扫,在上方图片下面的红框里,有一个地址和一个路径,把地址转换为二维码扫描或直接打开路径的二维码文件都可以获取到可以扫的二维码)

这种方法也可以登录,但由于后续步骤还需要打开方法一的链接,所以不推荐这种登录方法

配置协议连接

在上面的网页里登录成功后将看到下面内容

image-20250125122445991

点击左侧网络配置-新建-websocket 服务器,按照下面进行配置

开关打开,名称随便写(不能空着),port 改成 3001,心跳间隔改成 60000,其他设置默认即可,确认

image-20250125122539046

开启之后可以看到类似下面内容

01-25 13:02:25 [info] 卷卷测试服 | [Notice] [OneBot11] 配置变更后:
[network] 配置加载
WebSocket 服务: 0.0.0.0:3001, : 已启动

docker 安装

我是比较喜欢 docker 的,因为我平时用都会在 linux 服务器上运行,docker 会更方便一些

docker 部署命令,W1ndysBot 有大量的我写好的 docker 运行脚本,可以直接参考着使用

W1ndysBot/linux_run_napcat_docker.sh at main · W1ndysBot/W1ndysBot

还有更新镜像的 shell 脚本:W1ndysBot/linux_update_napcat.sh at main · W1ndysBot/W1ndysBot

# 启动 Docker 容器
docker run -d \
  --rm \
  --network host \
  -e NAPCAT_GID=$NAPCAT_GID \
  -e NAPCAT_UID=$NAPCAT_UID \
  -p 3000:3000 \
  -p 3001:3001 \
  -p 6099:6099 \
  --name napcat \
  --restart=always \
  -v ./napcat/app/.config/QQ:/app/.config/QQ \
  -v ./napcat/app/napcat:/app/napcat \
  mlikiowa/napcat-docker

拉完镜像剩下的就跟前面步骤一模一样了

其他的我就不多说了,你都会用 docker 了,其他还有什么错误是解决不了的

部署处理程序

W1ndysBot 开源地址 W1ndysBot/W1ndysBot: 基于 NapCatQQ 和 Python 的 QQ 机器人实现

解压程序到本地

解压之后看到下面文件

image-20250125130459638

这里部署好了虚拟环境,可以直接运行,如果你有 Python 基础,也可以自己改环境运行,但不推荐

运行程序

已经写好了批处理脚本

双击 run_app.bat 即可运行

连接成功后即可看到如下界面

image-20250125130820179

看到这里说明已经部署好环境,下面开始修改配置

配置数据

进入目录,找到配置文件 app/config.py

可以用专用的编辑器打开,也可以用记事本打开

注意!!!配置好之后,需要重启程序,否则配置不会生效

# config.py

owner_id = ["<your_owner_id>"]  # 机器人 root 管理员 QQ 号,可以多个,多个用逗号分隔,例如:owner_id = ["123456", "123457"],注意!!!这个是 QQ 号不是机器人的QQ号,是你控制机器人用的大号

report_group_id = "<your_report_group_id>"  # 上报群

# ws_url = "ws://127.0.0.1:8081"  # 本地环境的 WebSocket API 地址

ws_url = "ws://127.0.0.1:3001"  # 本地环境的 WebSocket API 地址

token = None  # 如果需要认证,请填写认证 token

修改上面配置,下面是一个修改好的例子

# config.py

owner_id = ["123456"]  # 机器人root管理员 QQ 号

report_group_id = "123456"  # 上报群

# ws_url = "ws://127.0.0.1:8081"  # 本地环境的 WebSocket API 地址

ws_url = "ws://127.0.0.1:3001"  # 本地环境的 WebSocket API 地址

token = None  # 如果需要认证,请填写认证 token

owner_id 是机器人 root 管理员 QQ 号

report_group_id 是上报群

ws_url 是 WebSocket API 地址

token 是认证 token

后面两个配置取决于前面的配置,一般不需要改

免费评分

参与人数 2威望 +1 吾爱币 +11 热心值 +2 收起 理由
宅友 + 1 + 1 谢谢@Thanks!
苏紫方璇 + 1 + 10 + 1 欢迎分析讨论交流,吾爱破解论坛有你更精彩!

查看全部评分

发帖前要善用论坛搜索功能,那里可能会有你要找的答案或者已经有人发布过相同内容了,请勿重复发帖。

 楼主| Windys629 发表于 2025-3-5 16:19
fanye666ya 发表于 2025-3-5 15:40
可以自己写插件吗

可以的,只要连接websocket或者http通信就可以,帖子里是NapCatQQ框架,目前我是用的我借助ai自己搓了一个插件框架,可能有些不完善或者不强大,目前生态强大的插件框架有很多,nonebot、koishi等的都很好用
 楼主| Windys629 发表于 2025-3-5 16:20
cyxnzb 发表于 2025-3-5 14:59
很棒,现在好像QQ针对这块抓得很严,早前用的一些好多都挂了

哎,是这样的,最近QQ又开始大批量封第三方QQ了,又是一段严查期,早起的基于协议的框架也都死了,现在qqnt的比较多。像拉格朗,llonebot,还有帖子里的NapCatQQ
asuka52 发表于 2026-3-18 15:01
我想实现对于qq群聊信息的抓取,并使用ai自动分析,总结,定位,回答,不知道能否满足需求捏,试试看
lainzy 发表于 2025-11-12 14:12
主要是没看懂这个项目可以做到哪些内容。
 楼主| Windys629 发表于 2025-10-17 09:23
huajianyou01 发表于 2025-4-28 09:26
求问安卓怎么部署啊,总是安装失败

我是用的linux-docker。安卓不太放方便
huajianyou01 发表于 2025-4-28 09:26
求问安卓怎么部署啊,总是安装失败
CloudPluie 发表于 2025-3-10 11:21
还要登一个QQ客户端么
cyxnzb 发表于 2025-3-6 13:24
Windys629 发表于 2025-3-5 16:20
哎,是这样的,最近QQ又开始大批量封第三方QQ了,又是一段严查期,早起的基于协议的框架也都死了,现在qq ...

看登录形式还是差不多的,不过确实风险比较大,以前酷Q在的时候还是挺好玩的,好多功能,现在搭了不知道干嘛
haoweidiao 发表于 2025-3-5 19:22
厉害啊,谢谢辛苦了
MHao008 发表于 2025-3-5 17:47
还可以,封号严重吗? 好像目前就微信的机器人不好弄
如梦SSS 发表于 2025-3-5 16:54
我的QQ小号昨天登录QQ全都冻结了,最近不敢用第三方的软件
xoyi 发表于 2025-3-5 16:40
容易被扫号,哎,挺烦人的
您需要登录后才可以回帖 登录 | 注册[Register]

本版积分规则

返回列表

RSS订阅|小黑屋|处罚记录|联系我们|吾爱破解 - 52pojie.cn ( 京ICP备16042023号 | 京公网安备 11010502030087号 )

GMT+8, 2026-5-29 01:04

Powered by Discuz!

Copyright © 2001-2020, Tencent Cloud.

快速回复 返回顶部 返回列表