教程
[koishi教程]如何使用 Lagrange 对接 adapter-onebot 使用教程
声明:教程必看
本文档(以下简称“本教程”)仅为学习和研究目的而提供,并遵循相关法律法规。任何个人或组织在使用本教程所提供的信息时,必须自行判断内容的合法性,且需对使用该内容承担全部责任,本教程作者或提供者不承担任何直接或间接责任。
特别声明
- 请勿在任何群讨论/传播本教程提到的任何内容,包括但不限于文字、图像及链接。
- 严禁传播本教程内容,以免引起不必要的法律风险和责任。
- 若在QQ群或其他社交平台讨论或传播本教程内容导致账号被封禁、踢出或任何形式的处罚,由此引起的后果将由用户自行承担。
- 本教程内容为作者根据当前法律环境和对相应技术的理解编写,旨在提高公众对相关技术的理解和认知,并不代表鼓励或支持任何非法活动。
提醒:
为保证本教程的可用性,
请不要在公开环境下传播教程里的任何内容。
对于因违反声明而导致的任何法律后果,
本教程提供者不承担任何责任。
最后,
用户在使用本教程前应确保其了解并同意以上条款,
如果不同意,
请立即停止使用本教程中的任何内容。
- 已编辑
您也可以选择根据 Lagrange 官方文档来部署
https://lagrangedev.github.io/Lagrange.Doc/Lagrange.OneBot/Config/
Lagrange 教程
1. 下载安装 Lagrange
https://github.com/LagrangeDev/Lagrange.Core/releases
我们选择下载 LagrangeOneBot_win-x64_net9.0_SelfContained.zip
使用下载链接
下载该文件夹后,解压文件,一直往下找到文件 Lagrange.OneBot.exe
双击运行 Lagrange.OneBot.exe
然后就会在此目录下生成一些配置文件
- 已编辑
接下来,我们打开exe生成的,同文件夹下的 appsettings.json
文件,默认的配置内容如下:
{
"$schema": "https://raw.githubusercontent.com/LagrangeDev/Lagrange.Core/master/Lagrange.OneBot/Resources/appsettings_schema.json",
"Logging": {
"LogLevel": {
"Default": "Information",
"Microsoft": "Warning",
"Microsoft.Hosting.Lifetime": "Information"
}
},
"SignServerUrl": "",
"SignProxyUrl": "",
"MusicSignServerUrl": "",
"Account": {
"Uin": 0,
"Protocol": "Linux",
"AutoReconnect": true,
"GetOptimumServer": true
},
"Message": {
"IgnoreSelf": true,
"StringPost": false
},
"QrCode": {
"ConsoleCompatibilityMode": false
},
"Implementations": [
{
"Type": "ReverseWebSocket",
"Host": "127.0.0.1",
"Port": 8080,
"Suffix": "/onebot/v11/ws",
"ReconnectInterval": 5000,
"HeartBeatInterval": 5000,
"AccessToken": ""
}
]
}
我们需要修改其中的关于签名地址、连接配置部分的内容。
其他内容默认即可。
填入签名地址
"SignServerUrl": "https://sign.lagrangecore.org/api/sign/30366",
下方 反向ws
和 正向ws
方法分选其一即可
反向ws
koishi
的 反向ws
配置下,默认配置项为
运行在 127.0.0.1:5140
,且监听路径默认为 /onebot
。
- 所以我们需要修改为:
其余内容不变,仅修改"Implementations": [ { "Type": "ReverseWebSocket", "Host": "127.0.0.1", "Port": 5140, "Suffix": "/onebot", "ReconnectInterval": 5000, "HeartBeatInterval": 5000, "AccessToken": "" } ]
Port
和Suffix
即可。
正向ws
- 我们需要修改为:
其余内容不变,仅修改"Implementations": [ { "Type": "ForwardWebSocket", "Host": "127.0.0.1", "Port": 3001, "HeartBeatInterval": 5000, "HeartBeatEnable": true, "AccessToken": "" } ]
Port
即可。
保存该文件。然后重新运行exe。
重新运行exe后
稍等片刻,即会出现二维码。
你可以在exe同文件夹下找到 qr-0.png
。双击 qr-0.png
打开查看二维码,使用机器人QQ号扫码登录。
扫码直接就登录成功了哦~
- 已编辑
配置adapter-onebot插件
根据你选的ws类型,选择对应的配置方法
反向ws
修改onebot插件的配置项:
- selfId填写
- 您需要查看此时登录的QQNT的QQ账号
- 填入登陆NTQQ的机器人QQ号即可(注意不要多空格【 114514】X 【114514】√)
- protocol选择
反向ws
配置图如下:
正向ws
- selfId填写
- 您需要查看此时登录的QQNT的QQ账号
- 填入登陆NTQQ的机器人QQ号即可(注意不要多空格【 114514】X 【114514】√)
- protocol选择
正向ws
配置图如下:
最后
开启adapter-onebot插件,即可绿灯啦!
- 已编辑
有关从 actions 中 获取最新版本的方法
前往github地址的actions页面
-> https://github.com/LagrangeDev/Lagrange.Core/actions
- 找绿色勾勾
- 从最新的往下找 Artifacts 产物
这样的就是没有 Artifacts :
这样的就是有 Artifacts :
- 下载对应版本
在 有 Artifacts 的 actions 里面往下翻 选择对应的版本下载
- 已编辑
常见问题
1
如果你出现了一些问题,比如关键词:
[BusinessContext][WARNING]: Not enough data to read, remaining: 11 required: 65547
具体见 https://github.com/LagrangeDev/Lagrange.Core/issues/412
2
Microsoft Windows [版本 10.0.19045.4717]
(c) Microsoft Corporation。保留所有权利。
E:\download\NeatDownload>Lagrange.OneBot.exe
You must install or update .NET to run this application.
App: E:\download\NeatDownload\Lagrange.OneBot.exe
Architecture: x64
Framework: 'Microsoft.NETCore.App', version '9.0.0' (x64)
.NET location: C:\Program Files\dotnet\
The following frameworks were found:
6.0.33 at [C:\Program Files\dotnet\shared\Microsoft.NETCore.App]
8.0.2 at [C:\Program Files\dotnet\shared\Microsoft.NETCore.App]
Learn more:
https://aka.ms/dotnet/app-launch-failed
To install missing framework, download:
https://aka.ms/dotnet-core-applaunch?framework=Microsoft.NETCore.App&framework_version=9.0.0&arch=x64&rid=win-x64&os=win10
E:\download\NeatDownload>
下载并安装 .NET 9.0.0 运行时:
- 打开错误信息中提供的链接:https://aka.ms/dotnet-core-applaunch?framework=Microsoft.NETCore.App&framework_version=9.0.0&arch=x64&rid=win-x64&os=win10
- 这将引导你到 .NET 9.0.0 运行时的下载页面。
- 下载适用于 Windows x64 的 .NET 9.0.0 运行时安装程序。
运行安装程序:
- 下载完成后,双击安装程序并按照提示完成安装。
重新运行
Lagrange.OneBot.exe
:- 安装完成后,重新运行
Lagrange.OneBot.exe
,应该可以正常启动了。
- 安装完成后,重新运行
awa
- 已编辑
有关添加多个网络配置
默认配置文件中的网络配置部分
内容为
"Implementations": [
{
"Type": "ReverseWebSocket",
"Host": "127.0.0.1",
"Port": 8080,
"Suffix": "/onebot/v11/ws",
"ReconnectInterval": 5000,
"HeartBeatInterval": 5000,
"AccessToken": ""
}
]
这是一个数组配置项
我们需要添加多个字段内容,即可实现添加多个网络配置
例如:
示例一
一个正向ws + 一个反向ws
"Implementations": [ { "Type": "ForwardWebSocket", "Host": "127.0.0.1", "Port": 3001, "HeartBeatInterval": 5000, "HeartBeatEnable": true, "AccessToken": "" }, { "Type": "ReverseWebSocket", "Host": "127.0.0.1", "Port": 2536, "Suffix": "/OneBotv11", "ReconnectInterval": 5000, "HeartBeatInterval": 5000, "AccessToken": "" } ]
示例二
两个反向ws
"Implementations": [
{
"Type": "ReverseWebSocket",
"Host": "127.0.0.1",
"Port": 5140,
"Suffix": "/onebot",
"ReconnectInterval": 5000,
"HeartBeatInterval": 5000,
"AccessToken": ""
},
{
"Type": "ReverseWebSocket",
"Host": "127.0.0.1",
"Port": 2536,
"Suffix": "/OneBotv11",
"ReconnectInterval": 5000,
"HeartBeatInterval": 5000,
"AccessToken": ""
}
]
示例三
两个正向ws
"Implementations": [
{
"Type": "ForwardWebSocket",
"Host": "127.0.0.1",
"Port": 3001,
"HeartBeatInterval": 5000,
"HeartBeatEnable": true,
"AccessToken": ""
},
{
"Type": "ForwardWebSocket",
"Host": "127.0.0.1",
"Port": 3002,
"HeartBeatInterval": 5000,
"HeartBeatEnable": true,
"AccessToken": ""
}
]