Fox群管机器人完整部署配置教程
一、环境准备与文件说明
在开始配置前,请先从onebot注册获取token授权以及下载下面全部所需资源,核心组件分为四类,按需选择对应版本下载:
1. QQ外置通信程序(二选一即可)
负责QQ协议通信,是机器人运行的基础载体:
- LLBot(Desktop版):功能完整,占用内存稍大,适合电脑/服务器长期运行
下载地址:LLBot-Desktop-win-x64 - NapCat:轻量精简版,内存占用更低,适合低配置服务器使用
下载地址:NapCat
2. 运行框架(二选一即可)
负责连接外置通信程序、加载运行群管插件:
3. Fox群管插件
根据选择的运行框架,下载对应后缀的插件文件:
- 萌Q框架 → 选择
MQ.dll结尾的插件 - NRBot框架 → 选择
NR.dll结尾的插件
插件下载地址:iQ群管插件全集
4. 必备基础软件
电脑版QQ:机器人登录的客户端载体,需提前安装到电脑/服务器上。
注意:所有压缩包下载后建议放在纯英文路径的文件夹中,避免中文路径导致程序启动异常。
二、启动外置通信程序(以LLBot为例)
- 解压
LLBot-Desktop-win-x64压缩包,进入程序根目录 - 找到主程序
llbot.exe,双击启动,程序会自动初始化配置文件与运行环境 - 等待程序加载完成,进入主界面后,先不要关闭,保持后台运行。
三、机器人QQ账号登录
- 在LLBot左侧导航栏进入「控制面板」页面
- 找到QQ进程控制区域,点击「启动」按钮,程序会唤起已安装的电脑版QQ
- 若电脑上已登录机器人QQ账号,请先手动退出关闭,再从程序内启动,避免登录冲突
- 在弹出的QQ登录窗口,扫码或输入密码登录机器人QQ账号,登录成功后返回LLBot,状态显示「运行中」即为正常。
四、LLBot反向通信对接配置
配置外置程序与运行框架的通信通道,实现数据互通:
- 在LLBot左侧菜单进入「Bot配置」页面
- 找到「OneBot 11」板块,先勾选「启用 OneBot 11」总开关
- 切换到 WebSocket 客户端(反向) 标签页
- 勾选「启用」该连接配置
- URL地址填写:
ws://127.0.0.1:3001127.0.0.1代表本机通信,框架和LLBot在同一台设备上无需修改,其他机器就用服务器IP。3001为通信端口,后续框架配置需保持完全一致
- Token:若框架设置了连接鉴权密钥则填入,无特殊要求保持留空即可
- 高级选项设置:
- 心跳间隔:默认60000ms无需修改
- 消息格式:选择
array - 上报自身:建议勾选,确保框架能识别机器人自身的群事件
- 上报离线、调试:按需开启,排查问题时建议开启调试模式
- 全部设置完成后,点击右下角保存按钮生效。
五、运行框架通信设置(以萌Q框架为例)
- 运行萌Q框架更新器,等待自动更新完成后,启动
MQNT.exe主程序 - 在框架左侧菜单进入「设置」页面,找到「通信设置」板块
- 勾选「开启反向通信模式」
- 填写反向端口,必须和上一步LLBot中配置的端口完全一致,示例统一为
3001 - 确认设置后保存,框架会自动尝试与LLBot建立反向连接。
六、载入Fox群管插件
- 框架通信连接正常后,进入「应用」页面
- 点击「导入插件」按钮,选择提前下载好的对应版本群管插件文件(.dll格式)
- 导入完成后无需手动操作,程序会自动执行插件更新,过程约2-3分钟
- 更新完成后框架会自动重启,重启后插件即可正常加载
- 插件加载成功后,即可在功能列表中找到群管相关配置项,开始设置各项群控功能。
七、验证部署成功
- LLBot控制面板中,Bot与QQ均显示「运行中」
- 框架日志中出现「连接成功」「插件加载完成」类提示
- 在群内发送测试指令,机器人正常回复即代表全流程部署成功。
注意事项
- 外置程序与框架的通信端口必须完全一致,且确保端口未被其他程序占用
- 插件版本必须和框架版本匹配,MQ框架不可导入NR版插件,反之亦然
- 首次导入插件的更新过程请勿手动关闭程序,避免插件文件损坏
- 服务器部署时,需确保系统已安装对应运行库,避免程序启动报错
- 机器人QQ账号建议使用常用小号,避免新号登录触发风控导致掉线





