🎲 青果核 + 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 ，或者直接点击控制台的配置如果出现的是如图所示的界面，请点击下面的启动后再点击 Bot设置然后点击红框所示按钮进行webui配置当然你也可以直接在这个界面配置，具体差不多就不具体论述了首次访问需要设置密码（忘记密码可在 data/config_<QQ号>.json 中查看） 🔧 配置参数配置界面如下图所示：点击左侧红框的选项。随后页面如下：没有其他特殊需求的话，你仅需要设置“HTTP服务”与“HTTP上报（新版本叫Webhook）”两个板块首先，点击 HTTP服务，出现如下窗口：点击按钮，启用该适配器 🔴 红框部分（端口配置）： HTTP 端口：填写 10000-49999 范围内的 5 位随机数字（例如： 12345 ）消息格式：⚠️ 必须选择 “消息段” （若 OlivOS 版本 ≥ 0.11.66 可选 “CQ码”） 🟣 紫框部分（密钥配置）： OneBot 11 Token ：填写与 HTTP 上报密钥相同的数字其次，点击 HTTP上报（Webhook），随后页面如下：点击按钮，启用该适配器 🔴 红框部分（上报地址配置）： 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/LLOnebot 如果用的是旧版本没有这个选项就选 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 — 配置无头模式此处教程仅适用于llbot的6.6.9及以上版本很简单，在系统配置里面勾选无头模式即可此处教程仅适用于llbot的6.6.6及以下版本步骤 1：常规启动与配置按照前面的流程启动 llonebot.exe 并扫码登录 QQ 重新配置端口与 Token（参考步骤 3） — 步骤 2：修改配置文件找到并打开以下文件（用记事本打开）： pmhq_config.json 找到最后一行 "headless": false ，修改为： "headless": true 按 Ctrl+S 保存文件 — 步骤 3：重启并扫码登录退出 QQ、LLOneBot、青果核重新启动 llonebot.exe 点击配置，随后在弹出的窗口中扫码或者直接登录看到紫色窗口显示登录成功字样后，启动青果核 — 🔥配置自动登录每次都要点击配置进行登录，太麻烦了？看看这里吧！此处教程仅适用于llbot的6.6.9及以上版本于系统配置中填入自动登录QQ号就行此处教程仅适用于llbot的6.6.6及以下版本找到并打开以下文件（用记事本打开）： 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

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更新

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

Desom-fu

2025.12.14 更新

大概是优化教程更新最新的页面

and

大佬大佬，大过年再更新完又出了问题，能帮忙看下吗orz球球了 Image description
过年太多事情弄得心力憔悴光是看着头都在晕自己真的搞不会了两个版本都试了都启动不了
orz

Desom-fu

and 那就只能退版本看看了，或者重新下载一下