OpenClaw 디스코드 연결 방법 완벽 가이드 | Discord 봇 설정하기

작성일자 글쓴이

메타 설명: OpenClaw를 디스코드에 연결하는 방법을 단계별로 안내합니다. Discord 봇 생성부터 채널 설정까지 완벽 가이드!

디스코드에서 AI 어시스턴트 사용하기

OpenClaw는 다양한 메신저와 연동됩니다. 그중에서도 디스코드(Discord)는 게이머와 개발자 커뮤니티에서 가장 인기 있는 플랫폼이죠!

이 가이드를 따라하면 여러분의 디스코드 서버에서 AI 어시스턴트와 대화할 수 있습니다. DM으로 1:1 대화도 가능하고, 서버 채널에서 멘션으로 호출할 수도 있어요!

사전 준비 사항

시작하기 전에 다음을 준비하세요.

항목 설명
OpenClaw 설치 및 기본 설정 완료
Discord 계정 봇을 만들 계정
Discord 서버 봇을 초대할 서버 (테스트용 개인 서버 권장)

준비되셨나요? 그럼 시작해볼게요!

1단계: Discord 봇 생성하기

먼저 Discord Developer Portal에서 봇을 만들어야 합니다.

봇 생성 순서:

  1. Discord Developer Portal 접속
  2. New Application 클릭
  3. 앱 이름 입력 후 Create
  4. 왼쪽 메뉴에서 Bot 클릭
  5. Add Bot 클릭
  6. Token 아래의 Reset Token 클릭 후 토큰 복사

이 토큰을 안전한 곳에 저장하세요. 나중에 OpenClaw 설정에 사용합니다!

2단계: Gateway Intents 활성화하기

봇이 메시지를 읽으려면 Privileged Gateway Intents를 활성화해야 합니다.

Bot 설정 페이지에서:

  • Message Content Intent – 필수! 메시지 내용을 읽기 위해 필요
  • Server Members Intent – 권장. 사용자 이름 조회에 필요

두 옵션을 모두 켜주세요. 이걸 안 하면 봇이 연결되어도 메시지에 반응하지 않습니다!

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

봇을 서버에 초대하려면 OAuth2 URL이 필요합니다.

OAuth2 → URL Generator에서:

Scopes 선택:

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

Bot Permissions 선택:

  • View Channels
  • Send Messages
  • Read Message History
  • Embed Links
  • Attach Files
  • Add Reactions (선택)

생성된 URL을 복사해서 브라우저에 열고, 서버를 선택해서 초대하세요!

4단계: OpenClaw 설정하기

이제 OpenClaw에 봇 토큰을 설정합니다.

방법 1: 환경 변수 (권장)

export DISCORD_BOT_TOKEN="your_bot_token_here"

방법 2: 설정 파일

~/.openclaw/openclaw.json 파일에 추가:

{
  "channels": {
    "discord": {
      "enabled": true,
      "token": "your_bot_token_here"
    }
  }
}

5단계: DM 및 서버 채널 설정

보안을 위해 기본적으로 DM은 페어링 모드입니다.

DM 설정 옵션:

  • pairing (기본값) – 처음 DM하면 페어링 코드 발급, 승인 필요
  • allowlist – 허용 목록에 있는 사용자만
  • open – 모든 사용자 허용 (주의!)

서버 채널 설정 예시:

{
  "channels": {
    "discord": {
      "enabled": true,
      "token": "your_token",
      "dm": {
        "enabled": true,
        "policy": "pairing"
      },
      "guilds": {
        "YOUR_GUILD_ID": {
          "requireMention": true,
          "channels": {
            "general": { "allow": true }
          }
        }
      }
    }
  }
}

requireMention: true로 설정하면 @멘션할 때만 봇이 응답합니다!

6단계: Gateway 시작 및 테스트

설정이 완료되었으면 Gateway를 시작합니다.

openclaw gateway

테스트 방법:

  1. 디스코드 서버의 채널에서 @봇이름 안녕! 입력
  2. 봇이 응답하면 성공!
  3. DM으로 메시지 보내면 페어링 코드 발급
  4. 터미널에서 openclaw pairing approve discord 코드 로 승인

유용한 팁

디스코드 연결을 더 잘 활용하기 위한 팁들입니다.

  • Developer Mode 활성화: 디스코드 설정 → 고급 → 개발자 모드 켜기. 우클릭으로 ID 복사 가능!
  • 슬래시 명령어: /status, /help 등 네이티브 명령어 지원
  • 리액션: 봇이 이모지 리액션도 달 수 있음
  • 스레드: 스레드에서도 대화 가능

문제 해결

연결이 안 된다면 다음을 확인하세요.

  • 봇이 응답 안 함: Message Content Intent 활성화 확인
  • 권한 오류: 봇에게 채널 읽기/쓰기 권한 있는지 확인
  • DM 안 됨: dm.policy 설정 및 페어링 승인 확인
  • 진단 명령어: openclaw doctor 실행

마무리하며

이제 디스코드에서 OpenClaw AI 어시스턴트를 사용할 수 있습니다! 서버 채널에서 팀원들과 함께 사용하거나, DM으로 개인 비서처럼 활용해보세요. 궁금한 점은 댓글로 남겨주세요!

해시태그: OpenClaw, 디스코드, Discord, AI어시스턴트, 봇설정, 디스코드봇, ChatBot, AI연동, 개인AI, 메신저연동

AI에 게시됨