【教程】小白可学的用 Lagrange.OneBot 对接 OlivOS

Desom-fu

二编：仑佬已经帮我改好了.jpg

呜呜，我对不起拉格兰，我几乎全文的 `Lagrange` 都打成了 `Langrange`！除标题外正文均已更改，标题改不了了，图片不好改了，文件不好改，我有罪（

—

按理来说会对接 llob 和 napcat，你也同样能用 Lagrange.OneBot 对接 OlivOS

—

何为 Lagrange？

Lagrange 是一个开源的 NTQQ 协议实现，具体文档点击这里可看
开源仓库点击这里可看

何为 Lagrange.OneBot？

Lagrange.Core 实现了 OneBot V11 的通信协议, 可以和主流 Bot 框架进行通信，具体文档点击这里可看

了解完后，教程开始

演示系统：Windows Server 2019

提示：请使用OlivOS最新发行版0.11.62(182)Ver. 高筋碱水面包（及以后的更高版本）进行搭建！

下载地址：https://github.com/OlivOS-Team/OlivOS/releases/latest/

一. 下载 Lagrange.OneBot

请在这里下载最新版本的Lagrange.OneBot

lagrangeonebot-win-x64-net90-selfcontained.zip
33MB

下载完后，点开所有文件夹，找到Lagrange.OneBot.exe，复制出来，粘贴到一个你准备好的一个新的文件夹里面

双击Lagrange.OneBot.exe，生成appsettings.json后直接关闭cmd

二. 配置 Lagrange.OneBot

注意，签名服务器请加 Lagrange.Core 的 Telegram 群组获取！（tg群组请前往 何为 Lagrange？ 的链接自行添加）

打开这个链接找到签名设定部分
如图所示，填入签名服务器地址

编者的碎碎念：虽然说要加tg群，但是好像这里已经默认提供了签名服务器了，不过为了保护一下地址，自己去链接里看吧，这里就打码

注意，这里千万不能勾cq码上报！！

然后找到服务设定部分

删除默认的反向 WebSocket 服务，新建两个服务：新建 HTTP 服务、新建 HTTP POST 服务

如图所示，填写以下内容：

HTTP 服务部分：

主机地址：127.0.0.1
端口：9784（随便填写一个未占用的，和OlivOS内保持一致）
Access Token：114514（随便填写一个，和OlivOS内保持一致）

HTTP Post 服务部分：

主机地址：127.0.0.1
端口：55001（默认55001，若挂多个骰子请参考这篇教程中的 七、注 部分）
后缀：/OlivOSMsgApi/qq/onebot/default
Access Token：114514（随便填写一个，和OlivOS内保持一致）

随后点击右上角的 复制到剪切板 粘贴到 appsettings.json 里，全覆盖 粘贴，原先的一点不留！

三. 登录 Lagrange.OneBot

双击 Lagrange.OneBot.exe，扫码登录（若码移动的太快或者模糊不清，可以打开文件夹里的qr-0.png进行扫码）

如果出现以下这种状况，是正常的，因为没有配置 OlivOS ，没能上报成功，配置完 OlivOS 即可恢复正常

四. 配置 OlivOS

账号类型选择 onebotV11/Http
账号填写骰子的 QQ 号
地址填写： http://127.0.0.1
端口填写和上文 HTTP 服务一致
Access Token 填写和上文 HTTP 服务一致

随后点击保存，启动 OlivOS 即可

至此，对接成功！

Desom-fu

2025.6.17 删除（五）（六）（七）三个部分

OlivOS已更新，修复了bug，故删除这三个已经没用的部分

2025.5.27 新增对接 Lagrange 的 OlivOS 编译包（五）

新增 Window 版对接 Lagrange 的 OlivOS 编译包，放在了第五条，强烈推荐用这个方法

2025.5.24 增加源码模式的修改（六）

如果你是源码运行，推荐使用这个方法，更加简单直白，且不会有bug

2025.5.24 转发消息软件更新

转发消息软件增加了回调函数，使得能将返回的请求重新发送回接收配置，接收到返回的信息

出现如图所示日志为正常现象，不必惊慌
Image description

注：新版（v0.1.1）不太稳定，如果时常死机的话，建议换回旧版（v0.0.1版本）

Mycvj

大佬，我第一步就死了。下载后解压文件名称为“Lagrange.OneBot”没有后缀的“exe”，没有办法双击点开文件

Ulica

Mycvj win版本才有exe文件，看一下自己是不是下错了

xqq123

Ulica 大佬打扰了，找半天没找到win版本在哪

2184445819

说点错题本：
1.lgrg有消息，olivos没有：没填httppost后缀
2.第一次点lgrg有二维码，第二次打开exe文件不再生成新的二维码：已经自动登上了不用再扫

Ulica

xqq123 点击第一步的“请在这里下载最新版本的Lagrange.OneBot”，点开assets，会有几个版本的拉格兰，下载最下面的，32位系统选win-x86，64位系统选win-x64，解压后是文件夹，点到根目录就有exe文件，如果还看不到就是没开扩展名

仑质

没事我帮你改正了