OpenClaw용 Discord 스킬

OpenClaw Discord 스킬 개요

Discord 스킬은 Discord API를 통해 OpenClaw를 Discord 서버에 연결하여 AI 에이전트를 강력한 Discord 어시스턴트로 변환합니다. 설치 후 자연어 명령을 통해 메시지 전송, 스레드 관리, 투표 실행, 이모지 업로드, 심지어 관리 작업까지 모두 처리할 수 있습니다.

Discord는 개발자 커뮤니티, 오픈소스 프로젝트, 팀 커뮤니케이션에서 가장 인기 있는 플랫폼 중 하나입니다. OpenClaw Discord 스킬을 사용하면 터미널과 Discord 사이의 컨텍스트 전환이 필요 없습니다. 커뮤니티 채널 모니터링, 질문 답변, 서버 설정 관리 등 OpenClaw와의 간단한 대화로 모든 작업을 완료할 수 있습니다.

일반적인 워크플로:

1. OpenClaw에 Discord 채널에 메시지를 보내거나 최근 활동을 확인하도록 요청합니다.
2. 에이전트가 적절한 작업(예: sendMessage, readMessages)으로 Discord API를 호출합니다.
3. 결과가 읽기 쉬운 요약으로 반환됩니다 — 컨텍스트 전환이 필요 없습니다.

Discord 스킬 사전 요구 사항

Discord 스킬을 설치하기 전에 다음 사항을 확인하세요:

• OpenClaw가 설치되어 실행 중 (v1.0+)
• 관리하려는 서버에 접근할 수 있는 Discord 계정
• 개발자 포털에서 봇 토큰을 가진 Discord 봇 생성 완료
• 필요한 권한으로 봇이 서버에 초대된 상태
• 스킬 관리를 위한 clawhub CLI 설치 완료

설정을 확인합니다:

# OpenClaw 버전 확인
openclaw --version

# clawhub CLI 확인
clawhub --version

Discord 봇 생성

아직 봇이 없다면 다음 단계를 따르세요:

1. Discord 개발자 포털에서 New Application을 클릭합니다.
2. Bot 탭으로 이동하여 Add Bot을 클릭합니다.
3. 봇 토큰을 복사합니다 — 구성 시 필요합니다.
4. Privileged Gateway Intents에서 스킬이 메시지 내용을 읽어야 하는 경우 Message Content Intent를 활성화합니다.
5. OAuth2 URL Generator를 사용하여 bot 범위와 필요한 권한이 포함된 초대 링크를 생성합니다.

Discord 스킬 설치 방법

단일 명령으로 Discord 스킬을 설치합니다:

npx clawhub@latest install discord

설치를 확인하려면:

clawhub list

설치된 스킬 목록에 discord가 표시되어야 합니다. 설치 전에 clawhub inspect discord로 스킬을 미리 확인할 수도 있습니다.

Discord 스킬 구성

Discord 스킬은 인증을 위해 봇 토큰이 필요합니다. 아직 봇을 만들지 않았다면 Discord 개발자 포털에서 봇을 생성하세요.

환경 설정

# Discord 봇 토큰 설정
export DISCORD_BOT_TOKEN=your_bot_token_here

중요: 토큰을 구성 파일에 직접 입력하지 마세요. 환경 변수 또는 1Password와 같은 시크릿 관리자를 사용하세요.

Gateway Intents

스킬은 Discord Gateway Intents를 사용하여 이벤트를 수신합니다. 세 가지 인텐트는 권한 있는(privileged) 인텐트이며 개발자 포털에서 활성화해야 합니다:

| 인텐트 | 용도 | 필수 여부 | |--------|------|-----------| | MESSAGE_CONTENT | 메시지 텍스트, 임베드, 첨부 파일 읽기 | readMessages 사용 시 필수 | | GUILD_MEMBERS | 멤버 입퇴장 이벤트 및 멤버 목록 접근 | memberInfo 사용 시에만 필요 | | GUILD_PRESENCES | 사용자 온라인/오프라인 상태 추적 | 거의 필요 없음 |

사용 사례에 필요한 인텐트만 활성화하세요. 대부분의 설정에서는 MESSAGE_CONTENT만으로 충분합니다.

작업 제어

Discord 스킬은 세밀한 작업 제어를 지원합니다. 대부분의 작업은 기본적으로 활성화되어 있지만 민감한 작업은 비활성화되어 있습니다:

| 작업 | 기본값 | 설명 | |------|--------|------| | discord.actions.moderation | false | 사용자 타임아웃, 추방, 차단 | | discord.actions.roles | false | 멤버에게 역할 추가 또는 제거 |

관리 작업을 활성화하려면 OpenClaw 구성을 업데이트하세요:

# 관리 작업 활성화 (주의하여 사용)
openclaw config set discord.actions.moderation true

Discord 스킬 사용 예시

1. 채널에 메시지 보내기

사용자： "#announcements 채널에 'Version 2.0이 출시되었습니다! 자세한 내용은 릴리스 노트를 확인하세요.'라는 메시지를 보내줘."

에이전트가 대상 채널 ID와 함께 sendMessage 작업을 사용합니다. 메시지를 게시하고 메시지 링크와 함께 전송을 확인합니다.

2. 커뮤니티 질문 모니터링

사용자： "#help-forum에서 최근 10개의 메시지를 읽고 답변되지 않은 질문을 요약해줘."

에이전트가 지정된 채널에서 readMessages를 호출하고, 답변이 없는 메시지를 필터링하여 각 스레드에 대한 링크와 함께 답변되지 않은 질문의 요약을 반환합니다.

3. 커뮤니티 투표 실행

사용자： "#general에 '다음에 어떤 기능을 만들어야 할까요?'라는 투표를 만들어줘. 옵션: 다크 모드, 모바일 앱, API 개선, 문서 개선. 24시간 동안 진행해줘."

에이전트가 최대 10개의 답변 옵션과 함께 poll 작업을 사용하여 투표를 생성합니다. 지속 시간을 설정하고 투표 링크와 함께 확인을 반환합니다.

4. 커스텀 이모지 업로드

사용자： "이 이미지를 'ship_it'이라는 커스텀 이모지로 서버에 업로드해줘."

에이전트가 emojiUpload를 사용하여 이미지(PNG/JPG/GIF, 최대 256KB)를 서버 이모지로 추가합니다. 업로드를 확인하고 메시지에서 사용할 이모지 코드 :ship_it:을 표시합니다.

보안 및 모범 사례

Discord 스킬은 메시지 전송 및 — 활성화된 경우 — 관리 작업을 포함하여 서버에서 쓰기 작업을 수행할 수 있습니다. 안전하게 사용하려면 다음 가이드라인을 따르세요:

• 최소 권한 원칙을 적용하세요. 봇에 실제로 필요한 권한만 부여하세요. 절대적으로 필요한 경우가 아니라면 Administrator 권한 부여를 피하세요.
• 관리 작업은 기본적으로 비활성화 상태를 유지하세요. 스킬은 moderation 및 roles 작업이 기본적으로 비활성화되어 있습니다. 구체적인 필요성이 있고 그 영향을 이해한 경우에만 활성화하세요.
• 필요한 인텐트만 활성화하세요. MESSAGE_CONTENT 및 GUILD_MEMBERS와 같은 권한 있는 인텐트는 워크플로에 필요한 경우에만 활성화하세요.
• 봇 토큰을 정기적으로 교체하세요. 토큰이 유출된 것으로 의심되면 개발자 포털에서 즉시 재생성하세요.
• 확인 전에 검토하세요. OpenClaw는 파괴적인 작업 시 확인을 요청합니다. 특히 관리 및 대량 작업의 경우 승인 전에 항상 작업 요약을 읽으세요.
• 봇 활동을 감사하세요. Discord의 감사 로그를 사용하여 봇이 수행한 작업을 추적하고 예상과 일치하는지 확인하세요.

일반적인 오류 해결

"401: Unauthorized"

봇 토큰이 누락되었거나, 유효하지 않거나, 재생성되었습니다.

1. 환경에 DISCORD_BOT_TOKEN이 설정되어 있는지 확인하세요.
2. 토큰이 개발자 포털 봇 설정의 토큰과 일치하는지 확인하세요.
3. 토큰이 최근에 재생성되었다면 환경 변수를 업데이트하세요.

# 토큰이 설정되어 있는지 확인
echo $DISCORD_BOT_TOKEN

"50001: Missing Access"

봇이 대상 채널이나 서버에 접근할 권한이 없습니다.

1. 봇이 올바른 권한으로 서버에 초대되었는지 확인하세요.
2. 봇을 차단할 수 있는 채널 수준의 권한 재정의를 확인하세요.
3. permissions 작업을 사용하여 채널에 대한 봇의 유효 권한을 확인하세요.

"MESSAGE_CONTENT intent is required"

메시지 내용을 읽으려 하지만 MESSAGE_CONTENT 권한 있는 인텐트가 활성화되지 않았습니다.

1. 개발자 포털 → 애플리케이션 → Bot 탭으로 이동하세요.
2. Privileged Gateway Intents에서 Message Content Intent를 활성화하세요.
3. 인증된 봇(75개 이상의 서버)의 경우 포털을 통해 이 인텐트를 신청해야 합니다.