Hermes Agent 설치하고 디스코드 연동(윈도우11)

Nous Research가 만든 오픈소스 AI 에이전트 "Hermes Agent"를 윈도우11 환경에서 처음부터 끝까지 설치하고, 디스코드 봇으로 연동하는 과정을 스크린샷과 함께 정리했습니다.

Hermes Agent?

Hermes Agent는 Nous Research에서 만든 오픈소스 AI 에이전트입니다.

저는 기본적으로 오픈클로를 사용했는데 헤르메스 반응이 괜찮길래 관심을 갖다가 시간을 내어 설치해보았습니다.

오픈클로와 비슷하며,

역시 텔레그램, 디스코드, 슬랙 등 다양한 메신저와 연동할 수 있어서, 스마트폰에서도 내 AI 에이전트에게 말을 걸 수 있습니다. OpenAI, Anthropic, DeepSeek 등 원하는 AI 모델을 자유롭게 선택할 수 있습니다.

Part 1: WSL2, git, Node.js 설치

일단 기본적으로 아래 글에서 5단계까지는 진행하고 오시는 게 좋습니다.
클로드 API KEY 제외하구요.

윈도우11에서 OpenClaw(molt bot) 설치하고 텔레그램 AI 비서 만들기

openclaw로 텔레그램 연동시킨 경험

syn2bloomJS

위에서 5단계까지(클로드 API 부분 제외) 진행하고 오시고

아래 내용 진행합니다.

1-1. 설치 확인

PowerShell에서 아래 명령어로 WSL 버전을 확인합니다.

wsl --version

WSL 버전이 2.x로 표시되면 성공입니다. 같은 화면에서 git --version도 확인해 두세요. Git은 Hermes 설치에 필요한 유일한 사전 요구 사항입니다.

Part 2: Hermes Agent 설치

2-1. 설치 명령어 실행

PowerShell(또는 WSL 터미널)에서 아래 명령어를 한 줄로 입력합니다.

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

설치 스크립트가 시작되면 아래와 같은 화면이 나타납니다.

스크립트가 자동으로 감지하고 설치하는 것들:

• uv (Python 패키지 매니저)
• Python 3.11
• Node.js
• ripgrep, ffmpeg 등

2-2. 선택 패키지 설치 (ripgrep, ffmpeg)

설치 도중 아래 질문이 나옵니다:

Install ripgrep for faster file search ffmpeg for TTS voice messages? [Y/n]

Y를 입력하고 Enter를 누릅니다. ripgrep은 파일 검색 속도를 높여주고, ffmpeg는 음성 메시지 기능에 필요합니다.

sudo 비밀번호를 물어보면, WSL 설정 시 만든 리눅스 비밀번호를 입력합니다.

저장소 클론, 가상환경 생성, 의존성 설치가 자동으로 진행됩니다. 몇 분 정도 걸릴 수 있습니다.

Part 3: 초기 설정 (Setup Wizard)

설치가 끝나면 자동으로 Setup Wizard가 시작됩니다.

3-1. OpenClaw 마이그레이션 (해당되는 경우만)

Hermes Agent의 이전 버전인 "OpenClaw"을 사용한 적이 있다면, 기존 데이터를 가져올지 묻는 화면이 나옵니다.

• OpenClaw을 사용한 적이 있고 데이터를 유지하고 싶다면 → Y
• 처음이거나 깨끗하게 시작하고 싶다면 → N

여기서 무엇을 선택했는지 기억이 나지 않습니다. 오픈클로를 사용해봤기 때문에 Y를 눌렀던 거 같습니다.

또 다시 선택을 하라고 나옵니다.

오픈클로의 설정 파일과 메모리, 스킬 등 항목을 Hermes로 가져올지 이야기 하는 듯합니다.

이것도 Y를 선택한 것 같습니다.

이유는 오픈클로를 사용해봤기 때문입니다.

3-2. 설정 범위 선택

How would you like to set up Hermes?
→ (●) Quick setup — provider, model & messaging (recommended)
  (○) Full setup — configure everything

Quick setup이 선택된 상태에서 Enter를 누릅니다. LLM 프로바이더, 모델, 메시징 플랫폼을 빠르게 설정할 수 있습니다.

3-3. AI 모델 프로바이더 선택

어떤 AI 모델을 사용할지 선택하는 단계입니다. 화살표 키로 이동하고 Enter로 선택합니다.

3-4. OpenAI Codex 로그인

OpenAI Codex를 선택하면 기기 인증 과정이 진행됩니다.

1. 화면에 표시된 URL(https://auth.openai.com/codex/device)을 브라우저에서 엽니다.
2. 화면에 표시된 코드를 입력합니다.

3. OpenAI 계정으로 로그인하고 권한을 허용합니다.
4. 터미널에 "Login successful!"이 표시됩니다.

3-5. 기본 모델 선택

로그인이 성공하면 사용할 모델을 선택합니다.

gpt-5.4가 기본으로 선택되어 있습니다. 원하는 모델을 화살표 키로 선택하고 Enter를 누릅니다.

Part 4: 디스코드 연동

Hermes Agent는 텔레그램, 디스코드, 슬랙 등 다양한 메신저와 연동할 수 있습니다. 여기서는 디스코드 연동 방법을 설명합니다.

4-1. 메시징 플랫폼 설정 진입

Setup Wizard에서 메시징 플랫폼을 설정할지 묻습니다.

"Set up messaging now (recommended)"가 선택된 상태에서 Enter를 누릅니다.

4-2. Discord 선택

플랫폼 목록에서 Discord를 선택합니다.

이제 디스코드 봇을 만들어야 합니다. 터미널은 잠시 두고 브라우저로 이동합니다.

4-3. 디스코드 봇 만들기

애플리케이션 생성

1. 브라우저에서 discord.com/developers/applications에 접속합니다.
2. 디스코드 계정으로 로그인합니다.
3. 오른쪽 상단 "신규 애플리케이션" 버튼을 클릭합니다.

4. 이름을 입력하고 (예: "Hermes Agent"), 개발자 이용약관에 동의한 뒤 만들기를 클릭합니다.

봇 설정

5. 왼쪽 사이드바에서 "봇" 메뉴를 클릭합니다.

Privileged Gateway Intents 설정 (매우 중요!)

6. 아래로 스크롤하여 Privileged Gateway Intents 섹션을 찾습니다.
7. 다음 두 항목을 반드시 ON으로 켭니다:
   • Server Members Intent
   • Message Content Intent

봇 토큰 발급

9. 다시 위로 올라가서 토큰 섹션의 "토큰 초기화" 버튼을 클릭합니다.
10. 새로 생성된 토큰이 표시됩니다. "복사" 버튼을 눌러 즉시 복사합니다.

⚠️ 토큰은 한 번만 표시됩니다! 복사하지 않고 페이지를 닫으면 다시 볼 수 없고, 재발급해야 합니다. 토큰은 절대 외부에 공개하지 마세요.

4-4. Hermes에 디스코드 설정 입력

다시 터미널로 돌아옵니다.

1. Bot token 입력란에 복사한 토큰을 붙여넣기합니다.

💡 팁: WSL 터미널에서는 Ctrl+V 대신 마우스 오른쪽 클릭으로 붙여넣기할 수 있습니다.

2. Allowed user IDs — 내 디스코드 사용자 ID를 입력합니다.

디스코드 사용자 ID 확인 방법:

• 디스코드 앱 → 설정(톱니바퀴) → 고급 → 개발자 모드 ON
• 아무 채팅에서 내 이름을 오른쪽 클릭 → Copy User ID
• 복사된 숫자를 터미널에 붙여넣기

3. Home channel ID — 비워두고 Enter (나중에 설정 가능)
4. 설정이 완료되면 "Discord configured!" 메시지가 나타납니다.

5. "Restart the gateway to pick up changes?" 질문에 Y를 입력합니다.

4-5. 봇을 디스코드 서버에 초대

봇을 만들었지만 아직 서버에 초대하지 않았습니다.

Application ID 복사

1. Developer Portal에서 만든 앱의 왼쪽 사이드바 "일반 정보" 페이지로 이동합니다.
2. 애플리케이션 ID 항목의 "복사" 버튼을 클릭합니다.

초대 URL 만들기

3. 아래 URL에서 YOUR_APP_ID를 방금 복사한 ID로 교체합니다:

https://discord.com/oauth2/authorize?client_id=YOUR_APP_ID

4. 완성된 URL을 브라우저 주소창에 붙여넣고 접속합니다.

서버가 없다면? 새 서버 만들기

기존 서버에 관리 권한이 없으면 봇을 초대할 수 없습니다. 이 경우 새 서버를 만들면 됩니다.

5. 디스코드 왼쪽 사이드바 맨 아래 + 버튼을 클릭합니다.
6. "서버 만들기(Create My Own)" → **"나와 친구들을 위한 서버"**를 선택합니다.
7. 서버 이름을 입력하고 (예: "B Agent") 만들기를 클릭합니다.

서버 생성자는 자동으로 모든 권한을 갖게 되므로, 이제 봇을 초대할 수 있습니다.

봇 초대 완료

8. 초대 URL에 접속하면 아래와 같은 화면이 나타납니다. "서버에 추가" 드롭다운에서 방금 만든 서버를 선택하고 "계속하기"를 클릭합니다.

9. 다음 화면에서 "인증하기(Authorize)"를 클릭하면 봇이 서버에 추가됩니다.

4-6. 게이트웨이 시작 및 확인

터미널에서 게이트웨이 상태를 확인합니다:

hermes gateway status

정상이라면 디스코드에서 봇이 **온라인(초록색)**으로 표시됩니다.

만약 봇이 오프라인이라면:

hermes gateway restart

4-7. 테스트

디스코드에서 봇에게 메시지를 보내봅니다.

• 서버 채널: @봇이름 안녕 (기본 설정에서는 @멘션이 필요)
• DM(개인 메시지): 멘션 없이 바로 "안녕" 전송 가능

봇이 "안녕하세요" 하고 답장하면 성공입니다! 🎉

Part 5: 편의 설정

멘션 없이 대화하기

혼자 쓰는 서버라면 매번 @봇이름을 붙이는 게 번거로울 수 있습니다. .env 파일에 한 줄만 추가하면 됩니다.

nano ~/.hermes/.env

파일 맨 아래에 추가:

DISCORD_REQUIRE_MENTION=false

저장(Ctrl+O → Enter → Ctrl+X) 후 재시작:

hermes gateway restart

이제 채널에서 그냥 메시지만 보내면 봇이 응답합니다.

Part 6: 컴퓨터가 재부팅 되었다면?

윈도우를 사용하다보면 업데이트 등으로 재부팅이 될 때가 있습니다.

WSL2는 윈도우 재부팅 후 자동으로 시작되지 않기 때문에, 직접 한 번 켜줘야 합니다.

재부팅 후 할 일은 딱 한 가지:

powershell

wsl

PowerShell이나 터미널에서 이 명령어 하나만 실행하면 WSL2가 시작되고, systemd가 게이트웨이 서비스를 자동으로 시작합니다. 잠시 후 디스코드에서 봇이 온라인이 됩니다.

확인하고 싶다면:

bash

hermes gateway status

만약 자동으로 안 올라왔다면:

bash

hermes gateway start

문제 해결 (Troubleshooting)

설치 과정에서 만날 수 있는 흔한 문제와 해결법을 정리했습니다.

yes | curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

봇이 오프라인이에요

게이트웨이가 실행 중인지 확인합니다:

hermes gateway status

실행 중이 아니라면:

hermes gateway start

"Improper token" 에러가 나요

봇 토큰이 잘못 입력된 경우입니다. Developer Portal에서 토큰을 재발급 받고, ~/.hermes/.env 파일의 DISCORD_BOT_TOKEN 값을 교체한 뒤 hermes gateway restart를 실행하세요.

봇이 온라인인데 메시지에 응답하지 않아요

• 서버 채널에서는 @멘션이 필수입니다. @봇이름 안녕 형태로 보내세요.
• Developer Portal에서 Message Content Intent가 ON인지 다시 확인하세요.
• DISCORD_ALLOWED_USERS에 내 사용자 ID가 포함되어 있는지 확인하세요.

텔레그램 폴링 충돌 경고가 떠요

OpenClaw 등 다른 프로그램이 같은 텔레그램 봇 토큰을 사용 중일 때 발생합니다. Hermes에서 텔레그램을 쓰지 않을 거라면 ~/.hermes/.env에서 TELEGRAM_BOT_TOKEN 앞에 #을 붙여 주석 처리하세요.

유용한 명령어 모음

마무리

Hermes Agent는 설치 과정이 조금 복잡해 보일 수 있지만, 한 번 세팅해 놓으면 디스코드(또는 텔레그램)에서 자유롭게 AI 에이전트와 대화할 수 있습니다. 터미널 명령어 실행, 파일 관리, 웹 검색, 예약 작업까지 다양한 기능을 활용할 수 있으니, 관심 있는 분들은 꼭 한 번 시도해 보시기 바랍니다.