Skip to content

机器人管理 ​

这篇帮你做什么:管理你的机器人档案——创建、改资料、绑定连接配置、看它在不在线。入口:仪表盘 → 机器人管理(与"控制台""连接配置"是同一层级的平级菜单,不存在额外的"控制台"子菜单层级)。

机器人账号、连接与在线:三件事不要混在一起 ​

控制台里一个"机器人"由三层东西组成,排查问题前先分清你在看哪一层:

  • 机器人档案(本页管理):控制台里的一条记录——名称、渠道、机器人 ID、Token、权重、启用状态。它只是档案,创建档案不会让任何账号上线。
  • 连接配置:机器人与群管家之间的协议接入通道(地址、Access Token、反向 WebSocket 等),在 连接配置 页维护。档案必须绑定一条连接,消息才有收发的路;"未绑定"的机器人不收发消息。
  • 平台账号与实现端:QQ 号本身和把它接入协议的实现端程序(如 OneBot 实现端)。这一层由你另行部署和维护,群管家不自带各平台的客户端。

在线状态表示该档案对应的实现端当前是否通过连接接入了群管家:实现端接入后才显示"在线",断开、未部署或未绑定连接都是"离线"。启用≠在线——启用只是让档案参与调度;新建的机器人显示"离线"是正常的。反过来,在线也不代表业务已配置:群绑定、监控开关、指令权限都在各自页面单独配置。机器人、连接、群与配置的整体关系另见群管家怎样工作。

添加机器人 ​

  1. 点 添加机器人,填写四项必填:机器人名称(便于识别)、渠道(界面提供 QQ / 微信 / Telegram)、机器人 ID(QQ 渠道填写机器人 QQ 号)、Token(机器人档案要求的口令字段)。渠道是档案上的选项,不代表本软件自带相应平台客户端;实际可用性取决于你部署的实现端。通信鉴权还要核对连接配置的 Access Token 与实现端设置,见连接机器人。
  2. 绑定连接配置:选择这条机器人走哪条连接(可先留空,之后回来绑定,见连接机器人)。
  3. 全局权重:默认 100。只用一个机器人时保持默认即可;多机器人的分配方式见下文。
  4. 点 确认,提示"机器人创建成功"。

全局权重是怎么用的 ​

当同一个群有多台参与、具备所需能力与权限且在线的机器人时,每个完整的群出站动作包(一次踢人、一次回复等)都会按各机器人的全局权重独立随机选择一台执行。

  • 这不是固定比例轮询:权重 80 和 20 的两台机器人不等于"每 5 次恰好 4 比 1",长期统计上才接近权重比。
  • 每个动作包独立选择:同一批消息可能由不同机器人分别执行。
  • 权重不影响消息接收;只有一台机器人参与时权重没有实际作用。

设置项参考 ​

设置项取值与默认说明
机器人名称自定控制台展示用
渠道QQ / 微信 / Telegram档案选项;实际平台能力由实现端决定
机器人 ID必填QQ 渠道为机器人 QQ 号
Token必填档案口令字段;编辑时不回显,留空表示不修改
绑定连接可留空不绑定则不收发消息;一个机器人走一条连接
全局权重1–100,默认 100多机器人出站时按权重独立随机分配动作包
状态启用 / 禁用禁用后档案不参与任何处理

看懂列表 ​

列含义
状态启用 / 禁用——档案开关,禁用后不参与任何处理
在线状态离线 / 在线——实现端接入后才是在线
绑定连接已绑定的连接配置名;"未绑定"则不收发消息
全局权重参与多机器人出站分配的权重
群组 / 成员 / 消息该机器人接入后的统计(新机器人全为 0)

修改与删除 ​

  • 行内 操作 菜单:编辑资料、调整状态;删除前请确认它绑定的群设置已有替代安排。
  • 编辑时 Token 不回显原值,留空表示不修改,不要因为看到空框就重填或公开旧口令。需要更换时,再输入新值并核对相关连接配置。
  • 搜索栏支持按名称、渠道、状态筛选;勾选后可用 批量操作。

没成功先检查什么 ​

  • 表单提示"请输入机器人ID / 请输入机器人Token":这两项必填。
  • 机器人一直"离线":按三层依次核对——档案是否绑定连接、连接配置与实现端是否匹配、实现端程序是否在运行;见连接机器人和常见问题的连接链路。
  • 在线但群里没动作:在线只证明连接通了;检查群绑定、对应功能的开关与权限,再用应用日志与审计日志核对动作是否受理。

和其他页面的关系 ​

  • 单个群内排除某台机器人参与,见群资料的"机器人分配与归因"。
  • 连接配置与实现端接入见连接机器人。
  • 机器人账号对应的管理员等级(超级管理员、高管)在全局设置配置,等级模型见权限管理。