Groups

OpenClaw는 WhatsApp, Telegram, Discord, Slack, Signal, iMessage, Microsoft Teams의 표면 전반에 걸쳐 그룹 채팅을 일관되게 처리합니다.

초보자 소개 (2분)

OpenClaw는 사용자 자신의 메시징 계정에 "존재"합니다. 별도의 WhatsApp bot 사용자가 없습니다. 사용자가 그룹에 있으면 OpenClaw는 해당 그룹을 보고 응답할 수 있습니다.

기본 동작:

  • 그룹은 제한됩니다 (groupPolicy: "allowlist").
  • 답장은 mention 게이팅을 명시적으로 비활성화하지 않는 한 mention이 필요합니다.

번역: allowlist 발신자는 mention하여 OpenClaw를 트리거할 수 있습니다.

TL;DR

  • DM 액세스는 *.allowFrom에 의해 제어됩니다.
  • 그룹 액세스는 *.groupPolicy + allowlist (*.groups, *.groupAllowFrom)에 의해 제어됩니다.
  • 답장 트리거는 mention 게이팅 (requireMention, /activation)에 의해 제어됩니다.

빠른 플로우 (그룹 메시지에 발생하는 일):

groupPolicy? disabled -> drop
groupPolicy? allowlist -> group allowed? no -> drop
requireMention? yes -> mentioned? no -> store for context only
otherwise -> reply

Group message flow

원하는 경우...

목표설정할 것
모든 그룹을 허용하지만 @mention에만 답장groups: { "*": { requireMention: true } }
모든 그룹 답장 비활성화groupPolicy: "disabled"
특정 그룹만groups: { "<group-id>": { ... } } ("*" key 없음)
그룹에서 사용자만 트리거 가능groupPolicy: "allowlist", groupAllowFrom: ["+1555..."]

Session key

  • 그룹 session은 agent:<agentId>:<channel>:group:<id> session key를 사용합니다 (room/channel은 agent:<agentId>:<channel>:channel:<id> 사용).
  • Telegram 포럼 토픽은 그룹 id에 :topic:<threadId>를 추가하여 각 토픽이 자체 session을 갖습니다.
  • 직접 채팅은 main session을 사용합니다 (또는 구성된 경우 발신자당).
  • Heartbeat은 그룹 session에서 건너뜁니다.

나머지 상세 내용은 영문 원본을 참조하세요 (전체 문서는 매우 길며 그룹 policy, mention 게이팅, tool 제한, session 저장소, 채널별 세부 정보 등을 다룹니다).

← 문서로 돌아가기