群组聊天

OpenClaw 提供强大的群组聊天功能，具有安全控制、提及门控和灵活的激活模式。每个群组都有自己独立的会话，确保上下文分离和安全。

每个群组聊天都在自己的隔离会话中运行：

• 独立上下文 - 每个群组保持自己的对话历史
• 隔离内存 - 群组内存不会与私聊或其他群组混合
• 沙箱化执行 - 群组可以在 Docker 沙箱中运行以确保安全
• 独立配置 - 每个群组可以有不同的设置

控制 OpenClaw 可以访问哪些群组：

• 白名单模式 - 仅允许指定的群组访问
• 通配符支持 - 使用 "*" 允许所有群组
• 每渠道配置 - 每个消息平台都有不同的白名单

配置示例

{
  "channels": {
    "telegram": {
      "groups": {
        "123456789": {
          "requireMention": true
        },
        "*": {
          "requireMention": true,
          "activation": "mention"
        }
      }
    }
  }
}

提及门控要求 @提及 Bot 才会响应：

• 默认行为 - 仅在被提及期间响应 (推荐)
• 减少干扰 - 防止 Bot 对每条消息都做出响应
• 更好的 UX - 群组成员控制 Bot 介入的时机
• 可配置 - 可按群组禁用

提及模式

配置提及模式：

{
  "messages": {
    "groupChat": {
      "mentionPatterns": ["@openclaw", "@molty", "@bot"]
    }
  }
}

激活模式

• mention - 仅在被提及时响应 (默认，推荐)
• always - 响应所有消息 (谨慎使用)
• manual - 仅在被明确激活时响应

更改激活模式

群组所有者可以更改激活模式：

/activation mention
/activation always
/activation manual

群组具有额外的安全特性：

• 沙箱化 - 群组可以在隔离的 Docker 容器中运行
• 工具限制 - 默认限制工具访问
• 回复标签 - 正确的消息线程和回复处理
• 每渠道路由 - 将群组路由到不同的 Agent

沙箱配置

为群组启用沙箱化：

{
  "agents": {
    "defaults": {
      "sandbox": {
        "mode": "non-main"
      }
    }
  }
}

OpenClaw 处理群组消息的方式：

• 回复嵌套 - 正确的回复处理和线程嵌套
• 媒体支持 - 发送和接收图片、音频、文档
• 正在输入指示器 - 显示 Bot 正在处理
• 提及处理 - 正确处理 @提及和回复

每个消息平台都有自己的群组配置：

Telegram 群组

{
  "channels": {
    "telegram": {
      "groups": {
        "*": {
          "requireMention": true
        }
      }
    }
  }
}

Discord 服务器

{
  "channels": {
    "discord": {
      "guilds": {
        "123456789": {
          "channels": ["general", "support"]
        }
      }
    }
  }
}

• 1
  使用提及门控保持默认的仅限提及模式。
• 2
  配置白名单明确允许信任的群组。
• 3
  启用沙箱化为群组启用沙箱以确保安全。
• 4
  监控活动定期审查群组交互。
• 5
  设定明确期望让群组成员知道如何与 Bot 交互。