[koishi教程]如何使用 Liteloader onebot 对接 onebot/satori 使用教程

上学

LLOnebot教程

上学

声明：教程必看

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

上学

特别声明

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

上学

提醒：

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

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

最后，

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

上学

教程

本篇教程将带您使用 koishi 的 adapter-onebot 插件，完成在 Windows 平台上，基于 LiteloaderQQNT 的插件完成 bot 部署。

步骤

检查QQ版本

请先检查QQ版本是否为QQ 9.9.15 及以上。

安装QQNT（推荐大于 9.9.15 及以上）

请前往下载对应版本的NTQQ
不推荐使用默认安装目录
不推荐安装目录存在中文或空格
如果有版本不一致而出现的问题，请使用教程示例版本的QQ

QQNT安装
安装QQNT（不低于9.9.15）
这里我们的演示QQ版本为 9.9.16.29927
下载链接：https://dldir1.qq.com/qqfile/qq/QQNT/3e273e30/QQ9.9.16.29927_x64.exe
如果有版本不一致而出现的问题，请使用教程示例版本的QQ

安装完成后退出QQ

LLOnebot安装教程：

安装LLQQNT及其插件
在第一步安装QQNT后，先退出QQ，确保QQ没有在后台运行。
前往下载LLQQNT及其插件：

下载LLQQNT v1.2.3
releases发布页
- 我们使用https://ghfast.top/来加速访问github资源：https://ghfast.top/https://github.com/LiteLoaderQQNT/LiteLoaderQQNT/releases/download/1.2.3/LiteLoaderQQNT.zip
下载LLOnebot v4.8.0
releases发布页
- 我们使用https://ghfast.top/来加速访问github资源：https://ghfast.top/https://github.com/LLOneBot/LLOneBot/releases/download/v4.8.0/LLOneBot.zip
下载DllHijack_1.1.2
releases发布页
- 我们使用https://ghfast.top/来加速访问github资源：https://ghfast.top/https://github.com/LiteLoaderQQNT/QQNTFileVerifyPatch/releases/download/DllHijack_1.1.2/dbghelp_x64.dll

将上述下载的全部文件解压

上学

配置QQNT插件

打开QQ.exe所在文件夹

将下载的 dbghelp_x64.dll 重命名为 dbghelp.dll，然后放到QQ.exe同文件夹下

修改文件手动安装

打开qq.exe所在文件夹，
找到 app 文件夹的路径

在 .\versions\9.9.16-29927\resources\app\app_launcher目录中，
创建一个llob.js文件（可以复制 index.js 然后重命名）

然后编辑这个新建的文件：

写入

require(String.raw`./LiteLoaderQQNT`)

保存文件（按Ctrl + S）

复制之前解压的 LiteLoaderQQNT 文件夹

将解压后的liteloader文件夹放到versions\9.9.16-29927\resources\app\app_launcher

并且在liteloader文件夹里新建一个plugins文件夹，将llonebot文件夹放到此处（注意文件夹名称不要打错）

修改package.json

versions\9.9.16-29927\resources\app下的package.json 文件，
将 main 字段改为：

  "main": "./app_launcher/llob.js",

上学

配置LLOnebot

运行QQ.exe
打开QQ的设置

使用adapter-onebot（satori方法见最下面）

配置共有两种方法：（任选一种即可，也可以一起用，这里推荐正向ws）

正向ws

开启正向ws开关
使用默认端口 3001
点击【保存】按钮
配置图如下：

然后我们启动 koishi

并且需要确保 koishi 组件为最新版以防止依赖出问题

安装 adapter-onebot

配置 onebot 插件

填写对应的内容，请按照图片内容填写，依次为：

self填入你的机器人QQ号
协议选择：ws
地址填入： ws://127.0.0.1:3001

查看机器人状态

绿灯即为连上了

上学

反向ws 配置方法

反向ws

找到LLOnebot的【添加反向Websocket地址】蓝色按钮
如图添加内容 ws://127.0.0.1:5140/onebot

你可以修改ws端口为一个整数（应与koishi运行端口相对应）
点击【保存】按钮
配置图如下：

然后我们启动 koishi

并且需要确保 koishi 组件为最新版以防止依赖出问题

安装 adapter-onebot

配置 onebot 插件

填写对应的内容，请按照图片内容填写，依次为：

self填入你的机器人QQ号
协议选择：ws-reverse

查看机器人状态

绿灯即为连上了

上学

对接 adapter-satori

在qq设置里确保llob的对应开关已经打开

然后我们需要启动 koishi

找到 adapter-satori

我们需要填入默认的API终结点

http://127.0.0.1:5600/

然后开启插件

上学

常见问题解决方法

如果你在尝试以上的步骤时，遇到了问题，欢迎随时加入我们的非官方群聊~

QQ群号：590104798

在询问我们之前，或许可以在这里解决：

常见问题

1. QQ.exe启动报错，什么什么js报错

解决方法
检查第一步的index.js是否修改正确。

2. 打不开NTQQ，报错****dll，是系统缺少常用的运行库

解决方法
请尝试安装VC运行库之类的程序后运行。
VC运行库下载链接

3. 重复运行了QQNTPatcher_x96.exe，修复QQ.exe，结果QQ.exe不见了

解决方法
QQ安装目录下，QQ.exe变成了QQ.exe.bak
把QQ.exe.bak改为QQ.exe，然后运行这个QQ.exe。

4. adapter-onebot怎么不弹出二维码扫码啊，想要以前的那种onebot

解决方法
回退至4.13.9及以前的koishi实例版本吧，那时候还是默认gocqhttp的onebot。

*如果这些方法不能有效解决问题，或你的情况不在上述内容里，请向他人寻求帮助！

上学

最后编辑于10.16

bilibili-mkhr

恋恋无论是更新还是装插件都失败了怎么整呜呜

上学

bilibili-mkhr 恋恋无论是更新还是装插件都失败了怎么整呜呜

看日志倾向于koishi依赖问题

bilibili-mkhr

bilibili-mkhr 此问题起因恋恋的路径有中文
已解决

上学

更新 LLOneBot v4.4.1

上学

LLOneBot v4.7.0