如何使用 NapCat 对接 adapter-onebot 使用教程
napcat教程
声明：教程必看
本文档（以下简称“本教程”）仅为学习和研究目的而提供，并遵循相关法律法规。任何个人或组织在使用本教程所提供的信息时，必须自行判断内容的合法性，且需对使用该内容承担全部责任，本教程作者或提供者不承担任何直接或间接责任。
特别声明
- 请勿在任何群讨论/传播本教程提到的任何内容，包括但不限于文字、图像及链接。
- 严禁传播本教程内容，以免引起不必要的法律风险和责任。
- 若在QQ群或其他社交平台讨论或传播本教程内容导致账号被封禁、踢出或任何形式的处罚，由此引起的后果将由用户自行承担。
- 本教程内容为作者根据当前法律环境和对相应技术的理解编写，旨在提高公众对相关技术的理解和认知，并不代表鼓励或支持任何非法活动。
提醒：
为保证本教程的可用性，
请不要在公开环境下传播教程里的任何内容。
对于因违反声明而导致的任何法律后果，
本教程提供者不承担任何责任。
最后，
用户在使用本教程前应确保其了解并同意以上条款，
如果不同意，
请立即停止使用本教程中的任何内容。
- 已编辑
安装 NapCat V4.8.94
https://github.com/NapNeko/NapCatQQ/releasesNapCatQQ 是基于 PC NTQQ 本体实现一套无头 Bot 框架。
由于占用低，所以在服务器部署时优先考虑使用它。
NapCat 是用于 NTQQ 的插件框架，支持多种功能扩展。
- 安装 NapCat
把下载的压缩包放到一个合适的目录，即可算是完成了 NapCat 的安装。
- 已编辑
安装 QQNT 且目录不要带有空格
QQNT 是腾讯的NT架构 QQ 客户端，适合机器人框架的搭建。
- 下载 QQNT
我们选择下载 Windows QQ QQ9.9.19.34740_x64
https://dldir1.qq.com/qqfile/qq/QQNT/f31348f2/QQ9.9.19.34740_x64.exe
- 安装 QQNT
- 注意不要使用默认目录！napcat目录不要带有空格
- 运行安装程序。
- 完成安装后退出运行 QQNT。
注意： 如果你此前安装过llqqnt等插件 请你确保QQ完全卸载干净后再安装对应版本使用napcat
需要打开QQ所在文件夹，并且清空那个文件夹的所有内容
- 已编辑
配置 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