Channels 导读

让 Clawd 在 WhatsApp 群里只被 @ 时才回应,且不干扰私聊

配置 `channels.whatsapp.groups` 和 `agents.list[].groupChat.mentionPatterns` 来定义触发规则;默认 `mention` 模式需要 @ 或匹配正则才唤醒。注意 `channels.whatsapp.groupPolicy` 默认是 `allowlist`,不添加发送者就会静默忽略所有群消息。

先讲这一页到底在解决什么

让 Clawd 在 WhatsApp 群里只被 @ 时才回应,且不干扰私聊

配置 `channels.whatsapp.groups` 和 `agents.list[].groupChat.mentionPatterns` 来定义触发规则;默认 `mention` 模式需要 @ 或匹配正则才唤醒。注意 `channels.whatsapp.groupPolicy` 默认是 `allowlist`,不添加发送者就会静默忽略所有群消息。

原文共 8 节,先看 Start Here 路径:/channels/group-messages 查看官方原文

第一站

😴 这页的核心不是“让它一直开口”,而是“让它会挑时机开口”

activation 的两个模式,读成性格就很好懂。

@

mention

像课堂上被点名才发言。默认最稳。

🗣️

always

像一直在认真听,但也不是每句话都要接,没必要时会选择沉默。

🤫

NO_REPLY

像它心里想了,但判断“现在不该插话”,于是安静坐回去。

🎈

一句话

群聊里最好的 OpenClaw,不是最话多的那个,而是最会挑时机的那个。

第二站

🧲 mention 检测其实是在看“有没有真的叫到我名字”

而且不只是 WhatsApp 原生 @,还可以靠模式匹配兜底。

✅ 原生 @ mention

这是最直接的点名方式,WhatsApp 会通过 mentionedJids 告诉 OpenClaw。

🔤 mentionPatterns

像额外准备一份“别人可能会怎么喊我”的小抄,比如昵称、号码。

mentionPatterns: [\"@?openclaw\", \"\\\\+?1555...\"]

像告诉它:看到这些叫法,也算是在喊我。

🎈 一句话

mentionPatterns 不是装饰,是群里“点名识别系统”的备用耳朵。

第三站

🪣 每个群单独一桶记忆,这件事很重要

因为你不希望家庭群和工作群互相串台。

👥 群有自己的 session key

像每个群有自己专属笔记本,群里的开关命令只影响这一本。

💬 私聊主桶不受影响

你在个人 DM 里的状态,不会因为群里一条 /think high 被改掉。

📝 pending-only context

没触发回答的群消息,会先被当成“旁听笔记”,以后回答时再塞给它当背景。

🎈 收尾一句

群聊不是“每条都答”,而是“很多先记着,等真被点名时再用上”。