机器人管理
这篇帮你做什么:管理你的机器人档案——创建、改资料、绑定连接配置、看它在不在线。入口:仪表盘 → 机器人管理(与"控制台""连接配置"是同一层级的平级菜单,不存在额外的"控制台"子菜单层级)。
机器人账号、连接与在线:三件事不要混在一起
控制台里一个"机器人"由三层东西组成,排查问题前先分清你在看哪一层:
- 机器人档案(本页管理):控制台里的一条记录——名称、渠道、机器人 ID、Token、权重、启用状态。它只是档案,创建档案不会让任何账号上线。
- 连接配置:机器人与群管家之间的协议接入通道(地址、Access Token、反向 WebSocket 等),在 连接配置 页维护。档案必须绑定一条连接,消息才有收发的路;"未绑定"的机器人不收发消息。
- 平台账号与实现端:QQ 号本身和把它接入协议的实现端程序(如 OneBot 实现端)。这一层由你另行部署和维护,群管家不自带各平台的客户端。
在线状态表示该档案对应的实现端当前是否通过连接接入了群管家:实现端接入后才显示"在线",断开、未部署或未绑定连接都是"离线"。启用≠在线——启用只是让档案参与调度;新建的机器人显示"离线"是正常的。反过来,在线也不代表业务已配置:群绑定、监控开关、指令权限都在各自页面单独配置。机器人、连接、群与配置的整体关系另见群管家怎样工作。
添加机器人
- 点 添加机器人,填写四项必填:机器人名称(便于识别)、渠道(界面提供 QQ / 微信 / Telegram)、机器人 ID(QQ 渠道填写机器人 QQ 号)、Token(机器人档案要求的口令字段)。渠道是档案上的选项,不代表本软件自带相应平台客户端;实际可用性取决于你部署的实现端。通信鉴权还要核对连接配置的 Access Token 与实现端设置,见连接机器人。
- 绑定连接配置:选择这条机器人走哪条连接(可先留空,之后回来绑定,见连接机器人)。
- 全局权重:默认 100。只用一个机器人时保持默认即可;多机器人的分配方式见下文。
- 点 确认,提示"机器人创建成功"。
全局权重是怎么用的
当同一个群有多台参与、具备所需能力与权限且在线的机器人时,每个完整的群出站动作包(一次踢人、一次回复等)都会按各机器人的全局权重独立随机选择一台执行。
- 这不是固定比例轮询:权重 80 和 20 的两台机器人不等于"每 5 次恰好 4 比 1",长期统计上才接近权重比。
- 每个动作包独立选择:同一批消息可能由不同机器人分别执行。
- 权重不影响消息接收;只有一台机器人参与时权重没有实际作用。
设置项参考
| 设置项 | 取值与默认 | 说明 |
|---|---|---|
| 机器人名称 | 自定 | 控制台展示用 |
| 渠道 | QQ / 微信 / Telegram | 档案选项;实际平台能力由实现端决定 |
| 机器人 ID | 必填 | QQ 渠道为机器人 QQ 号 |
| Token | 必填 | 档案口令字段;编辑时不回显,留空表示不修改 |
| 绑定连接 | 可留空 | 不绑定则不收发消息;一个机器人走一条连接 |
| 全局权重 | 1–100,默认 100 | 多机器人出站时按权重独立随机分配动作包 |
| 状态 | 启用 / 禁用 | 禁用后档案不参与任何处理 |
看懂列表
| 列 | 含义 |
|---|---|
| 状态 | 启用 / 禁用——档案开关,禁用后不参与任何处理 |
| 在线状态 | 离线 / 在线——实现端接入后才是在线 |
| 绑定连接 | 已绑定的连接配置名;"未绑定"则不收发消息 |
| 全局权重 | 参与多机器人出站分配的权重 |
| 群组 / 成员 / 消息 | 该机器人接入后的统计(新机器人全为 0) |
修改与删除
- 行内 操作 菜单:编辑资料、调整状态;删除前请确认它绑定的群设置已有替代安排。
- 编辑时 Token 不回显原值,留空表示不修改,不要因为看到空框就重填或公开旧口令。需要更换时,再输入新值并核对相关连接配置。
- 搜索栏支持按名称、渠道、状态筛选;勾选后可用 批量操作。
没成功先检查什么
- 表单提示"请输入机器人ID / 请输入机器人Token":这两项必填。
- 机器人一直"离线":按三层依次核对——档案是否绑定连接、连接配置与实现端是否匹配、实现端程序是否在运行;见连接机器人和常见问题的连接链路。
- 在线但群里没动作:在线只证明连接通了;检查群绑定、对应功能的开关与权限,再用应用日志与审计日志核对动作是否受理。