가이드

커넥터 연결, 골렘 생성 등 단계별 가이드.

💬

Discord 봇 커넥터 연결

골렘을 Discord 서버에 연결해서 채널/DM으로 대화할 수 있게 합니다.

0/6

1. Discord Developer Portal에서 앱 생성

2. New Application 클릭 → 이름 입력 (예: "Scout Bot")

3. 왼쪽 메뉴 Bot → Add Bot → Yes, do it!

4. Reset Token 으로 봇 토큰 복사 (한번만 보여요!)

💡토큰은 절대 코드나 채팅에 평문으로 붙여넣지 마세요. fleet/secret/ 에 보관합니다.

2. 봇 권한 설정

Bot 페이지에서:

- Privileged Gateway Intents 섹션

- ✅ MESSAGE CONTENT INTENT (메시지 읽기 필수)

- ✅ SERVER MEMBERS INTENT (선택)

- Bot Permissions:

- Send Messages, Read Messages/View Channels, Create Public Threads, Send Messages in Threads, Read Message History

3. 봇을 Discord 서버에 초대

1. 왼쪽 OAuth2 → URL Generator

2. Scopes: bot

3. Bot Permissions: 위에서 설정한 것들

4. 생성된 URL 복사 → 브라우저에 붙여넣기 → 서버 선택 → 승인

💡서버 관리자 권한이 필요해요.

4. fleet/secret/ 에 토큰 저장

fleet 레포에서:

# fleet/secret/discord-bots/<봇이름>.env 생성
echo "DISCORD_BOT_TOKEN=<복사한 토큰>" > fleet/secret/discord-bots/scout.env

이 파일은 .gitignore 되어 있어서 git에 올라가지 않아요.

💡secret ref 형식: fleet:discord-bots/scout.env#DISCORD_BOT_TOKEN

5. 골렘 상세에서 커넥터 추가

1. 골렘 목록 → 연결할 골렘 클릭

2. 정보 탭 → 🔌 커넥터 섹션 → + 추가

3. 폼 입력:

- 종류: Discord

- Bot Token Ref: fleet:discord-bots/scout.env#DISCORD_BOT_TOKEN

- Guild ID: Discord 서버 ID (서버 우클릭 → ID 복사, 개발자 모드 필요)

- Reply Mode: thread (추천) 또는 channel

- 멘션만 반응: 체크 (추천)

4. 추가 클릭

6. 커넥터 시작 및 테스트

1. 커넥터 목록에서 start 클릭

2. 상태가 enabled / connected 로 바뀌면 성공

3. Discord 서버에서 봇을 @멘션해서 테스트

4. 문제 시: 커넥터 상세 페이지(클릭)에서 🧪 테스트 버튼으로 진단

💡워커도 실행 중이어야 해요. 골렘 상세에서 '소환 (start)' 확인.