Fox群管机器人完整部署配置教程

一、环境准备与文件说明

在开始配置前,请先从onebot注册获取token授权以及下载下面全部所需资源,核心组件分为四类,按需选择对应版本下载:

1. QQ外置通信程序(二选一即可)

负责QQ协议通信,是机器人运行的基础载体:

  • LLBot(Desktop版):功能完整,占用内存稍大,适合电脑/服务器长期运行
    下载地址:LLBot-Desktop-win-x64
  • NapCat:轻量精简版,内存占用更低,适合低配置服务器使用
    下载地址:NapCat

2. 运行框架(二选一即可)

负责连接外置通信程序、加载运行群管插件:

  • 萌Q框架更新器:配套MQ系列插件,更新维护便捷
    下载地址:萌Q框架更新器
  • NRBot框架:配套NR系列插件,轻量无NapCat版
    下载地址:NRBot框架

3. Fox群管插件

根据选择的运行框架,下载对应后缀的插件文件:

  • 萌Q框架 → 选择 MQ.dll 结尾的插件
  • NRBot框架 → 选择 NR.dll 结尾的插件
    插件下载地址:iQ群管插件全集

4. 必备基础软件

电脑版QQ:机器人登录的客户端载体,需提前安装到电脑/服务器上。

注意:所有压缩包下载后建议放在纯英文路径的文件夹中,避免中文路径导致程序启动异常。

二、启动外置通信程序(以LLBot为例)

  1. 解压 LLBot-Desktop-win-x64 压缩包,进入程序根目录
  2. 找到主程序 llbot.exe,双击启动,程序会自动初始化配置文件与运行环境
  3. 等待程序加载完成,进入主界面后,先不要关闭,保持后台运行。

三、机器人QQ账号登录

  1. 在LLBot左侧导航栏进入「控制面板」页面
  2. 找到QQ进程控制区域,点击「启动」按钮,程序会唤起已安装的电脑版QQ
  3. 若电脑上已登录机器人QQ账号,请先手动退出关闭,再从程序内启动,避免登录冲突
  4. 在弹出的QQ登录窗口,扫码或输入密码登录机器人QQ账号,登录成功后返回LLBot,状态显示「运行中」即为正常。

四、LLBot反向通信对接配置

配置外置程序与运行框架的通信通道,实现数据互通:

  1. 在LLBot左侧菜单进入「Bot配置」页面
  2. 找到「OneBot 11」板块,先勾选「启用 OneBot 11」总开关
  3. 切换到 WebSocket 客户端(反向) 标签页
  4. 勾选「启用」该连接配置
  5. URL地址填写:ws://127.0.0.1:3001
    • 127.0.0.1 代表本机通信,框架和LLBot在同一台设备上无需修改,其他机器就用服务器IP。
    • 3001 为通信端口,后续框架配置需保持完全一致
  6. Token:若框架设置了连接鉴权密钥则填入,无特殊要求保持留空即可
  7. 高级选项设置:
    • 心跳间隔:默认60000ms无需修改
    • 消息格式:选择 array
    • 上报自身:建议勾选,确保框架能识别机器人自身的群事件
    • 上报离线、调试:按需开启,排查问题时建议开启调试模式
  8. 全部设置完成后,点击右下角保存按钮生效。

五、运行框架通信设置(以萌Q框架为例)

  1. 运行萌Q框架更新器,等待自动更新完成后,启动 MQNT.exe 主程序
  2. 在框架左侧菜单进入「设置」页面,找到「通信设置」板块
  3. 勾选「开启反向通信模式」
  4. 填写反向端口,必须和上一步LLBot中配置的端口完全一致,示例统一为 3001
  5. 确认设置后保存,框架会自动尝试与LLBot建立反向连接。

六、载入Fox群管插件

  1. 框架通信连接正常后,进入「应用」页面
  2. 点击「导入插件」按钮,选择提前下载好的对应版本群管插件文件(.dll格式)
  3. 导入完成后无需手动操作,程序会自动执行插件更新,过程约2-3分钟
  4. 更新完成后框架会自动重启,重启后插件即可正常加载
  5. 插件加载成功后,即可在功能列表中找到群管相关配置项,开始设置各项群控功能。

七、验证部署成功

  1. LLBot控制面板中,Bot与QQ均显示「运行中」
  2. 框架日志中出现「连接成功」「插件加载完成」类提示
  3. 在群内发送测试指令,机器人正常回复即代表全流程部署成功。

注意事项

  1. 外置程序与框架的通信端口必须完全一致,且确保端口未被其他程序占用
  2. 插件版本必须和框架版本匹配,MQ框架不可导入NR版插件,反之亦然
  3. 首次导入插件的更新过程请勿手动关闭程序,避免插件文件损坏
  4. 服务器部署时,需确保系统已安装对应运行库,避免程序启动报错
  5. 机器人QQ账号建议使用常用小号,避免新号登录触发风控导致掉线