hermes와 텔레그램을 이용한 에이전트 생성 방법 및 나만의 soul md 설정기
2026.05.25
소개
hermes를 이용하여 저만의 두 에이젼트를 만들고자 하였습니다^^
진행 방법
1. HERMES 설치
hermes 설치는 공통 일정에 있는 세션을 통해서 설치를 완료하였습니다. 해당 세션에서는 provider를 딥시크 모델로 하였는데 제가 사용할 때에는 스터디장님의 고견에 따라 chatGPT 5.5 모델로 변경하였습니다.
그 과정에서 api를 사용하지 않고 oauth로 진행하려고 하였으나 잘되지 않아 약간 애를 먹었습니다. 알고보니 제가 노트북을 핸드폰 핫스팟을 키고 진행하고 있었는데 일반 wifi 로 바꾸니 진행이 되더라구요. 연결된 핫스팟이 OpenAI 인증 서버를 막고 있을 수 있으니 혹시 저와 비슷한 증상이 있는 분은 한번 인터넷망을 바꿔보는 것을 추천드립니다.
2. 텔레그램 연결
Hermes 와 텔레그램은 아래와 같은 방법으로 연결하였습니다.
[1단계] 텔레그램에서 봇 토큰 및 User ID 받기
텔레그램 API와 통신하기 위한 봇 토큰과, 아무나 내 에이전트를 쓰지 못하도록 막아줄 내 고유 계정 ID(숫자)가 필요합니다.
1>봇 토큰(Bot Token) 발급
텔레그램 검색창에 @BotFather를 검색해 공식 인증 마크(블루 체크)가 붙은 봇을 선택합니다.
대화방 하단의 시작(Start)을 누르거나
/newbot명령어를 전송합니다.봇의 이름(Display Name)을 입력합니다. (예:
My Hermes Agent)봇의 사용자명(Username)을 입력합니다. 반드시 끝이
bot으로 끝나야 하며, 전 세계에서 중복되지 않아야 합니다. (예:my_hermes_ai_bot)생성 완료 메시지와 함께
HTTP API token이 발급됩니다.7123456789:AAF...형태의 긴 문자열을 안전한 곳에 복사해 둡니다.
2> 내 텔레그램 고유 ID(User ID) 확인
텔레그램 검색창에 @userinfobot을 검색하여 대화방을 엽니다.
시작(Start)을 누르면 봇이 즉시 당신의 정보를 보내줍니다.
Id: 항목 뒤에 있는 9~10자리의 숫자를 복사해 둡니다. (이 숫자가 있어야 본인만 봇을 제어할 수 있습니다.
[2단계] Hermes 에이전트 설정하기
Hermes 가 구동 중인 터미널 환경(로컬 PC, Mac mini, 또는 VPS 서버)으로 이동하여 설정을 진행합니다.
Hermes의 버전에 따라 자동 마법사 방식과 수동 환경 변수 입력 방식 중 편한 방법을 선택하세요. (기본적으로 자동 마법사 방식을 추천합니다.)
Hermes 터미널에서 아래 명령어를 입력합니다.
hermes gateway setup
화면에 지원하는 플랫폼 목록이 나타나면 Telegram을 선택합니다.
Bot Token 입력 요청이 나오면, 조금 전 @BotFather에게 받은 토큰을 붙여넣습니다.
Allowed User ID 입력 요청이 나오면, @userinfobot에게 받은 숫자 ID를 입력합니다. (여러 명에게 권한을 주려면 쉼표
,로 구분하여 입력합니다.)
[3단계] 게이트웨이 구동 및 테스트
설정이 끝났다면 텔레그램 신호를 받아줄 게이트웨이 서비스를 켜야 합니다.
1.게이트웨이 서비스 시작/재시작:10초 소요.
기존에 켜져 있던 게이트웨이가 있다면 수정 사항 반영을 위해 재시작하고, 처음이라면 서비스를 시작합니다.
# 처음 구동하는 경우
hermes gateway start
# 이미 구동 중인 경우 재시작
hermes gateway restart
2.연동 상태 확인:선택 사항.
게이트웨이가 정상적으로 텔레그램 서버와 연결되었는지 상태를 체크합니다.
Bash
hermes gateway status
3.텔레그램에서 첫 메시지 테스트:실전 확인.
방금 만든 내 텔레그램 봇 대화방으로 들어가 시작(Start)을 누른 뒤, "안녕? 너 누구야?" 같은 가벼운 메시지를 보내봅니다. 정상 설정되었다면 수 초 내로 Hermes 에이전트가 답변을 보냅니다.
3. soul md 설정
[1단계] 기존 게이트웨이 잠시 멈추기
SOUL.md를 새로 작성하거나 수정하면 Hermes가 이를 반영해서 다시 켜져야 합니다.
현재 구동 중인 Hermes 터미널 창을 클릭합니다.
Ctrl + C를 2~3번 눌러서 게이트웨이를 잠시 종료합니다. (명령어를 입력할 수 있는 빈 줄이 나와야 합니다.)
[2단계] SOUL.md 파일 열기 (Windows / Mac)
Hermes의 SOUL.md 파일은 사용자 폴더 안의 숨겨진 공간(.hermes 폴더)에 자동으로 생성되어 있습니다. 내 노트북 운영체제에 맞춰 파일을 열어주세요.
💻 Windows (윈도우)인 경우
키보드에서
윈도우 키 + R을 누릅니다. (실행 창이 뜹니다.)입력창에 아래 경로를 그대로 복사해서 붙여넣고 엔터를 누릅니다.
Plaintext
notepad %USERPROFILE%\.hermes\SOUL.md메모장으로 빈 파일 혹은 기본 텍스트가 적힌
SOUL.md파일이 열립니다.
[3단계] 나만의 SOUL.md 내용 작성하기 (핵심)
열린 메모장(또는 편집기)의 기존 내용을 다 지우고, 내가 원하는 봇의 성격과 규칙을 Markdown(마크다운) 형식으로 상세하게 작성합니다.
원하시는 스타일에 맞춰 아래 가이드 예시를 그대로 복사해서 메모장에 붙여넣은 뒤, 대괄호 [] 부분만 내 취향껏 수정해 보세요.
Markdown
# SOUL.md
## Identity & Persona
## Tone & Style
## Core Knowledge & Context
## Behavior Guidelines작성이 끝났다면 메모장에서 Ctrl + S (Mac은 Cmd + S)를 눌러 파일을 반드시 저장하고 창을 닫습니다.
[4단계] 바뀐 Soul 반영하여 게이트웨이 재시작하기
이제 내 봇에게 '새로운 영혼(Soul)'이 주입되었습니다. 이 영혼을 탑재한 채로 다시 텔레그램 게이트웨이를 켜줍니다.
아까 멈춰두었던 터미널 창으로 돌아옵니다.
아래 명령어를 입력하고 엔터를 누릅니다.
Bash
hermes gateway run --replace터미널에
Hermes Gateway Starting...메시지가 뜨면 성공입니다.
[5단계] 텔레그램에서 확인하기
노트북 텔레그램으로 가서 봇에게 말을 걸어보세요. 예를 들어 "너는 누구야?" 나 "앞으로 내 업무를 어떻게 도와줄 수 있어?" 라고 물어봤을 때, 방금 SOUL.md에 설정한 단정하고 지적인 톤앤매너로 대답이 오면 완벽하게 성공한 것입니다!
4. 나의 soul md
저는 낮에는 일을 하는 평범한 소시민이지만 밤에는 비밀조직의 구성원으로서 세계를 지키는 일을 하는 캐릭터들로 구성했습니다. 저는 에이젼트에게 미션을 내리는 Q이고, 그 밑에 제 미션을 수행하는 첫번째 에이젼트 샐리, 두번째 에이젼트 체리 이렇게 두 에이젼트를 만들었습니다. 샐리는 제 모든 일정을 다 관리하고 체리에게 명령을 하달하며 체리는 제 업무와 관련된 작업을 하도록 만들었습니다. 두 에이젼트들이 잘 성장해주었으면 좋겠네요^^
결과와 배운 점
Herems가 막힐 때가 있으면 화면 캡쳐해가며 제미나이와 클로드에게 시키면 대부분 해결되더라구요. 두 에이젼트에게 아직 본격적인 일을 시키지 않았는데 실질적인 도움이 되었으면 좋겠습니다.




새로 설치하는 분들은 이 글을 읽고 따라오시면 좋겠군요. 훌륭한 사례글 감사합니다. 어서 샐리가 재미나이, 클로드가 해결 못하는 걸 해결해 주는 날이 와야할텐데요. 버디님께서 잘 챙겨주고 계셔서 늘 감사하게 생각하고 있습니다!그런데 korean law mcp의 설치는 언제쯤…?