[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

使用下载链接

https://ghfast.top/https://github.com/LagrangeDev/Lagrange.Core/releases/download/nightly/Lagrange.OneBot_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": ""
        }
    ]