dootask/resources/ai-kb/zh/howto/bot/mention.md

id, title, type, feature, scope, locale, aliases, related_tools, related_pages, prerequisites, negative, last_verified

id	title	type	feature	scope	locale	aliases	related_tools	related_pages	prerequisites	negative	last_verified
bot.mention.howto	怎么 @ 机器人触发	howto	bot	end-user	zh	@机器人 at 机器人 怎么让机器人回复 群里机器人不回我 触发机器人 召唤机器人		messenger	机器人已在群里（bot.invite.howto）或你在和它的单聊中	群聊里不 @ 机器人则机器人不回复（避免噪音） @所有人 不算 @ 机器人，机器人不会响应「@所有人」 机器人之间互相发的消息会被忽略，避免循环 单聊里发 `/...` 斜杠开头的指令，只有系统机器人才识别；自建机器人会直接忽略	v1.7.90

怎么 @ 机器人触发

单聊 vs 群聊

• 单聊：直接发任意消息即可触发；AI 机器人会回复内容，签到/隐私机器人按指令处理，自建机器人通过 webhook 转给外部
• 群聊：必须 @ 机器人才会触发，否则机器人当作背景消息只看不回

怎么 @

• 桌面端：输入框输入 @，弹出成员候选，输入机器人名前几个字 → 回车选中 → 继续输入你的问题 → 发送
• 移动端：同样在输入框打 @ 弹出候选；或长按机器人头像选「@TA」
• 引用回复机器人的某条消息也算交互（会作为 reply_text 上下文）

AI 机器人额外规则

• 群聊里 AI 机器人会把当前对话最近 15 条记录作为上下文带给模型
• 群聊会自动 before_clear = 1 清掉旧上下文，避免跨群污染
• 模型名可在「选择模型」菜单里临时切换，或在消息里用 模型名 - thinking 触发思考模式

不响应的情况

• 没 @ 机器人（群聊）
• 只 @ 了「所有人」
• 客户端版本过低（AI 机器人要求 ≥ v0.41.11）
• AI 机器人未配置 API Key（报「机器人未启用」）
• AI 插件没装（报「应用『AI Assistant』未安装」）
• 用户自建机器人收到 /... 开头的指令

不支持

• 不支持「@机器人 + 私聊式不可见」，群里 @ 一定全员可见
• 不支持给机器人设「关键词触发」（需自建机器人 + webhook 自己判断）