Discord 봇을 먼저 만들어야 하는 이유
Openclaw에서 Discord 채널을 연결하려면 봇 토큰이 필요합니다. 이 토큰은 Discord Developer Portal에서 봇을 생성할 때 발급됩니다. 서버 작업을 시작하기 전에 브라우저에서 이 단계를 먼저 완료해야 합니다.
Step 1: Discord Developer Portal 접속
discord.com/developers/applications 에 접속합니다. Discord 계정으로 로그인 후 우측 상단의 New Application을 클릭합니다.
이름은 에이전트 이름과 맞추는 것이 관리하기 쉽습니다. 이번에는 cha-eunbyul로 했습니다.
Step 2: 봇 생성 및 토큰 발급
왼쪽 메뉴에서 Bot을 클릭합니다. Reset Token을 눌러 봇 토큰을 발급받고 반드시 복사해서 안전한 곳에 보관합니다. 이 토큰은 한 번만 보여주고 이후에는 다시 볼 수 없습니다.
Step 3: Privileged Gateway Intents 설정 — 가장 중요한 단계
Bot 페이지에서 아래로 스크롤하면 Privileged Gateway Intents 섹션이 나옵니다. 여기서 세 가지를 모두 활성화합니다.
- Presence Intent
- Server Members Intent
- Message Content Intent ← 이것이 핵심입니다
Message Content Intent를 켜지 않으면 봇이 Discord에는 연결되지만 메시지 내용을 읽지 못합니다. 게이트웨이 로그에는 봇이 로그인됐다고 나오는데 응답이 없는 상황이 됩니다. 설정을 다 했는데 봇이 반응하지 않는다면 이 항목이 꺼져 있을 가능성이 높습니다.
Step 4: OAuth2 권한 설정 및 서버 초대
왼쪽 메뉴에서 OAuth2를 클릭하고 URL Generator를 선택합니다.
SCOPES에서 bot을 체크하면 Bot Permissions가 나타납니다. 카드뉴스 봇에 필요한 권한은 다음 네 가지입니다.
- 메시지 보내기 (Send Messages)
- 파일 첨부 (Attach Files) — 카드뉴스 PNG를 채널에 올리려면 필수
- 메시지 기록 보기 (Read Message History)
- 채널 보기 (View Channels)
하단에 생성된 URL을 복사해서 브라우저에서 열면 봇을 Discord 서버에 초대할 수 있습니다.
Step 5: Discord 서버 채널 구성
봇 전용 Discord 서버를 만들고 채널을 에이전트 단위로 구성합니다.
에이전트가 늘어날 것을 미리 고려해서 채널 이름을 에이전트 이름 기준으로 만들면 관리하기 쉽습니다. 예: #차은별-카드뉴스, #명령, #결과물.
자주 하는 실수
권한을 나중에 바꿔도 되겠지 하고 Attach Files를 빠뜨리는 경우가 있습니다. 카드뉴스 PNG를 채널에 올릴 수 없게 됩니다. 봇 초대할 때 미리 체크하는 것이 낫습니다.
