搭建帮助-LLOneBot

lsla大约 4 分钟搭建方法非常简单

LLOneBot（现在叫 LLBot / 幸运莉莉娅）是基于 NTQQ 的 QQ 机器人框架，也就是「协议端」；它自己不会聊天，要连上 TRSS（Yunzai）这类应用端才算跑通。官网是 llonebot.com，文档现已迁到 luckylillia.com。

说明

本篇只讲「装好 LLOneBot + 连上 TRSS」。TRSS 本身的搭建见搭建帮助-win、搭建帮助-linux。

1.下载并解压

前往 LuckyLilliaBot Releases 下载对应系统的包：

系统	下载哪个
Windows（新手推荐，带界面）	`LLBot-Desktop-win-x64.zip`
Windows（命令行版）	`LLBot-CLI-win-x64.zip`
Linux 服务器 x64 / arm64	`LLBot-CLI-linux-x64.zip` / `LLBot-CLI-linux-arm64.zip`
macOS（Apple 芯片）	`LLBot-Desktop-macos-arm64.tar.xz`
Docker	`LLBot-Docker.sh`

Windows 系统要求：Windows Server 2012 R2 / Windows 10 及以上、64 位官方原版 NTQQ，并且不要装第三方 QQ 插件。

2.启动

Windows 桌面版（推荐）

解压到固定目录，例如 D:\LLBot（路径尽量别有中文和空格）
双击 llbot.exe，点「启动」
有头模式必须由 LLBot 自己拉起 QQ，按提示登录即可；无头模式（纯协议）不需要装 QQ 客户端

Windows / Linux 命令行版

先看有哪些参数：

# Windows
llbot.exe --help

# Linux（解压后进入目录）
./start.sh --help

Linux 常见用法：

./start.sh                     # 默认方式启动
./start.sh --headless          # 无头模式：纯协议直连，不需要装 QQ
./start.sh --headed --gui      # 有头模式：桌面环境下运行，带图形界面
./start.sh --headed --shell    # 有头模式：无桌面环境（服务器）下运行
./start.sh --qq 123123         # 指定 QQ 号快速登录（首次仍需扫码）
./llbot --update               # 在线更新框架

提醒

无头模式（纯协议）有掉线风险，号体质一般的建议用有头模式。

3.登录 QQ

启动后按提示扫码登录。登录成功后有两条路可以配置：

网页控制台（WebUI）：http://localhost:3080，CLI / Docker / Desktop 都有，点点鼠标就能配
Desktop 版：直接点左侧的「Bot 配置」

配置文件在 bin/llbot/data/config_你的QQ号.json。

4.开启 OneBot 11 反向 WS

LLOneBot 默认已经开了正向 WS（3001）和 HTTP（3000），但连 TRSS 要用的是反向 WS：让 LLOneBot 当客户端，主动去连 TRSS 提供的 WS 服务端（2536 端口）。

{
  "type": "ws-reverse",
  "enable": true,
  "url": "ws://ip:2536/OneBotv11",
  "heartInterval": 60000,
  "token": "",
  "messageFormat": "array",
  "reportSelfMessage": false
}

不想手改文件的话，也可以打开 http://localhost:3080 → OneBot 11 → 把「反向 WS」开关打开、URL 填上面的地址、保存。

提醒

ip 填 TRSS 所在机器的地址：同一台机器就写 127.0.0.1，不同机器就写 TRSS 的内网/公网 IP，例如 ws://192.168.1.10:2536/OneBotv11
端口和路径以 TRSS 启动时打印出来的为准，默认就是 2536 + /OneBotv11
改完配置文件要重启 LLOneBot 才生效；在 WebUI 里改就是保存即生效
如果登录前就想配好，可以先改 default_config.json，登录后会生成并继承到 config_你的QQ号.json

5.确认连上 TRSS

TRSS 启动完成后会打印一行连接地址：

连接地址：ws://localhost:2536/[GSUIDCore,OPQBot,ComWeChat,OneBotv11]

方括号里是支持的协议路径，用 OneBot v11 就取 ws://localhost:2536/OneBotv11 这一段填给 LLOneBot。填好并重启 LLOneBot 后，TRSS 那边会显示连接就绪，群里 @ 机器人发个 #帮助 有回应就算通了。

如果 TRSS 开了鉴权（config/config/server.yaml 里的 auth.Authorization），要把那个 token 填到 LLOneBot 反向 WS 的 token 里（默认不启用鉴权）。

6.连不上怎么办

先确认 TRSS 已经启动、2536 端口在监听（ss -lntp | grep 2536）
确认 LLOneBot 那台机器能 ping 通 TRSS 的 IP，端口没被防火墙 / 安全组挡掉
提示 token 错误：LLOneBot 的 token 要和 TRSS server.yaml 里的 Bearer xxx 一致
消息发出去没反应：确认 messageFormat 是 array，以及 TRSS 里装了对应插件
更多问题见 LLBot 常见问题，配置项细节见 LLBot 配置，其他系统的安装方式见快速安装