Discord로 Hermes 연결하기
Discord 연동은 Hermes를 서버 채널이나 DM에서 부를 수 있는 봇으로 만드는 단계입니다. 먼저 hermes --tui로 기본 대화가 잘 되는지 확인한 뒤 진행하세요.
Discord 연동 시작하기
여기서는 Discord Developer Portal에서 봇을 만들고, Hermes Gateway에 bot token과 내 Discord User ID를 연결합니다. 잘 모르겠으면 이 페이지 순서대로만 따라가세요.
Discord Developer Portal 열기
브라우저에서 Discord 개발자 페이지를 열고, 내가 쓰는 Discord 계정으로 로그인합니다.
새 Application 만들기
Discord Developer Portal은 채팅창이 아니라 “봇을 만들고 관리하는 설정 화면”입니다. 오른쪽 위의 New Application을 누르고 이름을 입력합니다. 예를 들어 Hermes Helper처럼 알아보기 쉬운 이름을 쓰면 됩니다.
- New Application을 누릅니다.
- 이름을 입력하고 약관에 동의합니다.
- Create를 누릅니다.
- General Information 화면의 Application ID를 확인합니다. 나중에 수동 초대 URL을 만들 때 쓰는 긴 숫자입니다.
Bot 만들고 중요한 스위치 켜기
왼쪽 메뉴에서 Bot을 누르면 Application에 연결된 봇 사용자를 설정할 수 있습니다. 여기서 봇 토큰과 메시지 읽기 권한을 준비합니다.
- 왼쪽 메뉴에서 Bot을 누릅니다.
- Public Bot은 기본값을 유지합니다. 개인 서버에 직접 초대해서 쓸 목적이라면 이 설정을 일부러 바꿀 필요는 없습니다.
- Require OAuth2 Code Grant는 OFF로 둡니다.
- 아래로 내려가 Privileged Gateway Intents를 찾습니다.
- 공식 Hermes Discord 설정 안내에 맞춰 Server Members Intent와 Message Content Intent를 ON으로 켭니다.
- Save Changes를 누릅니다.
Bot token 복사하기
Bot 화면의 Token 영역에서 Reset Token 또는 View Token을 눌러 토큰을 확인하고 바로 복사합니다. 2단계 인증을 쓰고 있다면 확인 코드를 입력해야 할 수 있습니다.
봇을 내 Discord 서버에 초대하기
왼쪽 메뉴에서 Installation을 열고 Discord가 제공하는 설치 링크를 만들거나, 아래 수동 URL 형식을 사용할 수 있습니다. 잘 모르겠으면 Discord 화면에서 만들어주는 Install Link를 쓰세요.
- Installation에서 Guild Install을 켭니다.
- Scopes는
bot,applications.commands를 선택합니다. - 권한은 View Channels, Send Messages, Embed Links, Attach Files, Read Message History를 선택합니다.
- 생성된 Install Link를 열고 내 서버를 선택한 뒤 Authorize를 누릅니다.
https://discord.com/oauth2/authorize?client_id=YOUR_APP_ID&scope=bot+applications.commands&permissions=274878286912YOUR_APP_ID 부분은 General Information의 Application ID로 바꿔야 합니다. 수동 URL이 어렵다면 이 줄은 건너뛰고 Discord의 Install Link를 사용하세요.
내 Discord User ID 찾기
Hermes는 “누가 이 봇에게 말을 걸 수 있는지”를 Discord User ID로 확인합니다. 닉네임이 아니라 긴 숫자 ID를 써야 합니다.
- Discord 앱 또는 웹에서 User Settings를 엽니다.
- Advanced 메뉴에서 Developer Mode를 ON으로 켭니다.
- 설정을 닫고 내 프로필이나 내 메시지를 우클릭합니다.
- Copy User ID를 눌러 긴 숫자를 복사합니다.
DISCORD_FREE_RESPONSE_CHANNELS에 Channel ID를 넣습니다.Hermes 설정 마법사 실행
이제 앞에서 준비한 bot token과 Discord User ID를 Hermes에 넣습니다.
아래 명령어를 터미널에 입력하세요.
hermes gateway setup- 선택지가 나오면 Discord를 선택합니다. 잘 모르겠으면 화살표 키로 Discord에 맞춘 뒤 Enter를 누르세요.
- Bot token을 물어보면 4단계에서 복사한 토큰을 붙여넣습니다.
- Allowed user ID를 물어보면 6단계에서 복사한 긴 숫자를 붙여넣습니다.
- 저장 여부를 물어보면 Enter를 눌러 기본값으로 진행합니다.
설정 마법사 문구는 버전에 따라 조금 다를 수 있지만, Discord를 선택하고 bot token과 user ID를 넣는 흐름은 같습니다.
잘 모를 경우 체크 리스트!
테스트로 Gateway 실행
Gateway를 실행하면 Discord와 Hermes를 이어주는 연결 다리가 켜집니다. 처음에는 서비스로 설치하지 말고, 아래 명령어로 터미널에 켜둔 상태에서 테스트하세요.
hermes gateway정상이라면 Discord에서 봇이 온라인으로 보입니다. DM에서는 그냥 메시지를 보내면 되고, 서버 채널에서는 기본적으로 봇을 @멘션해야 답합니다. Bot token을 만든 Developer Portal 화면이 아니라, 실제 Discord 앱이나 웹에서 테스트해야 합니다.
DM, 서버 채널 차이
DM에서는 Hermes가 모든 메시지에 답합니다. 서버 채널에서는 기본적으로 봇을 멘션해야 답합니다. 초보자는 이 기본값 그대로 쓰는 것이 안전합니다.
DISCORD_FREE_RESPONSE_CHANNELS에 넣으면 됩니다. 처음 연결할 때는 건드리지 않아도 됩니다.DISCORD_FREE_RESPONSE_CHANNELS=123456789012345678Gateway를 계속 켜두고 싶을 때
테스트가 잘 끝난 뒤에만 서비스로 설치하세요. macOS에서는 launchd로 등록되어 터미널을 꺼도 Gateway를 켤 수 있습니다.
hermes gateway install
hermes gateway start
hermes gateway status가장 흔한 문제
Discord에서 시켜볼 Todo 예시
아래 문장을 Discord 봇에게 그대로 보내보세요. 서버 채널에서는 봇 이름을 앞에 멘션하고, DM에서는 멘션 없이 보내면 됩니다.
@Hermes Helper 오늘 할 일을 5개 체크리스트로 정리하고,
먼저 해야 할 일 하나만 골라줘.“@Hermes Helper 이 채널에서 나온 의견을 할 일 목록으로 정리해줘.”
“@Hermes Helper Telegram 연동과 Discord 연동 차이를 표로 정리해줘.”
“@Hermes Helper Discord 봇이 답하지 않을 때 확인할 체크리스트를 만들어줘.”
다음 페이지로 이어가기
Discord 연결이 끝났다면, 다음에는 역할별로 Hermes를 나누는 프로필 기능을 보면 좋습니다. 프로필마다 다른 Telegram 또는 Discord 봇을 붙이는 구조를 이해할 수 있습니다.
역할별 프로필 만들기 페이지 열기