官机绑定教程

本文介绍如何为 ZL-综合插件绑定官方机器人(下称"官机"),开通群协作能力。

绑定完成后,官机负责直接收取群消息并发送插件全部可见回复,普通机器人负责禁言、踢人、撤回、查询和定时任务等执行层操作。

准备工作

  • UniQQ 框架已安装并正常运行

  • 已下载 ZL-综合插件

  • 一个官方协议机器人(官机)和一个第三方协议机器人(普通机器人)

  • 官机和普通机器人已加入同一个 QQ 群

第一步:安装插件

拿到插件之后,打开 UniQQ 控制台,进入「插件管理」页面,点击右上角的「安装新插件」,选择插件文件安装。

在插件管理页面点击"安装新插件"

安装完成后,插件列表中可以看到 ZL-综合插件,此时状态为「已载入」:

ZL-综合插件已载入

⚠️ 此时是未启动状态,先不要启动插件,先检查机器人是否在线。

第二步:检查机器人是否在线

进入「bot 管理」页面,检查官机(官方类型)和普通机器人(第三方类型)是否都在线。

下图中普通机器人已上线,但官机状态还是「未知」,这样不行,两个都必须在线:

官机未上线,状态未知

如果有机器人未上线,右键点击该机器人选择「快速登录」,直到两个机器人都显示「已上线」:

两个机器人都已上线

第三步:启动插件

当两个机器人都上线后,回到「插件管理」页面,启动 ZL-综合插件,状态变为「运行中」:

插件已启动,运行中

第四步:绑定官机

启动之后先不要打开设置。

首先用你的 QQ 和登录的官机对话,发送:

绑定官机

官机会返回一条绑定申请验证码(10 分钟内有效):

发送"绑定官机"后收到验证码

第五步:确认绑定

拿到验证码之后,用主人 QQ 私信你登录的普通机器人(野鸡),发送:

确认官机 验证码

例如验证码是 752719,就发送 确认官机 752719。

确认成功后,机器人会提示「官机主人身份确认成功」,并让你回到群里继续绑定:

私信确认官机验证码成功

第六步:绑定群

再到你的群里发送:

绑定本群

这时会出现多条消息,插件会列出它识别到的多个可绑定群。我们先确认这个群的真实群号是多少——点击群名片即可查看:

发送"绑定本群"后返回候选群列表

通过群名片查看真实群号

确认本群群号

然后再次发送:

绑定本群 真实群号

例如本群群号是 1125678751,就发送 绑定本群 1125678751。

发送后等待官机关联,出现「官方群关联成功」即表示绑定完成:

再次发送"绑定本群+真实群号",官方群关联成功

第七步:授权并测试

这时就已经绑定成功了,我们来发送一个「菜单」试试。

注意:刚绑定时还没有给群授权,发菜单会提示「本群还没有开通插件服务」,需要先给本群授权:

授权本群 30

(数字为授权天数,按需修改)

发送菜单提示未授权,发送"授权本群30"完成授权

授权完成后,再次发送「菜单」试试,插件正常返回 ZL 菜单列表,说明一切正常:

菜单正常显示

最后打开控制台,在「官方协作」页面确认群协作映射状态:

控制台官方协作页面,映射已建立

到这里就已经成功绑定了,恭喜你有了官机协作的能力。🎉

共 27 篇 ZL-综合插件知识库 / 绑定官机教程 0 字 0 行 zhangxiaolin
创建 2026-10-09T11:37:17.862329591Z 更新 2026-10-09T11:40:02.388752481Z