机器人管家 创建管理配置你的 BOT
机器人管家是什么
机器人管家是 Fanbook 内置的 BOT 管理工具。官方描述：「机器人管家是一个统治其它所有机器人的……」（原文如此，意思是它是管理其他 BOT 的 BOT / 工具）。
简单说，机器人管家就是创建、配置、管理所有 BOT 的控制台。无论是内置 BOT 还是自定义 BOT，都通过机器人管家来管理。
能做什么
| 功能 | 说明 |
|---|---|
| 创建新 BOT | 填写名称和描述，自动生成 Bot Token |
| 编辑 BOT 设置 | 修改名称、头像、描述等 |
| 设置隐私模式 | 控制 BOT 在频道中接收哪些消息 |
| 管理令牌 | 查看、重置 Bot Token |
| 频道命令列表 | 配置 BOT 在频道中的快捷命令和 @ 命令 |
| 查看 BOT 列表 | 列出你创建或管理的所有 BOT |
| 删除 BOT | 删除不再需要的 BOT（会吊销 Token） |
操作入口
机器人管家有两种访问方式：
App 内入口
服务器设置 → 应用管理 / 机器人 → 选择或添加 BOT
Bot 对话入口
在任意频道 @机器人管家 → 它会返回内联键盘，通过交互式界面管理 BOT（官方开发者文档里描述的命令列表方式）。
创建新 BOT 流程
标准流程
- 在机器人管家中选择「创建机器人」
- 填写 BOT 的名称和描述
- 系统自动为你生成 Bot Token
- 立即复制 Token 并保存——它只会显示一次，关掉窗口后需要重置
- 可选：上传 BOT 的头像
Token 安全须知
- Bot Token 是 BOT 的唯一授权凭证
- 任何持有 Token 的人都可以用它控制你的 BOT
- 不要把 Token 写进公开代码、分享到群聊或截图
- 建议存在环境变量或密码管理器里
重置 Token
如果怀疑 Token 泄露，在机器人管家中可以重置它。重置后旧 Token 立即失效，需要在你的代码里同步更新。
隐私模式配置
这是最容易被忽略但影响最大的设置。
两种模式
| 模式 | 行为 | 适用场景 |
|---|---|---|
| 开启（推荐） | BOT 只接收：被 @的消息、直接发给它的私聊、管理员配置的命令触发 | 绝大多数 BOT 场景 |
| 关闭 | BOT 接收频道里的所有消息 | 需要监听全频道消息的场景（如关键词自动回复、敏感词检测） |
为什么默认开启
关闭隐私模式会让 BOT 接收频道中的每一条消息，这带来几个问题：
- API 调用暴涨：每条消息都触发 BOT 的消息处理逻辑
- 服务器负载增加：如果你的 BOT 部署在自己的服务器上，要处理大量无关消息
- 性能问题：BOT 需要快速判断「这条消息我要不要处理」，否则会延迟响应真正需要处理的消息
建议： 默认开启隐私模式，只有在确实需要监听全频道消息时才关闭。
命令列表配置
频道机器人命令列表
用户在输入框中输入 @机器人名称 时，弹出的命令列表。适合展示 BOT 支持的所有命令。
频道快捷命令列表
常驻在聊天输入框上方的快捷按钮列表。管理员可以选择某个 BOT 的常用命令配置为快捷方式，成员一键点击就能执行。
推荐配置：
- 签到、查询积分、查看排行榜这类高频命令 → 设为快捷命令
- 其他命令 → 保留在 @机器人的命令列表里
BOT 权限配置
BOT 本身是一个独立账号，它的权限通过以下方式控制：
- 服务器角色：给 BOT 分配一个或多个角色，这些角色的权限就是 BOT 的权限
- 频道级权限：在特定频道里单独设置 BOT 的权限（比如公告频道只让 BOT 发定时消息）
- 所有者身份：如果你创建了 BOT，你是它的所有者，但这不会自动给它服务器里的权限
常见坑： BOT 无法在某个频道发消息——99% 是因为它在该频道没有 SEND_MESSAGES 权限，去频道设置里给它的角色勾上就行。
Bot API vs 机器人管家
| 场景 | 用什么 |
|---|---|
| 创建 BOT、获取 Token | 机器人管家 |
| 日常发消息、查频道、执行自动化 | Bot API（代码） |
| 配置隐私模式和命令列表 | 机器人管家 |
| 重置泄露的 Token | 机器人管家 |
| 把 BOT 加到某个频道 | 机器人管家或 App 内频道设置 |