如何使用 NapCat 对接 adapter-onebot 使用教程
napcat教程
声明:教程必看
本文档(以下简称“本教程”)仅为学习和研究目的而提供,并遵循相关法律法规。任何个人或组织在使用本教程所提供的信息时,必须自行判断内容的合法性,且需对使用该内容承担全部责任,本教程作者或提供者不承担任何直接或间接责任。
特别声明
- 请勿在任何群讨论/传播本教程提到的任何内容,包括但不限于文字、图像及链接。
- 严禁传播本教程内容,以免引起不必要的法律风险和责任。
- 若在QQ群或其他社交平台讨论或传播本教程内容导致账号被封禁、踢出或任何形式的处罚,由此引起的后果将由用户自行承担。
- 本教程内容为作者根据当前法律环境和对相应技术的理解编写,旨在提高公众对相关技术的理解和认知,并不代表鼓励或支持任何非法活动。
提醒:
为保证本教程的可用性,
请不要在公开环境下传播教程里的任何内容。
对于因违反声明而导致的任何法律后果,
本教程提供者不承担任何责任。
最后,
用户在使用本教程前应确保其了解并同意以上条款,
如果不同意,
请立即停止使用本教程中的任何内容。
- 已编辑
安装 NapCat V4.7.8
https://github.com/NapNeko/NapCatQQ/releases
NapCatQQ 是基于 PC NTQQ 本体实现一套无头 Bot 框架。
由于占用低,所以在服务器部署时优先考虑使用它。
NapCat 是用于 NTQQ 的插件框架,支持多种功能扩展。
这里我们使用github加速下载这个压缩包。
在链接前面加 https://ghfast.top/
即可,这样在国内下载快一点。
https://ghfast.top/https://github.com/NapNeko/NapCatQQ/releases/download/v4.7.8/NapCat.Shell.zip
- 安装 NapCat
把下载的压缩包放到一个合适的目录,即可算是完成了 NapCat 的安装。
- 已编辑
安装 QQNT 且目录不要带有空格
QQNT 是腾讯的NT架构 QQ 客户端,适合机器人框架的搭建。
- 下载 QQNT
我们选择下载 Windows QQ 9.9.18.32793
https://dldir1.qq.com/qqfile/qq/QQNT/d43f097e/QQ9.9.18.32793_x64.exe
- 安装 QQNT
- 注意不要使用默认目录!napcat目录不要带有空格
- 运行安装程序。
- 完成安装后退出运行 QQNT。
注意: 如果你此前安装过llqqnt等插件 请你确保QQ完全卸载干净后再安装对应版本使用napcat
- 已编辑
配置 NapCat
- 结束QQ进程
将之前下载的napcat文件解压缩,并且打开napcat文件夹。
双击运行其中的
KillQQ.bat
以确保 结束了QQ进程
跳出黑框并且消失后,即代表此步骤完成
(可能就是闪一下黑框,一眨眼就好了,当然你也可以多运行几次)
- 启动 launcher.bat
安装完成 双击目录下 launcher.bat 即可启动。
如果是win10 则使用 launcher-win10.bat
选择 是
然后就会自动运行napcat了
控制台终端输出内容应该是这样的
Active code page: 65001
Administrator mode detected.
argv[0]:C:\Users\shangxue\Downloads\NapCat.Shell\NapCatWinBootMain.exe
argv[1]:C:\QQBOTS\ntqq\QQ.exe
argv[2]:C:\Users\shangxue\Downloads\NapCat.Shell\NapCatWinBootHook.dll
Boot Command:"C:\QQBOTS\ntqq\QQ.exe" --enable-logging
[NapCat Backend] Main Process ID:9984
NapCat Shell App Loading...
03-22 15:21:29 [[32minfo[39m] [NapCat] [Core] NapCat.Core Version: 4.7.8
03-22 15:21:30 [[32minfo[39m] [NapCat] [WebUi] WebUi Local Panel Url: http://127.0.0.1:6099/webui?token=napcat
03-22 15:21:30 [[32minfo[39m] 等待网络连接...
03-22 15:21:30 [[32minfo[39m] 网络已连接
03-22 15:21:30 [[32minfo[39m] 没有 -q 指令指定快速登录,将使用二维码登录方式
03-22 15:21:30 [[32minfo[39m] 可用于快速登录的 QQ:
1. 9999999 猫猫
03-22 15:21:32 [[33mwarn[39m] 请扫描下面的二维码,然后在手Q上授权登录:
03-22 15:21:32 [[33mwarn[39m]
▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
█ ▄▄▄▄▄ █▀▀ ██▀▀ ▄ █▄▄█ ▀▀█ ▄▄▄▄▄ █
▄▄▄▄▄▄▄█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
▄▄▄▄▄▄▄█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
▄▄▄▄▄▄▄█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
▄▄▄▄▄▄▄█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
▄▄▄▄▄▄▄█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
▄▄▄▄▄▄▄█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
▄▄▄▄▄▄▄█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
▄▄▄▄▄▄▄█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
▄▄▄▄▄▄▄█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
█ █▄▄▄█ █▀██▀ █▄▀█▀ ▀ ▀▀▄▀▄█▀▄█▄▄▄█
█▄▄▄▄▄▄▄█▄█▄▄█▄████▄████▄▄██████▄██
二维码解码URL: https://txz.qq.com/p?k=Xp-IBeZxxxxxxxxxxxxxxxxxxxxSgylI5ODJ&f=1600001604
如果控制台二维码无法扫码,可以复制解码url到二维码生成网站生成二维码再扫码,也可以打开下方的二维码路径图片进行扫码。
03-22 15:21:32 [[33mwarn[39m] 二维码已保存到 C:\Users\shangxue\Downloads\NapCat.Shell\cache\qrcode.png
- 打开 web UI
找到控制台其中的输出内容
03-22 15:21:30 [[32minfo[39m] [NapCat] [WebUi] WebUi Local Panel Url: http://127.0.0.1:6099/webui?token=napcat
可以看到 webUI 有面板地址: http://127.0.0.1:6099/webui?token=napcat
- 打开浏览器,在地址栏输入
http://127.0.0.1:6099/webui?token=napcat
默认的 token 内容为 napcat
- 初次登录 请点击
扫码登录
会打开二维码以供扫描登录
(快速登录请点击快速登录
会任你选择对应的QQ号)
初次登录:
快速登录:(非初次登录)
- 扫码登录 / 快速登录完成,展开完整webUI
看到类似的webUI即代表此步骤完成!
- 已编辑
配置web UI
在机器人登录成功后,
如上图文,展开了完整的webUI内容
接着我们配置对应的网络服务
配置napcat
ws连接的配置共有两种方法,你选一个适合你的即可:
(无所谓的话,选正向ws方便后续多开koishi等后端)
正向ws:
反向ws:
- 已编辑
正向ws
默认内容 无需任何修改,默认即可点击 确认
按钮
这里演示就不做修改了。
应用此配置
如上文点击了【确定】按钮之后
就会回到【网络配置】页面
然后我们启动 koishi
并且需要确保 koishi 组件为最新版 以防止依赖出问题
安装 adapter-onebot
配置 onebot 插件
填写对应的内容,请按照图片内容填写,依次为:
self填入你的机器人QQ号
协议选择:ws
地址填入: ws://127.0.0.1:3001
查看机器人状态
绿灯即为连上了
- 已编辑
反向ws
在 napcat 的 web UI 处选择 websocket 客户端
并且点击右下角【确定】按钮
配置 反向ws 地址
填入koishi的ws地址
ws://localhost:5140/onebot
注意其中
5140
为koishi的默认端口,如果你的koishi不在此端口 请自行修改注意其中
/onebot
为koishi的默认端口,如果你的adapter-onebot不在监听此路径 请自行修改
然后我们启动 koishi
并且需要确保 koishi 组件为最新版 以防止依赖出问题
安装 adapter-onebot
配置 onebot 插件
填写对应的内容,请按照图片内容填写,依次为:
self填入你的机器人QQ号
协议选择:ws-reverse
查看机器人状态
绿灯即为连上了
- 已编辑
关于快速启动napcat
运行 launcher.bat
的时候,在webUI里选择 快速登录
即可交互!
更新 9.9.16
V4.1.15
NapCat V4.4.2
NapCat V4.7.8