헤르메스 에이전트 설치 및 디스코드 봇 연결 방법
AI 에이전트가 ‘한 번 쓰고 끝나는 도구’가 아니라, 매번 사용할수록 스스로 학습하고 진화하는 시대가 왔습니다. **헤르메스 에이전트(Hermes Agent)**는 Nous Research가 개발한 오픈소스 AI 에이전트로, 디스코드·텔레그램·슬랙 등 다양한 메신저와 단번에 연결할 수 있어 생산성을 극적으로 끌어올려 줍니다. 이 글에서는 2026년 최신 정보를 바탕으로 헤르메스 에이전트 설치부터 디스코드 봇 연결까지 단계별로 알기 쉽게 안내해 드리겠습니다.
헤르메스 에이전트란?
헤르메스 에이전트는 단순한 챗봇이 아니라 작업을 수행하며 스스로 ‘스킬’을 만들고, 대화 기록과 기억을 영구적으로 유지하는 자율형 AI 에이전트입니다. 한 번 복잡한 작업을 완료하면, 다음번에 비슷한 상황이 오면 더 빠르고 정확하게 처리하는 자기 발전 구조가 특징입니다.
- 개발사: Nous Research (오픈소스, GitHub 공개)
- 지원 플랫폼: Discord, Telegram, Slack, WhatsApp, Signal, Email
- 지원 모델: OpenAI, Claude, Gemini, DeepSeek, Grok, Ollama(로컬) 등 200개 이상
- 핵심 기능: 영구 메모리, 자동 스킬 생성, 멀티플랫폼 게이트웨이
- 최소 사양: 컨텍스트 64,000 토큰 이상 모델 필요 (로컬 모델은 8~16GB VRAM 권장)
- 설치 소요 시간: 설치 약 2분 + 설정 약 15분
설치 전 준비사항
헤르메스 에이전트를 원활하게 설치하려면 몇 가지 환경을 미리 확인해야 합니다. 운영체제별로 지원 방식이 다르며, 특히 Windows 사용자는 WSL2 환경을 권장합니다.
- 운영체제: macOS, Linux (네이티브), Windows (WSL2 권장)
- 필수 설치: Git (설치 스크립트 실행에 필요)
- LLM API 키: OpenAI, Anthropic, OpenRouter 등 원하는 제공자 API 키 준비
- Python 환경: 설치 스크립트가 자동으로 Python 가상환경을 구성함
- 네트워크: 안정적인 인터넷 연결 (초기 의존성 다운로드 필요)
- 권장 VPS: 24시간 운영 원할 경우 DigitalOcean, Hetzner 등 $5~10/월 VPS 사용 권장
헤르메스 설치 방법
설치 자체는 명령어 한 줄로 해결됩니다. 공식 GitHub(NousResearch/hermes-agent)에서 제공하는 설치 스크립트를 실행하면 Python 환경, Node.js 의존성, 유틸리티까지 자동으로 설치됩니다.
bash
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash- 설치 완료 후
hermes setup명령으로 전체 설정 마법사 실행 hermes model명령으로 사용할 LLM 제공자 및 모델 선택hermes tools명령으로 사용할 도구(툴) 활성화hermes doctor명령으로 설치 오류나 문제 진단 가능hermes update명령으로 언제든 최신 버전으로 업데이트 가능- OpenClaw에서 이전하는 경우
hermes claw migrate명령으로 설정·메모리 자동 마이그레이션
디스코드 앱(봇) 생성
디스코드 봇을 만들려면 Discord 개발자 포털에서 애플리케이션을 먼저 등록해야 합니다. 이 과정은 5분 이내로 완료되며, 봇 토큰 발급이 핵심입니다.
- Discord Developer Portal(discord.com/developers/applications)에 접속 후 로그인
- New Application 클릭 → 앱 이름 입력(예: “Hermes Agent”) → Create 클릭
- 좌측 사이드바에서 Bot 메뉴 클릭 → 봇 사용자 자동 생성 확인
- Public Bot을 ON으로 설정 (초대 링크 사용 위해 필수)
- Token 섹션에서 Reset Token 클릭 → 2FA 인증 후 토큰 복사 (단 한 번만 표시되므로 즉시 저장)
- ⚠️ 토큰은 절대 공개하거나 Git에 커밋하지 마세요 — 유출 시 봇 전체가 제3자에 노출됩니다
메시지 인텐트 권한 설정
디스코드 봇이 채널의 일반 메시지를 읽으려면 Privileged Gateway Intents 설정이 반드시 필요합니다. 이 설정을 빠뜨리면 봇이 슬래시 커맨드에만 반응하고 일반 메시지는 인식하지 못합니다.
- Developer Portal → Bot 설정 페이지 이동
- Privileged Gateway Intents 섹션에서 Message Content Intent 활성화
- Save Changes 클릭으로 저장
- OAuth2 → URL Generator 이동 → Scopes에서
bot체크 - Bot Permissions에서
Send Messages,Read Message History,Read Messages / View Channels체크 - 생성된 URL을 복사해 브라우저에 붙여넣기 → 초대할 서버 선택 후 Authorize 클릭
헤르메스 게이트웨이 설정
봇 생성이 완료되었다면, 이제 헤르메스 에이전트와 디스코드를 연결할 차례입니다. hermes gateway setup 명령 하나로 대화형 설정이 시작됩니다.
bash
hermes gateway setup- 실행 후 플랫폼 선택 목록에서 Discord 선택
- 앞서 복사해 둔 봇 토큰을 붙여넣기
~/.hermes/config.yaml파일에서 세부 설정 커스터마이징 가능- 설정 완료 후
hermes gateway명령으로 게이트웨이 실행 - 오류 없이 실행되면 디스코드 서버에서 봇이 온라인 상태로 표시됨
- 문제 발생 시
hermes doctor명령으로 원인 진단
config.yaml 세부 설정
헤르메스의 디스코드 동작 방식은 ~/.hermes/config.yaml 파일을 통해 세밀하게 제어할 수 있습니다. 아래는 주요 설정 항목과 권장 값입니다.
yaml
discord:
bot_token: "여기에_봇_토큰_입력"
default_channel_id: '채널_ID'
free_response_channels: '멘션_없이_응답할_채널_ID'
allowed_channels: '' # 비워두면 전체 채널 허용
auto_thread: true # @멘션 시 자동 스레드 생성
reactions: true # 활동 중 반응 이모지 표시
require_mention: true # 서버에서 @멘션 필요 여부free_response_channels: 멘션 없이 자유롭게 대화할 채널 ID (쉼표로 복수 입력 가능)auto_thread: 채널을 깔끔하게 유지하고 싶다면true권장require_mention: false로 설정하면 모든 메시지에 자동 응답- 사용자별 독립 세션 유지 — Alice와 Bob이 같은 채널에서 대화해도 서로 기록이 섞이지 않음
channel_prompts설정으로 채널별 전용 시스템 프롬프트 주입 가능- 설정 변경은 재시작 없이 즉시 적용 (과거 세션 기록엔 영향 없음)
게이트웨이 자동 시작 설정
VPS나 개인 서버에서 헤르메스를 24시간 운영하려면 시스템 서비스로 등록하는 것이 좋습니다. 한 번만 설정하면 재부팅 후에도 자동으로 실행됩니다.
bash
# macOS (launchd)
hermes gateway install
# Linux (systemd 사용자 서비스)
hermes gateway install
# Linux (시스템 전체, 재부팅 후에도 유지)
sudo hermes gateway install --system- 서비스 등록 후 서버 재시작 시에도 자동으로 게이트웨이가 재개됨
- 디스코드·텔레그램·슬랙 등 여러 플랫폼을 단일 게이트웨이 프로세스로 동시 운영 가능
hermes gateway status명령으로 현재 실행 상태 확인- 로그 확인으로 응답 누락이나 오류 원인 빠르게 파악 가능
- VPS 사용 시 DigitalOcean, Hetzner 등 $5~10/월 플랜으로도 충분히 운영 가능
- 봇이 100개 이상 서버에 추가되면 Discord의 공식 인텐트 인증 신청 필요 (개인 사용은 해당 없음)
꿀팁 & 활용 아이디어
헤르메스 에이전트를 디스코드에 연결하고 나면, 단순 Q&A를 넘어 강력한 자동화 워크플로우를 구축할 수 있습니다. 아래는 커뮤니티에서 실제로 활용 중인 대표 사례들입니다.
- 🔍 개인 리서치 봇: RSS 피드 모니터링 + 논문 요약 + 디스코드 채널로 브리핑 자동 발송
- 💻 코드 리뷰 봇: GitHub MCP 서버 연결 → PR 자동 리뷰 결과를 디스코드로 전달
- 🛡️ DevOps 모니터: 서버 상태·SSL 인증서·업타임 주기적 점검 + 이상 발생 시 디스코드 알림
- 🎙️ 음성 채널 연동:
/voice명령으로 음성 채널 합류 → TTS로 응답 (Minimax TTS 등 지원) - 📅 미팅 준비 봇: 회의 전 관련 문서·과거 메모·액션 아이템 자동 정리 후 채널에 공유
- 🧠 장기 메모리 활용:
persistent_memory+skill_generation반드시 활성화 — 미설정 시 일반 단일 세션 에이전트와 동일하게 동작
자주 묻는 질문 (Q&A)
Q1. 헤르메스 에이전트는 무료로 사용할 수 있나요? A1. 헤르메스 에이전트 자체는 완전 오픈소스(MIT 라이선스)이므로 무료로 설치·사용할 수 있습니다. 단, 연결하는 LLM 제공자(OpenAI, Anthropic 등)의 API 사용 비용은 별도로 발생하며, Ollama를 통한 로컬 모델 사용 시 API 비용 없이 운영할 수 있습니다.
Q2. 봇이 디스코드 채널에서 응답하지 않아요. 어떻게 해야 하나요? A2. 가장 흔한 원인은 세 가지입니다. ① Bot이 해당 채널에 초대되어 있는지, ② Message Content Intent가 활성화되어 있는지, ③ 채널에서 @멘션 없이 메시지를 보낸 경우 require_mention: true 설정 때문일 수 있습니다. hermes doctor 명령으로 진단 후 config.yaml을 재확인하세요.
Q3. 여러 메신저(텔레그램, 슬랙 등)를 동시에 연결할 수 있나요? A3. 가능합니다. 헤르메스는 단일 게이트웨이 프로세스에서 Discord, Telegram, Slack, WhatsApp, Signal 등을 동시에 운영할 수 있습니다. hermes gateway setup을 각 플랫폼별로 실행하거나 config.yaml에 복수 플랫폼 설정을 추가하면 됩니다.
Q4. Windows에서도 설치가 가능한가요? A4. 네, 가능합니다. Windows에서는 WSL2(Windows Subsystem for Linux 2)를 통해 Linux 환경을 구성한 뒤 동일한 설치 스크립트를 실행하면 됩니다. 브라우저 기반 대시보드 채팅 패널 기능은 WSL2에서만 지원되며, CLI 및 게이트웨이는 네이티브 Windows에서도 동작합니다.
Q5. 헤르메스의 ‘스킬 자동 생성’ 기능은 어떻게 동작하나요? A5. 복잡한 작업(여러 툴 호출이 포함된 5단계 이상 워크플로우 등)을 완료하면, 헤르메스가 자동으로 해당 작업 과정을 스킬 파일로 저장합니다. 이후 비슷한 요청이 오면 저장된 스킬을 재사용해 더 빠르고 정확하게 처리합니다. skill_generation: true 설정이 활성화되어 있어야 동작합니다.
