> ## Documentation Index
> Fetch the complete documentation index at: https://docs.langbot.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Lagrange

> 通过 Lagrange（aiocqhttp）将 QQ 接入 LangBot，在 QQ 群聊与私聊中运行 AI 机器人。

## Lagrange介绍

Lagrange 是一个 QQNT 协议逆向工程框架，轻便且相对稳定。通过 OneBot 11 协议接入，需选择使用`OneBot v11`作为适配器。

<Warning>
  需要使用 NT QQ 与机器人交互，旧版QQ无法正常使用
</Warning>

## 部署步骤

以下仅提供 Windows 上的大致步骤，详细步骤或其他平台请参考 [Lagrange官方文档](https://lagrangedev.github.io/Lagrange.Doc/v1/Lagrange.OneBot/)

### 环境配置

安装.NET 8运行时，[点击直达微软官网下载](https://dotnet.microsoft.com/zh-cn/download/dotnet/thank-you/runtime-desktop-8.0.4-windows-x64-installer)

### 从Github Actions下载最新的build

需要登录Github后才能下载，如果你不需要部分特性，可以在Release下载，看图片3

[Github Actions](https://github.com/KonataDev/Lagrange.Core/actions)

看图进行下载:

<img src="https://mintcdn.com/langbot/7LP8IdEMby3DrX2X/images/zh/deploy/bots/qq/onebot/lagrange/dl_lgr_1.png?fit=max&auto=format&n=7LP8IdEMby3DrX2X&q=85&s=25d7bc02c5ad0e386c9a892c11b2ac8e" alt="图片1" width="1280" height="650" data-path="images/zh/deploy/bots/qq/onebot/lagrange/dl_lgr_1.png" />

<img src="https://mintcdn.com/langbot/ccEfWQOd_I5kaF_t/images/zh/deploy/bots/qq/onebot/lagrange/dl_lgr_2.png?fit=max&auto=format&n=ccEfWQOd_I5kaF_t&q=85&s=26251c1b686b8fcfbff950fb2777c162" alt="图片2" width="1280" height="650" data-path="images/zh/deploy/bots/qq/onebot/lagrange/dl_lgr_2.png" />

<img src="https://mintcdn.com/langbot/ccEfWQOd_I5kaF_t/images/zh/deploy/bots/qq/onebot/lagrange/dl_lgr_3.png?fit=max&auto=format&n=ccEfWQOd_I5kaF_t&q=85&s=e49474c68a1268a184f399d4161345fa" alt="图片3" width="1831" height="1062" data-path="images/zh/deploy/bots/qq/onebot/lagrange/dl_lgr_3.png" />

### 尾声

解压你所下载的zip，打开到有Lagrange.OneBot.exe的目录，在此目录下打开cmd命令提示符，输入

```bash theme={null}
.\Lagrange.OneBot
```

运行一次，如果输出了一个二维码，即可直接用机器人号扫码登录（若二维码显示不清楚，可以到lagrange的data目录下寻找图片文件）。

若无法登录，请检查是否正常填写了lagrange配置文件appsettings.json中的签名地址 SignServerUrl ，签名地址请到lagrange文档中寻找。

## 修改配置

需要配置 Lagrange 以让其连接上 LangBot，请编辑 Lagrange 的配置文件 appsettings.json，确保 Implementations 中的连接配置符合下图内容：

<img src="https://mintcdn.com/langbot/7LP8IdEMby3DrX2X/images/zh/deploy/bots/qq/onebot/lagrange/config_lgr.png?fit=max&auto=format&n=7LP8IdEMby3DrX2X&q=85&s=b5631c04feeeee809258c3a656f795db" alt="配置连接" width="282" height="190" data-path="images/zh/deploy/bots/qq/onebot/lagrange/config_lgr.png" />

其中 Type 必须为 `ReverseWebSocket`;\
Host 为 LangBot 运行的主机 IP，若在同一主机上，可以写 `127.0.0.1`；\
Suffix 必须为 `/ws`；

## Lagrange 对接

接下来打开 LangBot 配置页面

点击机器人，点击添加

`平台/适配器选择`为`OneBot v11`

<img src="https://mintcdn.com/langbot/ccEfWQOd_I5kaF_t/images/zh/deploy/bots/qq/onebot/napcat/napcat_webui_03.png?fit=max&auto=format&n=ccEfWQOd_I5kaF_t&q=85&s=f07e4eef632f213e2aeb29202d149ebf" alt="napcat_webui_03" width="1024" height="1496" data-path="images/zh/deploy/bots/qq/onebot/napcat/napcat_webui_03.png" />

<Info>
  注意，如果涉及多个 docker 容器的网络连接问题，请参考[网络配置详解](/zh/workshop/network-details)
</Info>