快速开始

LLOneBot 支持最新版本的 QQ。注意要用原版的 QQ ，不要安装任何插件！

Windows 一键安装方案

首先确认你已经安装了 NTQQ

如果以前装过 LLOneBot5.0 以下版本，请卸载 QQ 并删干净 QQ 目录，否则有掉线风险

到 release 页面 下载 LLOneBot-win-x64.zip 或 LLOneBot-win-x64-ffmpeg.zip，

其中 LLOneBot-win-x64.zip 是不包含 FFmpeg 的版本，LLOneBot-win-x64-ffmpeg.zip 是包含 FFmpeg 的版本，

推荐使用包含 FFmpeg 的版本。

解压后双击 llonebot.exe 会启动 QQ，登录后会在 llonebot.exe 所在目录生成一个 data 文件夹，

修改data/config_<qq号>.json 文件，进行配置。

配置文件具体内容往下翻。

Linux 一键 docker 安装方案

curl -fsSL https://raw.githubusercontent.com/linyuchen/PMHQ/refs/heads/main/docker/install-llob.sh -o install-pmhq-llob.sh && chmod u+x ./install-pmhq-llob.sh && ./install-pmhq-llob.sh

通用手动安装方法

下载 pmhq

运行 pmhq 后会启动 QQ 并生成配置文件 pmhq_config.json

pmhq_config.json 的 default_host 和 default_port 是用来和 LLOneBot 通信的，我们需要记下两个参数

再下载 LLOneBot.zip

解压后可以看到它是一个 nodejs 包，使用 node 运行 llonebot.js，并把刚刚的 pmhq host 和 port 传进去

node llonebot.js --pmhq-host=127.0.0.1 --pmhq-port=13000

登录 QQ 后 LLOneBot 就会显示连接上了

LLOneBot 配置文件

配置文件是自动生成的，请不要直接复制下面全部内容粘贴进去，带 // 的注释会解析不了

修改后会自动重载，无需重启 QQ 和 LLOneBot

{
  "satori": {
    "enable": true,  // 是否启用 Satori 协议
    "port": 5600,  // Satori 监听端口
    "token": "" // Satori token
  },
  "ob11": {
    "enable": true, // 是否启用 OneBot 11 协议
    "token": "", // OneBot 11 协议的 token
    "httpPort": 3000, // HTTP 监听端口
    "httpPostUrls": [],  // HTTP 上报地址，如 ["http://localhost:8080/onebot/v11"]
    "httpSecret": "",  // HTTP 上报密钥
    "wsPort": 3001, // 正向 WebSocket 监听端口
    "wsReverseUrls": [], // 反向 WebSocket 地址，如 ["ws://localhost:8080/onebot/v11/ws"]
    "enableHttp": true, // 是否启用 HTTP 服务
    "enableHttpPost": true, // 是否启用 HTTP 上报
    "enableWs": true, // 是否启用正向 WebSocket 服务
    "enableWsReverse": false, // 是否启用反向 WebSocket 服务
    "messagePostFormat": "array", // 消息上报格式，支持 "array" 或 "string"
    "enableHttpHeart": false, // 是否启用 HTTP 心跳
    "reportSelfMessage": true // 是否上报自己的消息
  },
  "heartInterval": 60000, // 心跳间隔，单位毫秒
  "enableLocalFile2Url": false, // 是否启用本地文件转 URL 功能
  "debug": false, // 是否启用调试模式
  "log": true, // 是否启用日志
  "autoDeleteFile": false, // 是否自动删除收到的文件
  "autoDeleteFileSecond": 60, // 自动删除收到的文件的时间，单位秒
  "musicSignUrl": "", // 音乐签名地址
  "msgCacheExpire": 120, // 消息缓存过期时间，单位秒
  "onlyLocalhost": true, // 是否只监听本地地址，否则监听公网地址，暴露在公网请务必设置 token
}

下一步

参阅对接其他框架。