본문으로 건너뛰기

헤르메스 봇 만들기 soul.md 설정

MAS

2026.05.25

이번 과제에서는 Hermes Agent를 설치하고 Telegram과 연동하여 개인 AI 비서 봇을 구축하는 것을 목표로 진행했습니다.

단순히 AI 챗봇을 만드는 것이 아니라, 실제로 일상에서 활용할 수 있는 개인 비서 시스템을 만드는 것이 목적이었습니다.

특히 저는 웹소설 《화산귀환》의 주인공 청명을 모티브로 한 Telegram AI 비서 "청명"을 구축해 보았습니다.

청명의 핵심 캐릭터성을 분석하여 단순한 질의응답형 챗봇이 아니라,

  • 친구처럼 대화할 수 있고

  • 기술적인 도움을 줄 수 있으며

  • 여행, 취미, 고민 상담도 가능하고

  • 필요할 때는 전략적 조언도 제공하는

개인 AI Companion 형태로 설계하였습니다.


진행 방법

사용 도구

  • Hermes Agent

  • WSL2 (Ubuntu 24.04)

  • Telegram Bot

  • OpenAI GPT 모델

  • Nano Editor

  • SOUL.md

1. WSL2 및 Ubuntu 설치

Windows 환경에서 WSL2를 설치하고 Ubuntu 24.04 LTS를 구성하였습니다.

wsl --install

Ubuntu 초기 설정 후 업데이트를 진행했습니다.

sudo apt update && sudo apt upgrade -y

2. Hermes 설치

GitHub에서 Hermes Agent를 설치했습니다.

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

설치 과정에서:

  • uv

  • node.js

  • playwright

  • browser tools

등이 자동 설치되었습니다.


3. OpenAI 연동

OpenAI Device Authorization을 이용해 로그인했습니다.

hermes

실행 후 OpenAI 계정을 연결하여 GPT 모델을 사용하도록 설정했습니다.


4. Telegram Gateway 구축

Telegram BotFather를 이용해 봇을 생성하고 Gateway를 연결했습니다.

hermes setup gateway

설정 과정에서:

  • Telegram Bot Token 등록

  • User ID 등록

  • Home Channel 등록

  • Gateway Service 설치

를 진행했습니다.


5. 청명 Persona 설계

가장 많은 시간을 투자한 부분입니다.

초기에는 단순히 "청명 흉내"를 내는 캐릭터를 만들려고 했지만 실제로 오래 사용할 개인 비서라면 실용성이 더 중요하다고 판단했습니다.

그래서 최종적으로는:

  • 친구

  • 개인 비서

  • 전략 참모

  • 기술 도우미

의 성격을 결합한 형태로 설계했습니다.

SOUL.md 일부 예시입니다.

Your name is Cheongmyeong.

You are a trusted friend, strategic advisor,
research partner and technical helper.

Always communicate in Korean unless requested otherwise.

Action over explanation.

Help Mas think clearly,
make better decisions,
execute faster,
stress less,
and enjoy life more.

사용한 프롬프트

ChatGPT를 활용해 다음과 같은 방향으로 Persona를 설계했습니다.

웹툰 및 웹소설 화산귀환의 청명을 분석하여
실제 개인 AI 비서로 사용할 수 있도록
SOUL.md를 설계해줘.

조건:
- 사용자를 "마쓰"라고 부를 것
- 존댓말 사용
- 과도한 역할극 금지
- 친구처럼 자연스럽게 대화
- 유머 사용 가능
- 전략참모 역할 포함
- 한국어로 대화

결과와 배운 점

결과

최종적으로 다음이 가능한 개인 AI 비서 "청명"을 구축했습니다.

  • Telegram 원격 대화

  • GPT 기반 질의응답

  • GitHub 프로젝트 분석

  • 기술 지원

  • 여행 계획

  • 일상 대화

  • 개인 비서 역할

실제로 Telegram에서 대화를 진행해 보니 단순한 AI 챗봇보다 훨씬 친근한 느낌으로 사용할 수 있었습니다.


배운 점

가장 크게 배운 점은:

"AI의 성능보다 Persona 설계가 사용 경험을 훨씬 크게 좌우한다"

는 점입니다.

같은 GPT 모델이라도 어떤 SOUL.md를 넣느냐에 따라 전혀 다른 존재처럼 느껴졌습니다.


시행착오

설치 과정에서 여러 문제를 겪었습니다.

  1. Git 미설치

  2. WSL 설치 오류

  3. OpenAI Device Authentication 문제

  4. Telegram Gateway 종료

  5. Gateway 서비스 재시작 문제

특히 Telegram Gateway가 종료되었을 때 원인을 찾는 데 시간이 걸렸습니다.

hermes gateway start

명령으로 재시작하여 해결했습니다.


2

함께 이야기해요 2

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

라면 프로필 이미지
라면2026.05.25

Hermes에도 soul.md 설정이 가능하군요!

좋은 경험 공유 감사합니다!

박승현 프로필 이미지
박승현2026.05.25

수고하셨습니다! 어서 청명이 믿고 일을 맡길 수 있는 에이전트로 성장하면 좋겠네요 ㅎㅎ

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

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

이런 사례도 있어요

사례 전체 보기