본문으로 건너뛰기

헤르메스로 봇 만들고, 디스코드 챗봇으로 연결하기

ssuv

2026.05.24

소개

LLM을 개인이나 팀의 업무 방식에 완벽하게 녹여내기 위해, 단순히 웹 인터페이스를 사용하는 것을 넘어 나만의 독립된 LLM 구동 환경과 메신저 봇을 결합한 지식 관리 시스템(llm-wiki) 구축을 시도했습니다.

단순한 일회성 대화에 그치지 않고, 우리 팀만의 고유한 페르소나를 가진 캐릭터 봇이 업무를 보조하며, 지속적으로 지식을 축적하고 확장할 수 있는 자동화된 환경을 만드는 것이 이번 프로젝트의 궁극적인 목표였습니다.

진행 방법

이번 프로젝트를 위해 오픈소스 LLM 오케스트레이션 프레임워크와 메신저 API, 그리고 구조화된 프롬프트 관리 방식을 활용했습니다.

  • 인프라 및 환경 구축: Hermes 개발 환경을 설치하여 독립적인 AI 에이전트 구동 기반을 마련했습니다. LLM 모델은 가장 가성비가 좋다는 gpt.mini를 사용했습니다.

  • 사용자 인터페이스(UI): 가장 접근하기 좋고 데이터가 삭제되지 않는다고 해서 Discord를 연동하여 상시 상호작용이 가능한 메신저 봇을 구현했습니다.

  • 에이전트 아키텍처 설계: AI 에이전트의 정체성과 행동 양식을 규정하기 위해 아래와 같이 마크다운(MD) 기반의 프롬프트 자산을 구조화했습니다.

    • SOUL.md: 팀 캐릭터의 정체성과 핵심 페르소나 정의

    • AGENTS.md: 멀티 에이전트 협업 체계 및 역할 분담 정의

    • MEMORY.md: 컨텍스트 유지 및 기억 저장 방식 설계

결과와 배운 점

  • 디스코드와 Hermes를 연결하는 것은 크게 어려움은 없었던 것 같습니다. 내가 원하는 봇의 아키텍처를 설계하는 과정에서 SOUL.md 파일에다 모든 정보를 다 넣을 뻔했는데, 스터디장님의 자료를 참고해서 큰 어려움은 없었던 것 같습니다.

  • 사실 봇의 페르소나를 정의하는 과정이 가장 재밌어서 봇을 더 많이 만들고 싶었지만 계획이 원대하면 하나도 하지 못할까봐 '일단 하나라도 만들어보자'가 목표였습니다.

  • Hermes의 구조를 파악하기 위해 Claude를 사용했습니다. 처음에는 이 과정이 왜 필요한지 이해하지 않은채 그저 따라 가다보니까 study log는 만들어지는데 목적 없이 따라하기 바빴던 것 같습니다. 사실 아직도 그 구조에 대해서 완벽하게 이해는 되지 않지만, 일단은 진도를 나가야 될 것 같아서 30%정도만 이해하고 바로 넘어갔습니다.

  • 그 다음 계획은 LLM wiki를 구축하는 것입니다.

도움 받은 글 (옵션)

  • Hermes 설치 자료

  • Hermes Agent 한국어

  • 지피터스 리서치하네스 온오프모임 정규세션 자료 - Giacomo

2

함께 이야기해요 2

로그인하고 댓글을 남겨 주세요

Giacomo 프로필 이미지
Giacomo2026.05.26

ssuv님, “30% 정도만 이해하고 바로 넘어갔다”고 적어주신 부분이 오히려 현실적인 기록이라 좋았습니다. 처음 Hermes 구조를 따라갈 때는 study log가 만들어져도 왜 필요한지 바로 잡히지 않을 수 있고, 그 상태에서 일단 한 번 연결까지 가보는 것도 충분히 의미 있는 학습이라고 생각합니다. 이번 글에서 중요한 성과는 Discord와 Hermes를 연결한 것뿐 아니라, SOUL.md에 모든 정보를 넣을 뻔한 지점에서 역할 분리를 의식하셨다는 점으로 보였습니다. 페르소나, 협업 체계, 기억을 각각 SOUL.md / AGENTS.md / MEMORY.md로 나누려는 감각이 생긴 것만으로도 다음 LLM-WIKI 구축의 기반이 됩니다. 다음 단계에서는 LLM-WIKI를 크게 만들기 전에, 봇이 맡을 대표 상황 하나만 정해보시면 좋겠습니다. 예를 들어 메시지를 받으면 무엇을 읽고, 무엇을 답하고, 무엇은 하지 않을지를 5줄 정도로 적어두면, 지금 만든 봇이 단순 캐릭터를 넘어 실제 업무 보조자로 넘어가는 기준점이 생길 것 같습니다.

김도경 프로필 이미지
김도경2026.09.28

오늘도 하나 배워 갑니다.

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기