DooTask 机器人入口完全指南:应用面板、我的机器人抽屉与系统机器人会话定位
DooTask 机器人入口完全指南:应用面板、我的机器人抽屉与系统机器人会话定位
DooTask 的机器人功能统一收纳在「应用」面板的「我的机器人」卡片中,本文以 机器人入口 menu-map 文档 为核心,完整讲解桌面端 Web / Electron、移动端三条入口路径,以及「添加机器人」「与系统机器人聊天」「权限边界」等操作细节,并结合 UserBot 模型、UsersController 机器人接口 等源码说明背后的权限校验与数据模型。读完本文,你将能准确找到机器人管理入口、快速定位任意系统机器人单聊,并理解「哪些机器人能改、哪些不能删、为什么报错」背后的判断逻辑。
一、机器人入口总览:三条路径 + 一个指令入口
DooTask 的机器人没有独立的顶部主导航标签,所有入口都围绕「应用」面板与「消息」列表展开。根据 entry.md,入口路径共四条:
| 场景 | 路径 | 说明 |
|---|---|---|
| 桌面端 Web | 左侧栏「应用」→「我的机器人」卡片 | 打开右侧 720px 宽抽屉,列出自建机器人,可「开始聊天 / 修改 / 删除」 |
| 桌面端 Electron | 同 Web | 桌面客户端与 Web 端入口一致 |
| 移动端 | 底部 Tabbar「应用」→「我的机器人」卡片 | 同一功能,移动布局 |
| 指令入口 | 与「机器人管理」(bot-manager@bot.system)单聊中发 /list |
直接看到当前账号拥有的机器人列表 |
一个常见误区是去顶部主导航找「机器人」标签——它并不存在(见 entry.md 的 negative 声明)。机器人相关能力分属两个系统应用:mybot(我的机器人,自建机器人管理)与 bot-manager(机器人管理,斜杠指令控制台),后者的卡片/会话入口同样在「应用」与「消息」体系内。
从 系统应用清单 可以看到 mybot 被归类为"系统应用",即所有登录用户可见的固定功能,不需要管理员安装。
二、「我的机器人」抽屉:能做什么
点开「应用」→「我的机器人」后,右侧会滑出 720px 宽的抽屉面板。抽屉承担三类操作(见 app-system.bot.howto):
- 查看列表:列出当前用户创建的所有机器人;若没有则提示「您没有创建机器人」。
- 逐条操作:每条机器人提供「开始聊天」「修改」「删除」三个按钮:
- 「开始聊天」直接进入与该机器人的私聊会话;
- 「修改」打开编辑表单(与新建共用同一套表单);
- 「删除」要求输入删除备注(≤ 255 字符)。
- 新建:抽屉右上角「添加机器人」按钮弹出创建表单。
抽屉背后:bot__list 接口
抽屉列表的数据来自后端接口 api/users/bot/list(bot__list),其实现位于 UsersController.php。关键逻辑是:用 users 与 user_bots 表按 user_bots.userid = 当前用户 连表查询,只返回本人创建的机器人(bot=1 且 user_bots.bot_id = users.userid),并按创建时间倒序。返回字段包括 userid、nickname、userimg、clear_day、webhook_url、webhook_events,同时通过 UserBot::normalizeWebhookEvents 对事件配置做标准化。
值得注意的是,系统机器人的 bot__list 结果也由 systemBotName 附带标注 system_name,但抽屉列表本身只展示自建机器人——这正是原文档强调的"系统机器人不会出现在「我的机器人」列表里"的源码佐证。
三、添加与编辑机器人:表单字段与后端校验
「我的机器人」抽屉右上角的「添加机器人」与已有机器人条目的「修改」共用同一份编辑表单,提交到后端接口 api/users/bot/edit(bot__edit,见 UsersController.php)。字段说明如下:
| 字段 | 必填 | 说明 | 后端校验(源码依据) |
|---|---|---|---|
name |
是 | 机器人昵称,2-20 字符 | UserBot::newBot 校验长度,超限报「机器人名称由2-20个字符组成」(UserBot.php) |
avatar |
否 | 头像 URL;留空用默认 | bot__edit 中 Base::unFillUrl 归一化,avatar/ 内置头像会被置空 |
session |
否 | 0/1,是否开启「新会话/历史会话」菜单 | 仅在添加时生效,创建后不可改(需重建);开启后 webhook 的 message 事件会多带 session_id |
clear_day |
否 | 消息保留天数,1-999,默认 90 | bot__edit 中 min(max(intval, 1), 999) 强制钳制范围 |
webhook_url |
否 | http(s):// 开头,≤ 255 字符 |
shouldDispatchWebhook 用 preg_match('/^https?:\/\//') 校验协议头(UserBot.php) |
webhook_events |
否 | 事件列表 | normalizeWebhookEvents 只保留白名单事件,空列表默认回退为 <a href="https://link.gitcode.com/i/8ff05c48c22ccb183d8ffc5df6612167" target="_blank">message]([UserBot.php) |
数量上限与名称校验的源码依据
创建机器人走 UserBot::newBot(UserBot.php):
- 每用户最多 50 个:先连表统计
users.bot = 1 AND user_bots.userid = 当前用户的条数,达到 50 直接返回「超过最大创建数量」; - 名称必须 2-20 字符;
- 创建成功后自动建立与主人的私聊会话(
WebSocketDialog::checkUserDialog),若开启session还会创建WebSocketDialogSession并回填session_id; - 机器人的邮箱形如
user-normal-xxx@bot.system或user-session-xxx@bot.system(随机后缀),可据此判断自建机器人类型。
创建后可以做什么
- 在「我的机器人」列表点「开始聊天」进入单聊;
- 将机器人邀请进群(详见 bot/invite.md);
- 在「机器人管理」单聊发
/token <bot_id>取 token,/revoke重置凭证; - 删除机器人时需填备注(≤ 255 字符),系统机器人删除会直接报错(见下文权限部分)。
四、与系统机器人聊天:在「消息」列表搜索定位
内置系统机器人(任务提醒、审批、AI 等)不需要手动添加,默认会自动出现在「消息」列表——因为它们本质是 bot=1 的特殊 User 账号,每个机器人与每个用户之间独立建立单聊会话(bot_type=system-msg / task-alert / todo-alert 等,见 messenger/bot.md)。
定位方式:
- 桌面端:左侧栏「消息」→ 在搜索框输入机器人名(如「任务提醒」「Claude」)即可定位单聊;
- 移动端:底部「消息」Tab 同样可搜索。
系统机器人清单与依赖
系统机器人名单写死在 UserBot::systemBotName(UserBot.php),邮箱统一以 @bot.system 结尾,普通用户不能创建或删除。常见几类(完整清单见 bot/system-list.md):
- 通知类:
system-msg(系统消息)、task-alert(任务提醒)、todo-alert(待办提醒)、meeting-alert(会议通知,需会议插件)、approval-alert(审批,需审批插件)、okr-alert(OKR 提醒,需 OKR 插件); - 互动办公类:
check-in(签到打卡,支持手动/定位/MAC/人脸)、anon-msg(匿名消息)、bot-manager(机器人管理,识别/list/newbot等斜杠指令); - AI 对话类:
ai-openai(ChatGPT)、ai-claude(Claude)、ai-deepseek(DeepSeek)、ai-gemini(Gemini)、ai-grok(Grok)、ai-ollama(Ollama)、ai-zhipu(智谱清言)、ai-qianwen(通义千问)、ai-wenxin(文心一言)等,均需在「系统设置 → AI 设置」填 API Key 后启用,否则报「机器人未启用」。
从源码看,这些机器人的头像映射也内置在 User.php 的机器人头像逻辑(default_ai.png、default_bot.png 等),进一步印证"系统机器人由系统创建并维护"。
指令入口:bot-manager 与 /list
除了 UI 面板,还可以在与「机器人管理」(bot-manager@bot.system)的单聊中直接发 /list 查看自己的机器人列表。该指令的处理实现在 BotReceiveMsgTask.php:按 user_bots.userid = 当前用户 连表查询最多 50 条机器人记录;若列表为空回复「您没有创建机器人」。该任务还支持 /hello、/info、/newbot、/setname、/deletebot 等指令(BotReceiveMsgTask.php),并且只有 bot-manager@bot.system 才允许 /list 与 /newbot(BotReceiveMsgTask.php)。
五、权限要求:所有权 + 类型的双层校验
机器人的所有写操作都由后端按「所有权 + 类型」硬性校验,前端隐藏按钮不等于绕过校验(见 faq/bot/permission.md):
- 创建:任何登录用户都能创建自建机器人,但单个账号最多 50 个,超出报「超过最大创建数量」;
- 修改系统机器人:仅
userIsAdmin(系统管理员)可改昵称/头像,普通成员报「权限不足」; - 删除系统机器人:任何人都不能删,后端直接返回「系统机器人不能删除」;
- 操作他人自建机器人:非主人报「不是你的机器人」。
这三条规则在 bot__info、bot__edit、bot__delete 中完全一致地实现(UsersController.php):
- 先查
users.bot = 1的机器人账号; - 再查
user_bots表确认当前用户是否是该机器人的主人; - 若查不到归属记录,则通过
UserBot::systemBotName($botUser->email)判断是否系统机器人:是系统机器人则要求管理员权限(修改时),删除时直接拒绝;否则一律报「不是你的机器人」。
此外,删除接口还强制要求填写备注(为空报「请输入删除备注」,超过 255 字符报「删除备注长度限制255个字」),且机器人删除会通过 deleteUser 同时清理关联会话。
六、边界与不支持项
原文档明确列出以下不支持的能力,使用时需注意:
- 没有「机器人广场 / 公共机器人市场」:机器人只能自建或用内置,不存在第三方共享市场入口;
- 没有独立的机器人快捷键:只能从「应用」面板进入,没有全局快捷键直达(参见 menu-navigation/bot-mgmt.md 的"快捷键:无");
- 系统机器人不出现在「我的机器人」列表:只能在「消息」列表搜索定位;
- 延伸边界(来自 bot/overview.md):机器人之间不会互相触发(避免死循环);系统机器人不能由普通用户删除;单个用户自建机器人上限 50 个。
七、本文涉及文档与源码速查
- 入口定位:resources/ai-kb/zh/menu-map/bot/entry.md、resources/ai-kb/zh/menu-map/menu-navigation/bot-mgmt.md
- 概念与清单:resources/ai-kb/zh/concept/bot/overview.md、resources/ai-kb/zh/concept/bot/system-list.md、resources/ai-kb/zh/concept/bot/webhook.md
- 实操教程:resources/ai-kb/zh/howto/apps/system-apps/bot.md、resources/ai-kb/zh/howto/bot/create.md、resources/ai-kb/zh/howto/bot/mention.md、resources/ai-kb/zh/howto/bot/invite.md
- 权限 FAQ:resources/ai-kb/zh/faq/bot/permission.md
- 源码:app/Models/UserBot.php、app/Http/Controllers/Api/UsersController.php、app/Tasks/BotReceiveMsgTask.php、app/Models/User.php
总结:找到 DooTask 机器人的关键就一句话——自建机器人在「应用」面板管理,系统机器人在「消息」列表搜索;理解了 user_bots 归属表与 @bot.system 邮箱约定,就能准确预判每一个「能不能改 / 能不能删 / 报什么错」的边界行为。