LLBot 的安装与配置（Milky 协议）

想必各位都听说过"协议端"和"应用端"的故事 ~~反正文档里没写过~~，简单来说：

协议端负责与 QQ 服务器通信，本文档使用 LLBot；
应用端负责编写机器人业务逻辑，也就是 NoneBot2；
两者之间通过通信协议对接，本文档使用 Milky。

LLBot 是什么

LLBot（全称 LuckyLilliaBot，幸运莉莉娅）是一个基于 NTQQ 的 QQ 机器人框架，由 LLOneBot 团队维护，支持 Windows / macOS / Linux / Docker 部署。

LLBot 通过两种方式将 QQ 的功能暴露出来：

通过 PMHQ 挂载 QQ（有头模式，需要拉起官方 QQ 客户端）；
直接完整实现 NTQQ 协议（无头模式，不依赖 QQ 客户端）。

然后再封装成标准协议，通过 WS / HTTP 等形式暴露出来，供应用端使用。

为什么是 Milky 而不是 OneBot

Milky 是基于 HTTP / WebSocket 通信的新时代 QQ 机器人应用接口标准（milky.ntqqrev.org），它对 OneBot 11 的设计理念进行了全面反思和改进：

全面兼容：旨在覆盖绝大多数 QQ 特性，适配多种应用场景；
简单易用：对协议端和应用端实现均友好，去除不必要的复杂性；
清晰规范：接口 100% 强类型，拒绝模棱两可的类型定义。

~~OneBot 是什么，真不熟（~~

LLBot 实际上也支持 OneBot 11 和 Satori 协议，但本文档默认使用 Milky——NoneBot 官方为它提供了 nonebot-adapter-milky 适配器，包管理器一条命令就能装。

_{超小声：喜欢 Satori 的可以看看 Entari（}

下载

点我跳转官方文档哦

Desktop 桌面版（推荐新手）

前往 LuckyLilliaBot Releases 下载 LLBot-Desktop-win-x64.zip，解压到固定目录（比如 D:\LLBot），双击 llbot.exe 启动，点击启动，按提示登录。

系统要求

Windows Server 2012 / Windows 10 及以上；
有头模式需要 64 位官方原版 NTQQ，且不要安装第三方 QQ 插件。

CLI 命令行版 / Docker

CLI 版支持 Windows / macOS / Linux，前往官方文档快速安装页面按系统选择即可；
服务器部署可以使用 Docker 镜像，官方文档同样有说明。

配置 Milky

在 WebUI 的 Bot 配置 中启用 Milky，填入 HTTP 配置（端口与 token）并保存；或者直接修改配置文件 bin/llbot/data/config_<你的QQ号>.json（登录前可改 default_config.json）：

json

{
  "milky": {
    "enable": true,
    "reportSelfMessage": false,
    "http": {
      "port": 3010,
      "prefix": "",
      "accessToken": ""
    }
  }
}

TIP

Milky 的 WS 和 HTTP 实际上是共用一个端口的。

对接 NoneBot2

创建项目

使用 nb create 创建项目时：

适配器选择 nonebot-adapter-milky；
勾选 httpx 和 websockets（或者只选 aiohttp）；
项目管理器选择 uv。

配置连接

在项目根目录的 .env 中添加（参考 adapter-milky 的说明）：

bash

MILKY_CLIENTS='
[
  {
    "host": "localhost",
    "port": "3010",
    "access_token": "xxx",
    "secure": false
  }
]
'

port 需要和 LLBot 的 Milky HTTP 端口一致，access_token 需要和 LLBot 配置的 token 一致。

启动

bash

nb run

连接成功后，NoneBot 日志会显示 Bot 已连接。

社群

遇到问题可以加入 LLBot 官方社群：

Telegram: https://t.me/luckylillia
QQ 群: 545402644

LLBot 的安装与配置（Milky 协议） ​

LLBot 是什么 ​

为什么是 Milky 而不是 OneBot ​

下载 ​

Desktop 桌面版（推荐新手） ​

CLI 命令行版 / Docker ​

登录 ​

配置 Milky ​

对接 NoneBot2 ​

创建项目 ​

配置连接 ​

启动 ​

社群 ​