Search code, repositories, users, issues, pull requests

admin 发布：2024-12-26 09:12 5

本文将包含你使用第三方软件将机器人连接 QQ 平台时所需要了解的内容。

说明

目前，大多数群聊中的 QQ 机器人都采用”伪用户”的方式，即通过第三方软件接入已注册的 QQ 账号。从 QQ 官方的角度来看，这些软件属于”外挂软件”，QQ 官方对此类实现采取了各种技术和非技术手段进行打击。

QQ 官方会监测账号行为以区分正常用户和机器人，例如检测异常登录方式或频繁的多地区登录等。虽然具体的检测细节未知，但已经确认的是，当 QQ 账号被识别为机器人时，可能会面临警告、封禁，甚至临时或永久冻结的处罚。

虽然不同方案之间存在较大差异（例如基于 Android QQ 协议的已基本无法使用，而基于 NTQQ 协议的和方案则较为稳定），但这些方案均由第三方软件社区提供，并不受到官方支持。

因此，是否在 QQ 平台上搭建非官方机器人需要谨慎考虑。同时，第三方方案的可用性可能会随时间变化，我们无法提供任何保证。在 QQ 平台上选择使用何种方案取决于个人意愿。

Caution

如果出现 QQ 账号被冻结等情况，我们无力解决此类问题，也不会为相应后果负责。

Lagrange

Lagrange 是一个 NTQQ 协议相关的开源项目。包括目前实现 Linux NTQQ 协议的 Lagrange.Core 和提供 OneBot-V11 API 的 Lagrange.Onebot 两部分。

下载与安装

如果你想使用 Docker 搭建 Lagrange，请转到使用 Docker。

推荐前往 Github Actions，找到 Lagrange.OneBot Release，点击最新的工作流，下拉找到并下载合适的版本。

或者从 Lagrange 的 GitHub Release 上下载 Nightly 版本。

系统类型压缩文件

Intel 版 MacOS

Lagrange.OneBot_osx-x64_8.0.zip

M1 版 MacOS

Lagrange.OneBot_osx-arm64_8.0.zip

64 位 Linux

Lagrange.Onebot_linux-x64_8.0.zip

arm64 Linux

Lagrange.OneBot_linux-arm64_8.0.zip

armv7 Linux

Lagrange.OneBot_linux-arm_8.0.zip

64 位 Linux (musl)

Lagrange.Onebot_linux-musl-x64_8.0.zip

arm64 Linux (musl)

Lagrange.OneBot_linux-musl-arm64_8.0.zip

armv7 Linux (musl)

Lagrange.OneBot_linux-musl-arm_8.0.zip

32 位 Windows

Lagrange.OneBot_win-x86_8.0.zip

64 位 Windows

Lagrange.OneBot_win-x64_8.0.zip

解压下载好的文件到一个已经预先准备好的文件夹中。

运行 Lagrange。此时将提示：

No exist config file, create it now... 
Please Edit the appsettings.json to set configs and press any key to continue

程序将会自动在存放 Lagrange 文件夹的目录下生成一个默认配置文件 appsettings.json。

配置

请在机器人配置文件填写以下配置项：

qq_account = – 机器人的 QQ 号。

qq_host = “127.0.0.1:11451” – 将会在填写的 IP 地址和端口中开启一个 Websocket 服务器，用于 Lagrange 反向连接。

qq_frame_type = “Lagrange” – 告诉机器人正在使用 Lagrange，以处理兼容性问题。

接下来，请在 Lagrange 的配置文件中设置对应的连接方式。

 {
  ...
  "Implementations": [
    {
      // 使用反向 WebSocket 服务
      "Type": "ReverseWebSocket",
      // 此处填写先前的 IP 地址和端口
      "Host": "127.0.0.1",
      "Port": 11451,
      "Suffix": "/ws",
      ...
    }
    ...
  ]
}

Important

请删除 JSON 文件的所有注释，否则无法正常读取。

修改完文件后扫码登录即可。

Note

若在配置中遇到问题，请参见 Lagrange README 文件。

LLOneBot

LLOneBot 是 Liteloader 的插件之一，可以使 NTQQ 支持 OneBot11 协议进行 QQ 机器人开发。

LiteLoaderQQNT（LiteLoader）是 NTQQ 的插件加载器，允许通过插件注入 QQ 实现某些特定的功能。

安装

请参考官方文档中的说明进行插件的安装。

Warning

不建议用户随意更新 QQ 客户端。由于 QQ 客户端检测机制可能的变化，更新客户端可能会导致原有方案不可用。

配置

请在机器人配置文件填写以下配置项：

qq_account = – 机器人的 QQ 号。

qq_host = “127.0.0.1:11451” – 将会在填写的 IP 地址和端口中开启一个 Websocket 服务器，用于 LLOnebot 反向连接。

qq_frame_type = “LLOneBot” – 告诉机器人正在使用 LLOneBot，以处理兼容性问题。

安装 LLOneBot 完成后重新登录 QQ，进入 LLOneBot 的设置页。

打开”启用反向 Websocket 服务”，点击下方的”添加”，并添加好反向 Websocket 监听地址。在示例中为 ws://127.0.0.1:11451/ws，注意不要删去后面的 /ws。

关闭设置窗口，确认配置文件保存。

NapCatQQ

NapCatQQ 是在后台低占用运行的无头（没有界面）NTQQ 机器人框架。

注意相同账号不能同时登录原版 QQ 和 NapCatQQ。

安装

请根据安装官方QQ，若 QQ 版本过低可能会导致程序无法正常启动。

从 NapCatQQ 的 GitHub Release 下载最新的版本。

Warning

不建议用户随意更新 QQ 客户端。由于 QQ 客户端检测机制可能的变化，更新客户端可能会导致原有方案不可用。

配置

请在机器人配置文件填写以下配置项：

qq_account = – 机器人的 QQ 号。

qq_host = “127.0.0.1:11451” – 将会在填写的 IP 地址和端口中开启一个 Websocket 服务器，用于 NapCatQQ 反向连接。

qq_frame_type = “NapCatQQ” – 告诉机器人正在使用 NapCatQQ，以处理兼容性问题。

安装 NapCatQQ 完成后，你需要修改 config/onebot11.json 的内容，并重名为 onebot11_.json。

接下来，请在 NapCatQQ 的配置文件中设置对应的连接方式。

{
    ...
    "reverseWs": {
        // 是否启用反向websocket服务
        "enable": true,
        // 反向websocket对接的地址, 如["ws://127.0.0.1:8080/onebot/v11/ws"]
        "urls": ["ws://127.0.0.1:11451/ws"]  // 此处填写先前的 IP 地址和端口，注意不要删去后面的“/ws”   
    },
    ...
}

Important

请删除 JSON 文件的所有注释，否则无法正常读取。

也可以使用 WebUI 进行配置，详见 NapCat 手册。

修改完文件后请根据启动程序，扫码登录即可。

OpenShamrock

OpenShamrock 是基于 Xposed 实现的 QQ 机器人框架，你可以在 Android 手机 / 模拟器中使用 OpenShamrock运行机器人。

Caution

2024 年 8 月 12 日，OpenShamrock 于 GitHub 中的存储库已被归档，开发者已无力继续维护此项目。

Caution

2024 年 4 月 2 日，OpenShamrock 开发组于宣布，OpenShamrock 将会从 1.1.0 版本起弃用 OneBot V11 支持，迁移至新的 Kritor 协议。

这意味着 1.1.0 及之后版本的 OpenShamrock 将不再支持 OneBot V11，以下内容也不再适用。请仔细辨别，以免带来不必要的困扰。

Warning