Skip to content

Discord 봇 설정

Claw Buff AI 에이전트를 Discord에 연결하는 단계별 가이드

Claw Buff AI 에이전트를 Discord 서버에 연결해 보세요. 봇이 DM과 채널 메시지에 응답할 수 있어요. 설정은 약 10분이면 완료됩니다.

사전 준비

  • Discord 계정
  • 서버 관리 권한이 있는 Discord 서버
  • 배포된 Claw Buff 에이전트 (시작하기)

1단계: Discord 애플리케이션 만들기

개발자 포털 열기

Discord 개발자 포털로 이동하여 New Application을 클릭하세요. 이름을 지정해 주세요 (예: "My AI Agent").

봇 생성하기

사이드바에서 Bot을 클릭하세요. 원하는 경우 봇의 사용자 이름과 아바타를 설정할 수 있어요.

Message Content Intent 활성화하기

아래로 스크롤하여 Privileged Gateway Intents에서 다음을 활성화하세요:

  • Message Content Intent — 메시지 읽기에 필수
  • Server Members Intent — 역할 기반 접근에 권장

Save Changes를 클릭하세요.

봇 토큰 복사하기

Reset Token (또는 표시되면 Copy)을 클릭하여 봇 토큰을 받으세요. 저장해 두세요 — 다음에 필요해요.

봇 토큰은 비밀 정보예요. 절대로 공개적으로 공유하지 마세요. 토큰이 노출되었다면 개발자 포털에서 즉시 재설정하세요.

2단계: 서버에 봇 초대하기

초대 링크 생성하기

개발자 포털 사이드바에서 OAuth2 → URL Generator를 클릭하세요.

다음 스코프를 선택하세요:

  • bot
  • applications.commands

그리고 다음 봇 권한을 선택하세요:

  • View Channels
  • Send Messages
  • Read Message History
  • Embed Links
  • Attach Files

봇 초대하기

생성된 URL을 복사하여 브라우저에서 열어 주세요. 봇을 추가할 서버를 선택하고 Authorize를 클릭하세요.

3단계: Claw Buff에 연결하기

  1. Claw Buff 콘솔 → 채널 페이지를 여세요
  2. Discord 카드를 찾고 연결을 클릭하세요
  3. 1단계에서 받은 봇 토큰을 붙여넣으세요
  4. 저장 및 활성화를 클릭하세요

몇 초 안에 봇이 온라인 상태가 돼요.

4단계: 계정 페어링하기

봇이 응답하려면 먼저 Discord 계정을 페어링해야 해요:

  1. 봇에게 DM 보내기 — 서버 멤버 목록에서 봇 이름을 클릭하고 아무 메시지나 보내세요 (예: "hello")
  2. 봇이 페어링 코드를 회신해요 (예: X7QTGBD4)
  3. Claw Buff 콘솔 → 채널 페이지로 이동하세요
  4. 대기 중인 페어링 요청 섹션에서 해당 코드 옆의 승인을 클릭하세요

승인이 완료되면 봇이 DM에 즉시 응답해요.

5단계: 서버 채널 활성화 (선택 사항)

기본적으로 봇은 DM에서만 작동해요. 서버 채널에서 사용하려면:

  1. Discord에서 서버 아이콘을 우클릭 → 서버 ID 복사를 선택하세요

"서버 ID 복사"가 보이지 않으면, 먼저 개발자 모드를 활성화하세요: 사용자 설정 → 고급 → 개발자 모드를 켜세요.

  1. 콘솔에서 채널 → Discord 카드의 관리를 클릭하세요
  2. 인증된 서버에서 서버 ID를 붙여넣고 추가를 클릭하세요

봇이 해당 서버의 채널에서 @멘션에 응답하게 돼요. 여러 서버를 추가할 수 있어요.

봇을 멘션할 때, 봇 사용자 ("Members" 아래에 APP 태그가 표시된 항목)를 선택해야 해요. 같은 이름의 역할을 선택하면 안 돼요. Discord는 봇과 같은 이름의 역할을 자동으로 생성하는데, 역할을 멘션해도 봇이 반응하지 않아요.

지원 기능

기능지원 여부
다이렉트 메시지지원
채널 메시지지원 (멘션 필요)
스트리밍 응답지원 (실시간 편집)
슬래시 명령어지원
리치 임베드지원
파일 첨부지원
음성 채널지원

자주 묻는 질문

1. Discord에서 봇이 오프라인인가요?

  • 토큰 확인 — 토큰을 정확하게 붙여넣었는지 확인하세요
  • 인텐트 확인 — 개발자 포털에서 Message Content Intent가 활성화되어 있는지 확인하세요
  • 콘솔 확인 — 채널 페이지에서 연결 상태와 오류 로그를 확인하세요

2. 봇이 메시지에 응답하지 않나요?

  • Message Content Intent가 활성화되어 있는지 확인하세요 (1단계)
  • 채널에서는 봇을 @멘션해야 응답해요
  • 봇 사용자를 멘션하고 있는지 확인하세요. 역할이 아닌 사용자를 선택해야 해요 — @를 입력할 때 "Members" 섹션(APP 태그 포함)에서 봇을 선택하세요. "Roles" 섹션에서 선택하면 안 돼요. Discord는 봇과 같은 이름의 역할을 자동 생성하지만, 역할을 멘션해도 봇이 반응하지 않아요.
  • 봇에 해당 채널의 View Channels 및 Read Message History 권한이 있는지 확인하세요

3. "Missing Permissions" 오류가 나오나요?

봇에 채널 내 적절한 권한이 필요해요. 최소한 View Channels, Send Messages, Read Message History, Embed Links 권한을 확인하세요.