群组聊天

OpenClaw 支持在群聊环境中与智能体交互，提供灵活的配置选项。

核心概念

会话键

群组消息使用独立的会话键：

• 格式：agent:<agentId>:<channel>:group:<groupId>
• 示例：agent:main:whatsapp:group:120363403215116621@g.us

群组策略

控制 OpenClaw 如何响应群组消息：

{
  channels: {
    whatsapp: {
      groupPolicy: "allowlist",  // open | allowlist | disabled
      groupAllowFrom: ["+15551234567"]
    }
  }
}

激活模式

控制何时响应群组消息：

• mention（默认）：需要 @提及或匹配正则表达式
• always：始终响应

配置：

{
  channels: {
    whatsapp: {
      groups: {
        "*": { requireMention: true },
        "120363403215116621@g.us": { requireMention: false }
      }
    }
  }
}

提及模式

使用正则表达式定义提及触发器：

{
  agents: {
    list: [
      {
        id: "main",
        groupChat: {
          mentionPatterns: ["@clawd", "@openclaw", "reisponde"]
        }
      }
    ]
  }
}

群组历史上下文

OpenClaw 可以将最近的群组消息作为上下文注入：

{
  messages: {
    groupChat: { historyLimit: 50 }
  }
}

权限控制

群组允许列表

{
  channels: {
    whatsapp: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["+15551234567"]
    }
  }
}

管理员限制

某些操作仅限于群组管理员：

• 修改群组设置
• 禁用/启用智能体
• 访问管理功能

支持的平台

平台	状态	备注
WhatsApp	✅ 支持	需要关联设备
Telegram	✅ 支持	Bot API 支持
Discord	✅ 支持	服务器/频道
Slack	✅ 支持	工作区/频道
iMessage	✅ 支持	macOS 原生

相关文档

• 通道配置 - 通道详情
• 消息概念 - 消息处理
• 网关配置 - 完整配置选项