🎲 青果核 + LLOneBot 搭建指南 📚 参考来源本文整合自 LLOneBot 快速开始和 LLOneBot 对接 OlivOS 论坛教程 — 📖 前言本文档为搬运整合并优化的教程，原作者为临皋闲人和牛角包。由于原作者不希望展示源文章链接，此处不再提供。鉴于论坛内教程较旧，急需更新，因此整合并优化了现有教程。搬运已获得原作者授权。 — 💡 基础知识 LLOneBot（LLTwoBot）是什么？ 💬 简介：LLOneBot 是基于 OneBot v11 协议开发的协议端与 Satori 协议服务器。 📖 详细介绍请参阅： LLOneBot 快速开始文档 — 📥 下载安装包 1️⃣ 下载 LLOneBot 协议端 ⚠️ 系统要求： ✅ Windows 8.1（或 Windows Server 2012 R2）及以上版本 ✅ 已安装 64 位 NTQQ 📦 下载地址： GitHub ： LLOneBot Releases LLOneBot-win-x64.zip （不含 FFmpeg） LLOneBot-win-x64-ffmpeg.zip （含 FFmpeg，推荐）⭐ 微云镜像（含 FFmpeg 版本）： https://share.weiyun.com/dnOysKL8 💡 提示：请解压整个压缩包，不要只拖出 .exe 文件！ — 2️⃣ 下载青果骰（OlivaDice） 📦 下载地址： GitHub ： OlivaDiceCore Release 3.4.0 推荐下载： OlivaDice-OlivOS-Win.zip ⭐ 论坛镜像（无需科学上网）： OlivaDice 官方论坛下载 💡 提示：请解压整个压缩包，不要只拖出 .exe 文件！ — 🛠️ 安装与配置步骤 1：解压文件分别解压两个压缩包到任意位置（不一定要放在 C 盘）。 — 步骤 2：启动 LLOneBot 双击 llonebot.exe ，会出现一个粉色控制台窗口（⚠️ 不要关闭此窗口） QQ 会自动启动，登录后会在 llonebot.exe 所在目录生成 data 文件夹 ⚠️ 注意：登录时不能勾选多个账号，LLOneBot 不支持多账号登录方式！ — 步骤 3：配置 LLOneBot 浏览器打开： http://localhost:3080 ，或者直接点击控制台的配置首次访问需要设置密码（忘记密码可在 data/config_<QQ号>.json 中查看） 🔧 配置参数配置界面如下图所示：点击左侧红框的选项。随后页面如下：没有其他特殊需求的话，你仅需要设置“HTTP服务”与“HTTP上报”两个板块首先，点击 HTTP服务，出现如下窗口：点击按钮，启用该适配器 🔴 红框部分（端口配置）： HTTP 端口：填写 10000-49999 范围内的 5 位随机数字（例如： 12345 ）消息格式：⚠️ 必须选择 “消息段” （若 OlivOS 版本 ≥ 0.11.66 可选 “CQ码”） 🟣 紫框部分（密钥配置）： OneBot 11 Token ：填写与 HTTP 上报密钥相同的数字其次，点击 HTTP上报，随后页面如下：点击按钮，启用该适配器 🔴 红框部分（上报地址配置）： HTTP 上报地址： http://127.0.0.1:55001/OlivOSMsgApi/qq/onebot/default 📌 重要提示： HTTP 端口与密钥这两组数字是固定匹配的，不能变动如忘记配置，可在 data/config_<QQ号>.json 文件中查看千万别从托盘栏里面退出，这样退出有几率会导致http端口持续被占用，尽量在配置页面里面退出！！ — 步骤 4：启动 OlivaDice（青果核）双击运行 OlivaDice-OlivOS-Win 文件夹中的 OlivOS.exe — 步骤 5：创建骰子账号在 OlivOS 界面中创建账号账号类型选择： onebotV11/Http — 步骤 6：配置骰子账号填写以下信息： QQ 号：你的骰子 QQ 号端口：填写之前在 LLOneBot 中配置的 HTTP 端口（5 位数字） Token ：填写之前配置的 OneBot 11 Token （6 位数字）地址：固定填写 http://127.0.0.1 （⚠️ 注意不能漏掉 http:// ）点击保存。 — 步骤 7：启动骰子选中你的骰子账号（点击变蓝）点击启动按钮 — 步骤 8：处理首次启动问题初次启动时，可能会遇到加载问题：解决方法：在系统托盘（右下角状态栏）右击青果图标选择退出程序重新双击 OlivOS.exe 启动此时应能正常加载 — 步骤 9：测试骰子向骰子 QQ 发送私聊消息： .r 如果骰子成功回复掷骰结果，则搭建完毕！🎉 💡 控制台说明：蓝白面板是你的控制台，如发生错误会显示红色文字。 — 🚀 进阶：无头模式（Headless Mode）什么是无头模式？无头模式允许 LLOneBot 不依赖图形界面运行 QQNT 客户端。优势： ✅ 大幅降低内存占用 ✅ 提升服务器运行效率 ✅ 加快骰子响应速度 ⚠️ 注意：无法在服务器中用 QQ 客户端查看/回复消息要求： LLOneBot 版本 ≥ 6.0.0 本地已安装最新版 NTQQ 下载地址： LLOneBot Releases — 配置无头模式步骤 1：常规启动与配置按照前面的流程启动 llonebot.exe 并扫码登录 QQ 重新配置端口与 Token（参考步骤 3） — 步骤 2：修改配置文件找到并打开以下文件（用记事本打开）： pmhq_config.json 找到最后一行 "headless": false ，修改为： "headless": true 按 Ctrl+S 保存文件 — 步骤 3：重启并扫码登录退出 QQ、LLOneBot、青果核重新启动 llonebot.exe 点击配置，随后在弹出的窗口中扫码或者直接登录看到紫色窗口显示登录成功字样后，启动青果核 — 🔥配置自动登录每次都要点击配置进行登录，太麻烦了？看看这里吧！找到并打开以下文件（用记事本打开）： pmhq_config.json 找到 "quick_login_qq": "", 将 "quick_login_qq": "", 修改为： "quick_login_qq": "你的qq号", — 常见问题 Q：青果控制台无法接收消息，也没有回执？ A ：按以下步骤排查：如果紫色窗口显示 “未登录，请点击配置按钮登录” ：点击配置按钮等待出现二维码扫码登录如果扫码后自动启动了 QQ 客户端：先启动青果核，测试是否能正常收发消息如果正常，退出 LLOneBot、QQ、青果核重新从步骤 3 的第 2 步开始执行 — ✅ 至此，搭建完毕！祝你使用愉快！🎲✨

Desom-fu 再三检查后还是没看出来是哪里弄错了、我眼挫

2025.10.11更新同步原教程并进行适当改编，增加无头登录模式增加快速登录配置

大佬，我似乎也出现了和上面那位兄弟一样的情况，就是是后台有但是骰不会发出来，私聊也没有并且已经检查过了用的是青果侧的地址不是正向ws，跪求

【搬运-教程】新llob教程-小白可学的用 LLOneBot 对接 OlivOS

Desom-fu

🎲 青果核 + LLOneBot 搭建指南

📚 参考来源
本文整合自 LLOneBot 快速开始和 LLOneBot 对接 OlivOS 论坛教程

—

📖 前言

本文档为搬运整合并优化的教程，原作者为 临皋闲人 和 牛角包。

由于原作者不希望展示源文章链接，此处不再提供。鉴于论坛内教程较旧，急需更新，因此整合并优化了现有教程。搬运已获得原作者授权。

—

💡 基础知识

LLOneBot（LLTwoBot）是什么？

💬 简介：LLOneBot 是基于 OneBot v11 协议开发的协议端与 Satori 协议服务器。
📖 详细介绍请参阅：LLOneBot 快速开始文档

—

📥 下载安装包

1️⃣ 下载 LLOneBot 协议端

⚠️ 系统要求：

✅ Windows 8.1（或 Windows Server 2012 R2）及以上版本
✅ 已安装 64 位 NTQQ

📦 下载地址：

GitHub：LLOneBot Releases
- LLOneBot-win-x64.zip（不含 FFmpeg）
- LLOneBot-win-x64-ffmpeg.zip（含 FFmpeg，推荐）⭐
微云镜像（含 FFmpeg 版本）：https://share.weiyun.com/dnOysKL8

💡 提示：请解压整个压缩包，不要只拖出 .exe 文件！

—

2️⃣ 下载青果骰（OlivaDice）

📦 下载地址：

GitHub：OlivaDiceCore Release 3.4.0
- 推荐下载：OlivaDice-OlivOS-Win.zip ⭐
论坛镜像（无需科学上网）：OlivaDice 官方论坛下载

💡 提示：请解压整个压缩包，不要只拖出 .exe 文件！

—

🛠️ 安装与配置

步骤 1：解压文件

分别解压两个压缩包到任意位置（不一定要放在 C 盘）。

—

步骤 2：启动 LLOneBot

双击 llonebot.exe，会出现一个粉色控制台窗口（⚠️ 不要关闭此窗口）
QQ 会自动启动，登录后会在 llonebot.exe 所在目录生成 data 文件夹

⚠️ 注意：登录时不能勾选多个账号，LLOneBot 不支持多账号登录方式！

—

步骤 3：配置 LLOneBot

浏览器打开：http://localhost:3080，或者直接点击控制台的配置
首次访问需要设置密码（忘记密码可在 data/config_<QQ号>.json 中查看）

🔧 配置参数

配置界面如下图所示：

Image description

点击左侧红框的选项。随后页面如下：

Image description

没有其他特殊需求的话，你仅需要设置“HTTP服务”与“HTTP上报”两个板块

首先，点击HTTP服务，出现如下窗口：

点击按钮，启用该适配器

🔴 红框部分（端口配置）：

HTTP 端口：填写 10000-49999 范围内的 5 位随机数字（例如：12345）
消息格式：⚠️ 必须选择 “消息段”（若 OlivOS 版本 ≥ 0.11.66 可选 “CQ码”）

🟣 紫框部分（密钥配置）：

OneBot 11 Token：填写与 HTTP 上报密钥相同的数字
其次，点击HTTP上报，随后页面如下：

点击按钮，启用该适配器

🔴 红框部分（上报地址配置）：

HTTP 上报地址：http://127.0.0.1:55001/OlivOSMsgApi/qq/onebot/default

📌 重要提示：

HTTP 端口与密钥这两组数字是固定匹配的，不能变动

如忘记配置，可在 data/config_<QQ号>.json 文件中查看

千万别从托盘栏里面退出，这样退出有几率会导致http端口持续被占用，尽量在配置页面里面退出！！

—

步骤 4：启动 OlivaDice（青果核）

双击运行 OlivaDice-OlivOS-Win 文件夹中的 OlivOS.exe

OlivOS 主界面

—

步骤 5：创建骰子账号

在 OlivOS 界面中创建账号
账号类型选择：onebotV11/Http

创建账号

—

步骤 6：配置骰子账号

填写以下信息：

QQ 号：你的骰子 QQ 号
端口：填写之前在 LLOneBot 中配置的 HTTP 端口（5 位数字）
Token：填写之前配置的 OneBot 11 Token（6 位数字）
地址：固定填写 http://127.0.0.1（⚠️ 注意不能漏掉 http://）

点击保存。

配置账号

—

步骤 7：启动骰子

选中你的骰子账号（点击变蓝）
点击启动按钮

启动骰子

—

步骤 8：处理首次启动问题

初次启动时，可能会遇到加载问题：

启动问题

解决方法：

在系统托盘（右下角状态栏）右击青果图标
选择退出程序
重新双击 OlivOS.exe 启动
此时应能正常加载

—

步骤 9：测试骰子

向骰子 QQ 发送私聊消息：.r

如果骰子成功回复掷骰结果，则搭建完毕！🎉

💡 控制台说明：蓝白面板是你的控制台，如发生错误会显示红色文字。

—

🚀 进阶：无头模式（Headless Mode）

什么是无头模式？

无头模式允许 LLOneBot 不依赖图形界面运行 QQNT 客户端。

优势：

✅ 大幅降低内存占用
✅ 提升服务器运行效率
✅ 加快骰子响应速度
⚠️ 注意：无法在服务器中用 QQ 客户端查看/回复消息

要求：

LLOneBot 版本 ≥ 6.0.0
本地已安装最新版 NTQQ

下载地址：LLOneBot Releases

—

配置无头模式

步骤 1：常规启动与配置

按照前面的流程启动 llonebot.exe 并扫码登录 QQ
重新配置端口与 Token（参考步骤 3）

—

步骤 2：修改配置文件

找到并打开以下文件（用记事本打开）：
pmhq_config.json
找到最后一行 "headless": false，修改为：
```
   "headless": true
```
按 Ctrl+S 保存文件

—

步骤 3：重启并扫码登录

退出 QQ、LLOneBot、青果核
重新启动 llonebot.exe
点击配置，随后在弹出的窗口中扫码或者直接登录
看到紫色窗口显示登录成功字样后，启动青果核

—

🔥配置自动登录

每次都要点击配置进行登录，太麻烦了？看看这里吧！

找到并打开以下文件（用记事本打开）：
pmhq_config.json
找到 "quick_login_qq": "",
将 "quick_login_qq": "", 修改为："quick_login_qq": "你的qq号",

—

常见问题

Q：青果控制台无法接收消息，也没有回执？

A：按以下步骤排查：

如果紫色窗口显示 “未登录，请点击配置按钮登录”：
- 点击配置按钮
- 等待出现二维码
- 扫码登录
如果扫码后自动启动了 QQ 客户端：
- 先启动青果核，测试是否能正常收发消息
- 如果正常，退出 LLOneBot、QQ、青果核
- 重新从步骤 3 的第 2 步开始执行

—

✅ 至此，搭建完毕！

祝你使用愉快！🎲✨

and

大佬，咱的这个按照教程搭建好了，但是。r和回复词都发不出来，是又有什么问题吗 Image description

and

and 打漏字了，是后台有但是骰不会发出来，私聊也没有

Desom-fu

and 检查一下你的端口是否正确

and

Desom-fu Image description

再三检查后还是没看出来是哪里弄错了、我眼挫

Desom-fu

and 首先建议换个端口，这个端口是很容易被占用的，其次青果侧的地址是http http://127.0.0.1，不是正向ws

and

Desom-fu OK了，谢谢大佬

Desom-fu

2025.10.11更新

同步原教程并进行适当改编，增加无头登录模式
增加快速登录配置

Desom-fu

2025.11.13更新

同步原教程并进行适当改编，优化了配置页面，