如何使用 NapCat.Framework.Windows.Once 对接 adapter-onebot 使用教程

上学

教程

上学

声明：教程必看

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

上学

特别声明

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

提醒：

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

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

最后，

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

上学

安装 NapCat.Framework V4.8.94

NapCat.Framework.Windows.Once是什么？
这是NapCat.Framework的一键启动包注意需要 34606+ 版本的QQ 你可以在不破坏QQ 不需要安装的情况下通过一键Boot.exe启动NapCat.Framework(仅限亲爱的Windows系统)

下载 NapCat 压缩装包
- 访问
  https://github.com/NapNeko/NapCatQQ/releases/download/v4.8.94/NapCat.Framework.Windows.Once.zip

安装 NapCat.Framework

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

上学

安装 QQNT

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

下载 QQNT

根据 napcat 的release 内容

我们选择下载 Windows QQ QQ9.9.19.34740_x64.exe

https://dldir1.qq.com/qqfile/qq/QQNT/f31348f2/QQ9.9.19.34740_x64.exe

如果提示WinX64缺少运行库或者xxx.dll？请下载安装：
https://aka.ms/vs/17/release/vc_redist.x64.exe

安装 QQNT
- 运行安装程序。
- 建议选择非默认安装目录，避免路径中包含中文或空格。
- 完成安装后退出运行 QQNT。

上学

退出QQ进程

双击运行 NapCat.Framework.Windows.Once 文件夹里的

KillQQ.bat

见到黑框一闪而过即可

启动 NapCat.Framework.Windows.Once

双击运行 NapCat 文件夹里的 NapCatWinBootMain.exe

然后登录机器人QQ

登录上机器人QQ后，打开QQ的设置页面，打开 NapCat 配置页面

打开了配置页面后，我们需要在浏览器里打开此地址，并且添加网络配置

默认token内容为

napcat

具体添加内容请见下方：

上学

配置连接方式与地址

配置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不在监听此路径请自行修改