WhatsApp 그룹 메시지 관리하기

단체 채팅방에 봇을 초대했을 때, 모든 메시지에 반응해서 채팅창을 도배하거나 개인적인 대화 내용을 그룹에 노출할까 봐 걱정된 적 있으시죠? 그룹 채팅의 맥락을 제대로 파악하지 못해 엉뚱한 대답을 하는 경우도 개발 과정에서 자주 겪는 문제입니다.

OpenClaw를 사용하면 에이전트가 WhatsApp 그룹 내에서 필요할 때만 깨어나고, 개인 DM과는 완전히 분리된 별도의 세션을 유지하도록 설정할 수 있습니다.

필요한 것

OpenClaw가 실행 중인 WhatsApp 계정
~/.openclaw/openclaw.json 설정 파일 수정 권한
에이전트를 추가할 WhatsApp 그룹 채팅방
에이전트의 E.164 형식 전화번호

빠른 시작

5분 안에 에이전트를 WhatsApp 그룹에 설정하는 방법입니다.

설정 파일 수정: ~/.openclaw/openclaw.json 파일에 groupChat 블록을 추가하세요. WhatsApp에서 멘션이 텍스트로 보이지 않는 경우를 대비해 mentionPatterns를 설정하는 것이 좋습니다.

{
  channels: {
    whatsapp: {
      groups: {
        "*": { requireMention: true },
      },
    },
  },
  agents: {
    list: [
      {
        id: "main",
        groupChat: {
          historyLimit: 50,
          mentionPatterns: ["@?openclaw", "\\+?15555550123"],
        },
      },
    ],
  },
}

그룹 초대: 에이전트가 실행 중인 WhatsApp 계정을 그룹 채팅에 추가하세요.
에이전트 호출: 그룹 내에서 @openclaw를 입력하거나 설정한 번호를 포함하여 메시지를 보내세요.
활성화 모드 변경: 그룹 내에서 소유자 번호로 /activation always 또는 /activation mention 명령어를 보내 동작 방식을 바꿀 수 있습니다.

문제 해결

에이전트가 응답하지 않나요?: channels.whatsapp.groupPolicy 설정을 확인하세요. 기본값이 allowlist이므로, channels.whatsapp.groupAllowFrom에 발신자를 추가하거나 정책을 open으로 변경해야 할 수 있습니다.
멘션 인식이 안 되나요?: WhatsApp이 텍스트 본문에서 시각적인 @ 기호를 제거하는 경우가 있습니다. 이럴 때는 mentionPatterns에 에이전트의 이름이나 전화번호를 정규표현식(regex)으로 등록했는지 확인해 보세요.

궁금한 점이 더 있다면 AI Setup Assistant를 통해 도움을 받을 수 있습니다.

다음 단계

OpenClaw Expert

아직 막혀 있나요?

이 문서에서 답을 못 찾았다면 OpenClaw Expert에게 바로 물어보세요.