왜 지금 Discord 연동이 중요한가
OpenClaw를 텔레그램 개인 비서로만 쓰면 편하다. 그런데 팀이나 스터디, 운영진 채널처럼 여러 사람이 같이 있는 공간에 붙이면 쓰임새가 확 커진다. 공지 초안 정리, 질문 답변, 링크 요약, 작업 상태 확인 같은 일을 채팅 흐름 안에서 바로 처리할 수 있기 때문이다. 핵심은 봇처럼 튀지 않고, 필요한 순간에만 자연스럽게 반응하게 만드는 설정이다.
연동 전에 준비할 것
먼저 Discord Developer Portal에서 애플리케이션과 봇을 만든다. 서버에 초대할 때는 메시지 읽기와 보내기 권한이 필요하고, 일반 대화 문맥을 보려면 Message Content Intent도 켜야 한다. OpenClaw 쪽에는 Discord 봇 토큰과 서버, 채널 ID가 들어갈 자리가 있어야 한다.
openclaw config set channels.discord.token --ref-provider default --ref-source env --ref-id DISCORD_BOT_TOKEN토큰은 환경변수로 보관하는 쪽이 안전하다. 토큰을 평문으로 설정 파일에 박아두는 방식은 추천하지 않는다.
핵심 설정은 이렇게 잡는다
Discord 그룹에서 AI가 너무 자주 끼어들면 금방 시끄러워진다. 반대로 멘션이 있어야만 움직이게 하면 도우미 역할이 쉬워진다. 채널별로 반응 방식을 나누는 게 포인트다.
channels:
discord:
guilds:
"GUILD_ID":
channels:
"CHANNEL_ID":
requireMention: false위처럼 설정하면 해당 채널에서는 멘션 없이도 대화 맥락을 보고 답할 수 있다. 운영 공지 채널이나 실험용 채널에는 잘 맞는다. 반대로 일반 잡담방은 requireMention: true로 두는 편이 안전하다. 그러면 사용자가 봇을 직접 부를 때만 반응한다.
실무에서 바로 쓰는 운영 순서
1. 테스트 채널부터 붙인다
처음부터 서버 전체에 열지 말고 테스트 채널 하나만 잡는다. 질문 몇 개를 던져 보고, 답변 길이와 끼어드는 빈도를 먼저 본다. 이 단계에서 말투, 모델, 멘션 정책을 조정하면 본 채널에서 사고가 적다.
2. 재시작으로 설정을 반영한다
openclaw gateway restart
openclaw gateway status재시작 뒤 상태 확인까지 해야 끝이다. 연결은 됐는데 권한이 부족하거나 토큰이 틀리면 여기서 바로 걸린다.
3. 역할을 좁게 준다
AI 멤버가 잘하는 일은 회의 내용 요약, 이전 대화 정리, 링크 핵심 추출, 할 일 초안 작성이다. 반면 서버 관리 권한까지 넓게 줄 이유는 거의 없다. 초반에는 읽기와 쓰기, 스레드 참여 정도로 제한하는 편이 낫다.
주의할 점
- 공개 서버에서는 기본값을 멘션 필요로 두는 편이 안전하다.
- 봇 토큰은 절대 채팅이나 문서에 그대로 남기지 않는다.
- 중요한 개인정보가 오가는 채널은 접근 범위를 따로 분리한다.
- 처음부터 여러 채널에 동시에 붙이지 말고 한 채널에서 행동 패턴을 확인한다.
바로 해볼 것
- Discord 봇을 만든 뒤 테스트 서버에 초대한다.
- 봇 토큰은 환경변수에 넣고 위 명령으로 OpenClaw에 연결한다.
- 테스트 채널 하나에만
requireMention: false를 적용해 반응 방식을 확인한다. - 문제 없으면 일반 채널은 멘션 기반, 운영 채널은 상시 반응 방식으로 나눠 확장한다.
마무리
OpenClaw의 Discord 연동은 단순한 챗봇 추가가 아니다. 팀 채팅 안에 실행형 AI 멤버를 들이는 작업에 가깝다. 핵심은 많이 말하게 만드는 것이 아니라, 필요한 채널에서 필요한 방식으로 반응하게 설계하는 것이다. 이 원칙만 지키면 그룹 채팅에서도 AI가 꽤 쓸만한 동료가 된다.
참고자료
- OpenClaw 설정 키: channels.discord.token, guilds, requireMention
- Discord Developer Portal 봇 생성 및 권한 설정 문서