5.22 群消息处理

本文档涵盖 WhatsApp 群组消息处理的以下内容：激活模式、群组策略、每群组会话、上下文注入、发送者显示、临时消息处理和系统提示。

激活模式

群组中的回复默认需要提及（mention）。可以通过以下方式配置：

• /activation mention - 需要 @提及
• /activation always - 自动回复所有消息
• /activation disabled - 禁用自动回复

群组策略

群组访问默认受限（groupPolicy: "allowlist"）。选项包括：

• "open" - 允许所有群组
• "disabled" - 禁用所有群组
• "allowlist" - 仅允许列表中的群组

配置示例

{
  channels: {
    whatsapp: {
      groupChat: {
        mentionPatterns: ["@openclaw", "openclaw"],
        requireMention: true
      }
    }
  },
  groups: {
    "*": {
      requireMention: true
    }
  }
}

会话键

群组使用特定的会话键格式：

agent:<agentId>:<channel>:<accountId>:group:<groupId>

Telegram 论坛主题添加 :topic:<topicId>

上下文字段

群组消息在上下文中包括：

• ChatType=group
• GroupSubject - 群组名称
• GroupMembers - 成员列表
• WasMentioned - 是否被提及

沙盒支持

沙盒允许：

• 主机上的直接消息
• Docker 中具有受限工具的群组

工具限制

可以针对每个群组或每个发送者应用工具限制。