> 规范网页：https://docs.tensuu.com/功能模块详解/19_机器人管理.html ｜ Markdown：/功能模块详解/19_机器人管理.md ｜ 文档修订：2026.10.26

# 机器人管理

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

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

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

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

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

## 添加机器人

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

## 全局权重是怎么用的

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

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

## 设置项参考

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

## 看懂列表

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

## 修改与删除

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

## 没成功先检查什么

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

## 和其他页面的关系

- 单个群内排除某台机器人参与，见[群资料](18_群资料管理.md)的"机器人分配与归因"。
- 连接配置与实现端接入见[连接机器人](../快速入门指南/连接机器人.md)。
- 机器人账号对应的管理员等级（超级管理员、高管）在[全局设置](01_全局设置.md)配置，等级模型见[权限管理](../高级功能/权限管理.md)。