사전 요구 사항
- Discord 계정
- 서버 관리(Manage Server) 권한이 있는 Discord 서버
- LemonClaw 인스턴스:
- 호스팅형: Claw 인스턴스 생성
- 셀프 호스팅형: LemonClaw 설치
설정 가이드
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을 클릭하여 봇 token을 생성합니다.
- token을 복사합니다. 다음 단계에서 필요합니다.
서버에 봇 초대
- OAuth2 탭 → URL Generator로 이동합니다.
- Scopes에서
bot,applications.commands를 선택합니다. - Bot Permissions에서
Send Messages,Read Message History를 선택합니다. - 생성된 URL을 복사하여 브라우저에서 엽니다.
- 서버를 선택하고 Authorize를 클릭합니다.
LemonClaw WebUI 열기
- 호스팅형 Claw를 사용하는 경우, Claw Dashboard로 이동하여 Open WebUI를 클릭합니다.
- LemonClaw를 셀프 호스팅하는 경우, 본인의 WebUI(예:
http://your-ip:18789)를 열고 token으로 로그인합니다. - WebUI에서 Settings → Channels로 이동합니다.
- Discord 섹션을 확장합니다.
- Bot Token을 붙여넣습니다.
- Save를 클릭합니다.
서버에서 사용하기
그룹 설정
LemonClaw WebUI의 Channels 설정에서 서버(guild) 동작을 구성하세요:| 설정 | 옵션 | 설명 |
|---|---|---|
| Group Policy | Open (기본값) / Allowlist / Disabled | 서버 채널에 대한 액세스 제어 |
| Require @mention | On / Off | 봇이 @멘션되었을 때만 응답 (권장) |
| Group IDs | guild ID 목록 | 특정 서버로 제한 (비어 있으면 모든 서버) |
Discord는 전역 그룹 allowlist 대신 guild별 사용자 allowlist를 사용합니다. 고급 guild별 사용자 필터링은 LemonClaw 설정 파일에서 직접 구성하세요.
DM 정책
봇에게 직접 메시지를 보낼 수 있는 사용자를 제어합니다:| 정책 | 동작 |
|---|---|
| Pairing (기본값) | 새로운 사용자는 페어링 코드를 받습니다. WebUI에 입력하여 승인하세요. |
| Allowlist | 지정한 사용자 ID만 봇에게 DM을 보낼 수 있습니다. |
| Open | 누구나 봇에게 DM을 보낼 수 있습니다 (주의해서 사용하세요). |
문제 해결
봇이 온라인이지만 응답하지 않음
봇이 온라인이지만 응답하지 않음
- Developer Portal에서 Message Content Intent가 활성화되어 있는지 확인하세요.
- 봇 token이 올바른지 확인하세요.
- 봇이 해당 채널에서 메시지를 읽고 보낼 수 있는 권한이 있는지 확인하세요.
봇이 오프라인으로 표시됨
봇이 오프라인으로 표시됨
- 대시보드에서 인스턴스 상태를 확인하세요 (초록색/실행 중이어야 함).
- 인스턴스를 재시작해 보세요.
- Developer Portal에서 token이 재설정되지 않았는지 확인하세요.
로그에 409 Conflict 오류 발생
로그에 409 Conflict 오류 발생
- 두 개의 인스턴스가 동일한 봇 token을 사용하려고 할 때 발생합니다.
- 하나의 LemonClaw 인스턴스만 이 token으로 구성되어 있는지 확인하세요.