54 lines
2.2 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
id: bot.mention.howto
title: 怎么 @ 机器人触发
type: howto
feature: bot
scope: end-user
locale: zh
aliases:
- "@机器人"
- at 机器人
- 怎么让机器人回复
- 群里机器人不回我
- 触发机器人
- 召唤机器人
related_tools: []
related_pages: [messenger]
prerequisites:
- 机器人已在群里([[bot.invite.howto]])或你在和它的单聊中
negative:
- "群聊里不 @ 机器人则机器人不回复(避免噪音)"
- "@所有人 不算 @ 机器人,机器人不会响应「@所有人」"
- 机器人之间互相发的消息会被忽略,避免循环
- 单聊里发 `/...` 斜杠开头的指令,只有系统机器人才识别;自建机器人会直接忽略
last_verified: 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 自己判断)