• 教程
  • [koishi教程]如何使用 Lagrange 对接 adapter-onebot 使用教程

声明:教程必看

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

特别声明

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

提醒:

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

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

最后,

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


您也可以选择根据 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": ""
            }
        ]
    其余内容不变,仅修改 PortSuffix 即可。

正向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插件的配置项:

  1. selfId填写
  2. 您需要查看此时登录的QQNT的QQ账号
  3. 填入登陆NTQQ的机器人QQ号即可(注意不要多空格 114514】X 【114514】√)

  1. protocol选择

反向ws
配置图如下:


正向ws

  1. selfId填写
  2. 您需要查看此时登录的QQNT的QQ账号
  3. 填入登陆NTQQ的机器人QQ号即可(注意不要多空格 114514】X 【114514】√)

  1. protocol选择

正向ws
配置图如下:


最后

开启adapter-onebot插件,即可绿灯啦!

有关从 actions 中 获取最新版本的方法


前往github地址的actions页面

-> https://github.com/LagrangeDev/Lagrange.Core/actions


  1. 找绿色勾勾

  1. 从最新的往下找 Artifacts 产物

这样的就是没有 Artifacts :

这样的就是有 Artifacts :


  1. 下载对应版本

在 有 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>
  1. 下载并安装 .NET 9.0.0 运行时:

  2. 运行安装程序

    • 下载完成后,双击安装程序并按照提示完成安装。
  3. 重新运行 Lagrange.OneBot.exe

    • 安装完成后,重新运行 Lagrange.OneBot.exe,应该可以正常启动了。
24 天 后
上学 更改标题为「[koishi教程]如何使用 Lagrange 对接 adapter-onebot 使用教程
2 个月 后
itzdrli 锁定此帖
2 个月 后
2 个月 后

有关添加多个网络配置

默认配置文件中的网络配置部分

内容为

    "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": ""
        }
    ]