OpenClaw Discord 연동 완벽 가이드 - 봇 생성부터 실전까지

English (N/A)
#OpenClaw#Discord#AI#자동화#봇

OpenClaw를 Discord에 연동하면 Discord DM이나 채널에서 AI 에이전트와 대화할 수 있다.

전제 조건

전체 과정 요약

  1. Discord Application 생성
  2. 봇 생성 및 Token 발급
  3. Intents 설정
  4. OAuth2 URL로 서버 초대
  5. OpenClaw 설정
  6. 테스트

소요 시간: 약 10분

1. Discord Application 생성

1-1. Discord Developer Portal 접속

Discord Developer Portal에 접속한다.

1-2. New Application 생성

New Application 클릭

1-3. 정보 입력

  • Name: OpenClaw (원하는 이름)

Create 클릭

2. 봇 생성 및 Token 발급

2-1. Bot 메뉴 이동

좌측 메뉴에서 Bot 클릭

2-2. 봇 추가

Add Bot 클릭 → Yes, do it! 확인

2-3. Token 복사

TOKEN 섹션에서 Reset Token 클릭 → Copy 버튼으로 토큰 복사

⚠️ 주의: 이 토큰은 비밀번호와 같다. 절대 공개하지 말 것.

2-4. 봇 설정

PUBLIC BOT 체크 해제 (본인만 사용)

MESSAGE CONTENT INTENT 체크 (메시지 읽기 필요)

Save Changes 클릭

3. Intents 설정

봇이 메시지를 읽고 이벤트를 받으려면 Intents를 활성화해야 한다.

3-1. Privileged Gateway Intents

Bot 페이지 하단 Privileged Gateway Intents 섹션:

  • ✅ PRESENCE INTENT (선택)
  • ✅ SERVER MEMBERS INTENT (선택)
  • ✅ MESSAGE CONTENT INTENT (필수)

Save Changes 클릭

4. OAuth2 URL로 서버 초대

4-1. OAuth2 메뉴 이동

좌측 메뉴에서 OAuth2 → URL Generator 클릭

4-2. Scopes 선택

SCOPES 섹션:

  • ✅ bot
  • ✅ applications.commands (슬래시 명령어 사용 시)

4-3. Bot Permissions 선택

BOT PERMISSIONS 섹션:

Text Permissions:

  • ✅ Send Messages
  • ✅ Send Messages in Threads
  • ✅ Embed Links
  • ✅ Attach Files
  • ✅ Read Message History
  • ✅ Add Reactions

4-4. URL 복사 및 초대

하단에 생성된 GENERATED URL 복사

브라우저에 붙여넣기 → 서버 선택 → 승인 클릭

5. OpenClaw 설정

5-1. OpenClaw 설정 파일 열기

openclaw configure

또는 직접 편집:

nano ~/.openclaw/config.yaml

5-2. Discord 설정 추가

channels:
  discord:
    token: "YOUR_BOT_TOKEN_HERE"

YOUR_BOT_TOKEN_HERE를 2-3단계에서 복사한 토큰으로 교체.

5-3. Gateway 재시작

openclaw gateway restart

6. 테스트

6-1. DM으로 테스트

Discord에서 봇에게 DM 보내기:

안녕?

봇이 응답하면 성공!

6-2. 채널에서 테스트

봇을 멘션해서 테스트:

@OpenClaw 안녕?

트러블슈팅

봇이 응답하지 않음

1. Gateway 상태 확인

openclaw gateway status

실행 중이 아니면:

openclaw gateway start

2. Token 확인

설정 파일의 토큰이 정확한지 확인.

3. Intents 확인

MESSAGE CONTENT INTENT 가 활성화되어 있는지 확인.

4. 권한 확인

봇이 채널에서 메시지를 읽고 쓸 권한이 있는지 확인.

"Missing Permissions" 오류

서버에서 봇 역할의 권한 확인:

서버 설정 → 역할 → 봇 역할 → 권한 확인

필요 권한:

  • 메시지 읽기
  • 메시지 보내기
  • 링크 첨부
  • 파일 첨부

Gateway 로그 확인

openclaw gateway logs

오류 메시지 확인.

고급 설정

특정 채널만 허용

channels:
  discord:
    token: "YOUR_BOT_TOKEN_HERE"
    allowedChannels:
      - "1234567890"  # 채널 ID

DM만 허용

channels:
  discord:
    token: "YOUR_BOT_TOKEN_HERE"
    dmOnly: true

특정 사용자만 허용

channels:
  discord:
    token: "YOUR_BOT_TOKEN_HERE"
    allowedUsers:
      - "9876543210"  # 사용자 ID

보안 주의사항

Token 보호

  • Token은 절대 공개하지 말 것
  • Git에 커밋하지 말 것
  • 환경변수 사용 권장

Pairing 설정

신뢰하지 않는 사람이 봇을 사용하지 못하도록:

channels:
  discord:
    pairing: true

승인된 사용자만 사용 가능.

관련 가이드

참고