• 教程
  • 如何使用 NapCat 对接 adapter-onebot 使用教程

声明:教程必看

本文档(以下简称“本教程”)仅为学习和研究目的而提供,并遵循相关法律法规。任何个人或组织在使用本教程所提供的信息时,必须自行判断内容的合法性,且需对使用该内容承担全部责任,本教程作者或提供者不承担任何直接或间接责任。

特别声明

  1. 请勿在任何群讨论/传播本教程提到的任何内容,包括但不限于文字、图像及链接。
  2. 严禁传播本教程内容,以免引起不必要的法律风险和责任。
  3. 若在QQ群或其他社交平台讨论或传播本教程内容导致账号被封禁、踢出或任何形式的处罚,由此引起的后果将由用户自行承担。
  4. 本教程内容为作者根据当前法律环境和对相应技术的理解编写,旨在提高公众对相关技术的理解和认知,并不代表鼓励或支持任何非法活动。

提醒:

为保证本教程的可用性,
请不要在公开环境下传播教程里的任何内容。

对于因违反声明而导致的任何法律后果,
本教程提供者不承担任何责任。

最后,

用户在使用本教程前应确保其了解并同意以上条款,
如果不同意,
请立即停止使用本教程中的任何内容。

安装 NapCat V4.7.8

https://github.com/NapNeko/NapCatQQ/releases

NapCatQQ 是基于 PC NTQQ 本体实现一套无头 Bot 框架。
由于占用低,所以在服务器部署时优先考虑使用它。
NapCat 是用于 NTQQ 的插件框架,支持多种功能扩展。

  1. 下载 NapCat 压缩装包

这里我们使用github加速下载这个压缩包。
在链接前面加 https://ghfast.top/ 即可,这样在国内下载快一点。

https://ghfast.top/https://github.com/NapNeko/NapCatQQ/releases/download/v4.7.8/NapCat.Shell.zip

  1. 安装 NapCat

把下载的压缩包放到一个合适的目录,即可算是完成了 NapCat 的安装。


安装 QQNT 且目录不要带有空格

QQNT 是腾讯的NT架构 QQ 客户端,适合机器人框架的搭建。

  1. 下载 QQNT

根据 napcat 的release 内容

我们选择下载 Windows QQ 9.9.18.32793

https://dldir1.qq.com/qqfile/qq/QQNT/d43f097e/QQ9.9.18.32793_x64.exe

  1. 安装 QQNT
    • 注意不要使用默认目录!napcat目录不要带有空格
    • 运行安装程序。
    • 完成安装后退出运行 QQNT。

注意: 如果你此前安装过llqqnt等插件 请你确保QQ完全卸载干净后再安装对应版本使用napcat

配置 NapCat


  1. 结束QQ进程

将之前下载的napcat文件解压缩,并且打开napcat文件夹。

双击运行其中的

KillQQ.bat

以确保 结束了QQ进程

跳出黑框并且消失后,即代表此步骤完成

(可能就是闪一下黑框,一眨眼就好了,当然你也可以多运行几次)


  1. 启动 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

  1. 打开 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




  1. 打开浏览器,在地址栏输入
    http://127.0.0.1:6099/webui?token=napcat

默认的 token 内容为 napcat

  1. 初次登录 请点击 扫码登录 会打开二维码以供扫描登录

(快速登录请点击快速登录 会任你选择对应的QQ号)

初次登录:

快速登录:(非初次登录)


  1. 扫码登录 / 快速登录完成,展开完整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

查看机器人状态

绿灯即为连上了

2 个月 后

关于快速启动napcat

运行 launcher.bat 的时候,在webUI里选择 快速登录 即可交互!

上学 更改标题为「如何使用 napcat 对接 adapter-onebot 使用教程 - QQ 9.9.16
20 天 后
itzdrli 锁定此帖
13 天 后
上学 更改标题为「如何使用 NapCat 对接 adapter-onebot 使用教程 - QQ 9.9.16
2 个月 后

NapCat V4.4.2

2 个月 后

NapCat V4.7.8

上学 更改标题为「如何使用 NapCat 对接 adapter-onebot 使用教程