OpenClawCN 中文资料站开始 · 文档 · 进阶 · 动态 · 支持

参考

回复机器人消息也算 mention 吗,pending history 又什么时候会进上下文

基于最新官方 Groups 与 Group Messages 文档,解释 OpenClaw 在群聊里怎样把 reply metadata 当成隐式 mention,以及未触发回复的群消息何时只进入 pending history、何时会被彻底丢弃。

最后更新2026-03-29
内容来源OpenClaw Docs
来源类型official

AI 摘要

这页重点

核心结论

基于最新官方 Groups 与 Group Messages 文档,解释 OpenClaw 在群聊里怎样把 reply metadata 当成隐式 mention,以及未触发回复的群消息何时只进入 pending history、何时会被彻底丢弃。

适用主题

参考

高频关键词

groups / mentions / pending-history / reply / reference

可信信号

最后更新 2026-03-29来源 OpenClaw Docs

回复机器人消息也算 mention 吗,pending history 又什么时候会进上下文

群聊里最容易让人困惑的一类现象是:

  • 明明没有 @
  • 机器人却回了

或者反过来:

  • 明明没回
  • 但后面像是“记住了”前面的群消息

最新官方 GroupsGroup Messages 文档,其实已经把这两件事拆得更清楚了。

第一层:reply metadata 也能算隐式 mention

官方当前明确写到:

  • Replying to a bot message counts as an implicit mention

这意味着在支持 reply metadata 的渠道里,下面两种情况可能都会触发:

  • 真正的 @mention
  • 回复机器人上一条消息

所以“没写 @ 也触发了”不一定是配置过宽,可能只是:

  • 渠道把 reply 关系正确传进来了

第二层:没有正式唤起,不等于完全没进系统

官方现在也把另一件事写得很直白:

  • 被 mention gating 挡住的消息,可能 still store for context only

也就是:

  • 它不触发 agent run
  • 但可能进入 pending-only history buffer

这也是很多人后面会觉得“它是不是偷听了群聊”的来源。
更准确的理解是:

  • 它没有正式回复
  • 但保留了有限上下文,供下一次真正触发时注入

哪些消息会彻底丢掉

更早被挡住的消息,官方当前是按前序规则直接 drop:

  • groupPolicy = "disabled"
  • groupPolicy = "allowlist" 但群不在 allowlist
  • sender 不满足当前 group allowlist / groupAllowFrom

这类消息不会走到 pending history 那一层。

pending history 真正要解决什么

它的价值不是“偷偷攒更多上下文”,而是:

  • 当群里隔了一段讨论后终于有人正式唤起机器人
  • 机器人不至于只看到最后一句话

所以它更像:

  • 触发前的有限上下文缓冲

而不是:

  • 正式 session 历史本身

这和 session 里的群历史不是一回事

一旦某条消息真正触发了运行,后续看到的上下文来源就可能同时包括:

  • 当前 group session 历史
  • pending group history
  • 当前触发消息

所以别把“pending buffer”误解成完整 session store。

对排障最有价值的判断顺序

如果你现在遇到的是“为什么这条群消息没回 / 却像被看到过”,更稳的判断顺序通常是:

  1. 先看它有没有被 groupPolicy 或 allowlist 挡掉
  2. 再看它是不是没满足 mention / reply 触发
  3. 最后才判断它是不是只进了 pending history

推荐延伸阅读

继续阅读

把文档串成一条阅读路径

如果你正在系统理解 OpenClaw,优先沿着文档顺序继续看;如果只是查某个点,也可以跳回文档中心按分类选择。

关联入口

同主题、同路径、同阶段