---
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 自己判断）