사전 요구 사항
설정 가이드
Discord 애플리케이션 생성
- Discord Developer Portal로 이동합니다
- New Application을 클릭합니다
- 이름(예: “My AI Bot”)을 입력하고 Create를 클릭합니다
봇 생성
- 애플리케이션에서 Bot 탭으로 이동합니다
- Add Bot → **Yes, do it!**을 클릭합니다
- Privileged Gateway Intents 아래에서 다음을 활성화합니다:
- Message Content Intent (필수)
- Server Members Intent (권장)
- Reset Token을 클릭하여 봇 토큰을 생성합니다
- 토큰을 복사합니다 — 다음 단계에서 필요합니다
서버에 봇 초대
- OAuth2 탭 → URL Generator로 이동합니다
- Scopes 아래에서
bot,applications.commands를 선택합니다 - Bot Permissions 아래에서
Send Messages,Read Message History를 선택합니다 - 생성된 URL을 복사하여 브라우저에서 엽니다
- 서버를 선택하고 Authorize를 클릭합니다
LemonData 대시보드에서 설정
- Claw Dashboard로 이동합니다
- 인스턴스의 설정 아이콘을 클릭합니다
- IM Integrations 탭을 엽니다
- Discord 섹션을 확장합니다
- Bot Token을 붙여넣습니다
- Save를 클릭합니다
서버에서 사용하기
그룹 설정
대시보드의 IM Integrations 탭에서 서버(길드) 동작을 설정하세요:| 설정 | 옵션 | 설명 |
|---|---|---|
| Group Policy | Open (기본값) / Allowlist / Disabled | 서버 채널에 대한 액세스를 제어합니다 |
| Require @mention | On / Off | 봇이 멘션되었을 때만 응답합니다 (권장) |
| Group IDs | 길드 ID 목록 | 특정 서버로 제한합니다 (비어 있음 = 모든 서버) |
Discord는 전역 그룹 allowlist 대신 길드별 사용자 allowlist를 사용합니다. 고급 길드별 사용자 필터링을 위해 OpenClaw 설정 파일에서 직접 구성하세요.
DM 정책
누가 봇에게 직접 메시지를 보낼 수 있는지 제어합니다:| 정책 | 동작 |
|---|---|
| Pairing (기본값) | 새로운 사용자는 페어링 코드를 받습니다 — 권한 부여를 위해 WebUI에 입력하세요 |
| Allowlist | 지정한 사용자 ID만 봇에게 DM을 보낼 수 있습니다 |
| Open | 누구나 봇에게 DM을 보낼 수 있습니다 (주의해서 사용하세요) |
문제 해결
봇이 온라인이지만 응답하지 않음
봇이 온라인이지만 응답하지 않음
- Developer Portal에서 Message Content Intent가 활성화되어 있는지 확인하세요
- 봇 토큰이 올바른지 확인하세요
- 봇이 채널에서 메시지를 읽고 보낼 수 있는 권한이 있는지 확인하세요
봇이 오프라인으로 표시됨
봇이 오프라인으로 표시됨
- 대시보드에서 인스턴스 상태를 확인하세요 (녹색/실행 중이어야 함)
- 인스턴스를 재시작해 보세요
- Developer Portal에서 토큰이 재설정되지 않았는지 확인하세요
로그에 409 Conflict 오류 발생
로그에 409 Conflict 오류 발생
- 두 개의 인스턴스가 동일한 봇 토큰을 사용하려고 할 때 발생합니다
- 하나의 Claw 인스턴스만 이 토큰으로 설정되어 있는지 확인하세요