OpenClaw를 단체방에 넣기 전｜허용 목록·멘션·대화 맥락을 구분하는 법

OpenClaw를 단체방에 연결할 때는 “답을 얼마나 자주 하게 할까?”보다 어느 방을 받을지, 누가 요청할지, 언제 답할지를 나누어 정하는 일이 먼저입니다.

이 글은 OpenClaw 공식 Groups 문서를 바탕으로 단체 대화의 기본 동작을 한국어로 풀어 쓴 안내입니다. 실제 설정 키와 지원 범위는 채널과 버전에 따라 다를 수 있으므로 적용 전에는 공식 문서를 다시 확인하세요.

1. 단체방 설정에는 세 개의 문이 있습니다

공식 문서는 그룹 메시지를 처리할 때 그룹 정책, 그룹·보낸 사람 허용 목록, 멘션 조건을 구분합니다. 그룹 정책은 단체 대화를 아예 받을지 정합니다. 허용 목록은 어떤 방 또는 어떤 보낸 사람이 요청할 수 있는지 정합니다. 멘션 조건은 허용된 방에서 매 메시지마다 반응할지, @멘션·답글·인용 같은 호출 신호가 있을 때만 반응할지 정합니다.

따라서 허용 목록에 넣었다고 모든 대화에 답하는 것은 아닙니다. 처음에는 멘션이 있어야 응답하도록 두고, 필요한 방만 별도로 조정하는 편이 예측하기 쉽습니다.

2. 처음에는 허용 목록과 멘션을 함께 켜 둡니다

OpenClaw 공식 문서에서 기본 그룹 정책은 허용 목록 방식입니다. 허용 목록이 비어 있으면 그룹 메시지는 차단됩니다. 이는 초대된 모든 단체방에서 곧바로 동작하는 것을 막는 출발점입니다.

그 다음에는 허용한 방에서도 멘션을 요구하는 구성을 생각해 볼 수 있습니다. 일상 대화가 계속 실행 요청으로 바뀌지 않고, 필요한 사람이 이름을 부르거나 지원되는 채널의 답글·인용으로 명확히 요청할 때만 반응합니다. 특정 운영방처럼 모든 메시지를 처리해야 할 이유가 있는 경우에만 그 방의 멘션 조건을 완화하는 것이 좋습니다.

3. DM 승인과 단체방 승인은 별개입니다

개인 DM을 위한 페어링 또는 보낸 사람 승인은 단체방 권한을 자동으로 열어 주지 않습니다. 공식 문서는 그룹의 보낸 사람 권한을 그룹용 허용 목록으로 명시적으로 설정해야 한다고 설명합니다. 개인 대화에서 승인한 사람이 있다는 사실만으로, 그 사람이 있는 모든 단체방에서 에이전트를 실행할 수 있다고 가정하면 안 됩니다.

페어링의 의미가 궁금하다면 OpenClaw 페어링이란? 낯선 DM·새 기기를 승인하기 전에 확인할 점을 먼저 읽어 보세요. 이 글은 그 다음 단계인 단체 대화 권한에만 초점을 맞춥니다.

4. 단체방은 기본적으로 개인 DM과 다른 대화 맥락을 씁니다

기본 설정에서 그룹 대화는 채널과 그룹별 세션 키를 사용합니다. 개인 DM의 주 세션과 단체방의 맥락이 무심코 섞이는 일을 줄이기 위한 구조입니다. 신뢰할 수 있는 특정 방을 주 세션과 공유하도록 바꾸는 설정도 있지만, 공식 문서는 신뢰하지 않는 공개 방을 주 세션에 합치지 말 것을 경고합니다.

허용 목록은 “누가 실행을 시작할 수 있는가”를 판단하는 장치이고, 인용문·답글·과거 메시지처럼 모델에 보조로 들어가는 맥락을 모두 숨기는 장치는 아닙니다. 그런 맥락도 제한해야 한다면 채널의 contextVisibility 정책을 검토해야 합니다.

단체방 연결 전 체크리스트

• ☐ 연결할 그룹을 먼저 좁혔다.
• ☐ 그룹 정책·허용 목록·멘션 조건을 구분했다.
• ☐ 처음에는 멘션이 있을 때만 반응하도록 두었다.
• ☐ DM 페어링이 그룹 권한까지 열지 않는다는 점을 확인했다.
• ☐ 개인 DM과 단체방의 세션 범위를 섞지 않았다.

참고한 공식 문서

• OpenClaw Docs, Groups

이 글은 OpenClaw 공식 문서를 바탕으로 정리한 설명입니다. 특정 단체방에서의 실제 운영 결과나 개인적인 사용 경험을 뜻하지 않으며, 실제 설정 전에는 사용 중인 버전과 채널의 공식 문서를 확인하세요.