본문으로 건너뛰기

[Claude Code × Hermes] Gpters에서 배운 hermes, 6일 만에 내 일상을 아는 4봇 팀으로 만들었다

아레테_Arete

2026.06.04

[Claude Code × Hermes] Gpters에서 배운 hermes, 6일 만에 내 일상을 아는 4봇 팀으로 만들었다

📝 한줄 요약

Gpters 스터디에서 배운 hermes 에이전트를 실제 내 데이터(Notion 일정, Obsidian 노트, 승강기 안전 자료)에 연결해 6일 만에 텔레그램에서 작동하는 4페르소나 AI 봇 팀을 만들었다.

바쁘시면 이것만 읽어도 돼요:

  • Claude Code(우즈)와 함께 Hermes 에이전트 위에 4개 역할 봇 팀 구축 (아르케·소피아·필로스·에르곤)

  • Notion API 토큰이 있어도 봇이 접근 못 하는 문제 — 프레임워크 내부 버그였고, Python 래퍼로 우회

  • 텔레그램에 메시지 보냈더니 봇이 바로 답해줬을 때 "내가 만든 게 진짜 작동한다"는 실감

  • 스터디에서 배운 것과 내 실제 데이터에 연결해보는 건 완전히 다른 경험

  • 앞으로: 텔레그램 그룹에서 4개 봇이 협업하는 오케스트레이터 완성 예정

🎯 이런 분들께 도움돼요

  • Gpters 스터디에서 hermes를 배웠거나 관심 있는 분

  • AI 에이전트를 공부는 했는데 "내 생활에 어떻게 쓰지?"가 막히는 분

  • 앱을 여러 개 쓰는데 한 곳에서 해결하고 싶은 분

  • 비개발자인데 나만의 AI 비서를 직접 만들어보고 싶은 분

😫 문제 상황 (Before)

30년 가까이 안전 분야에서 일하다 보니 관리해야 할 정보가 세 곳에 흩어져 있었다.

개인 노트는 Obsidian, 일정·루틴 관리는 Notion, 업무 규정과 점검 자료는 따로 폴더. 뭔가 찾거나 기록하려면 앱을 세 개씩 열어야 했다. AI한테 물어보면 그날그날 맥락을 처음부터 설명해야 했고.

그러다 Gpters 스터디에서 hermes를 배웠다. "이거, 내 생활에 붙여볼 수 있겠다"는 생각이 들었다. 스터디에서 개념을 익혔으니 이제 실제로 써볼 차례였다.

🛠️ 사용한 도구

  • AI 코딩 도구: Claude Code (이하 "우즈"로 호칭)

  • AI 에이전트 프레임워크: Hermes Agent v0.14.0 (NousResearch)

  • 모델: Claude Haiku 4.5 (운영), Claude Sonnet 4.6 (코딩 작업)

  • 운영 환경: Windows 11 + PowerShell

  • 연동: Notion, Google Calendar, Obsidian, 텔레그램, 네이버 검색 API


🔧 작업 과정

4개 역할 봇을 설계하다 — 페르소나 나누기

첫날은 "어떤 봇을 몇 개 만들까"를 정하는 것부터 시작했다.

업무와 생활을 정리하고 나니 딱 네 가지 역할이 나왔다.

봇을 4개 만들려고 해. 아르케(라우터), 소피아(Obsidian 노트 관리),
필로스(Notion 일정 관리), 에르곤(안전업무 관련자료 전담). 
각각 역할을 명확히 나눠서 설계해줘.

우즈는 각 봇의 성격 설명서(SOUL.md)를 만들어줬다. 소피아는 Obsidian 폴더만, 필로스는 Notion DB만, 에르곤은 업무 자료 폴더만 건드릴 수 있게 딱 경계를 정했다. "다른 봇 영역은 절대 침범하지 말 것"이라는 규칙도 같이.

아르케는 이 셋을 중간에서 조율하는 라우터 역할. "Notion 일정 잡아줘"라고 하면 아르케가 필로스에게 일을 넘기는 구조다.


가장 오래 걸렸던 문제 — Notion이 왜 안 될까

Phase 2쯤에서 막혔다. 필로스가 일정을 물어봐도 계속 이상한 답을 했다.

필로스가 노션에 접근이 안 되는데
이 에러 메시지 좀 봐줘: NOTION_API_KEY unauthorized 401

처음엔 토큰이 잘못됐나 싶었다. 새로 발급받았다. 그래도 똑같았다. 환경변수 설정을 바꿔봤다. 그래도 안 됐다.

우즈가 며칠에 걸쳐 파고든 끝에 원인을 찾아냈다. hermes 프레임워크가 내부적으로 Notion API를 실행할 때, 환경변수를 그 실행 과정에 넘겨주지 않는 버그가 있었다. API 토큰이 있어도 실행되는 쪽에서는 "토큰이 없는 상태"였던 것이다.

해결책은 우회로를 만드는 것이었다. Notion API를 직접 다루는 작은 Python 서버를 따로 만들고, 토큰을 거기에 직접 넣어서 hermes가 그 서버를 통해 Notion에 접근하게 했다.

그냥 Python으로 Notion 연결하는 작은 서버 만들어서
hermes가 그걸 거쳐가도록 해줘. 토큰은 거기다 직접 넣는 거로.

이게 해결됐을 때 솔직히 허탈했다. 며칠 걸렸는데 원인은 내 잘못이 아니었다. 하지만 그 우회 구조 덕분에 오히려 더 안정적인 연결 방식이 됐다는 걸 나중에 알았다.


"오!" 했던 순간 — 텔레그램 봇이 답했다

4개 페르소나를 전부 세팅하고, 텔레그램 봇 토큰을 연결하고, 스크립트를 실행했다.

그리고 텔레그램에서 메시지를 보냈다.

[텔레그램에서] 안녕하세요

봇이 바로 답했다. 아르케로 설정한 봇이 "안녕하세요. 저는 아르케(ἀρχή)입니다. 요청을 말씀해 주시면 알맞은 페르소나에게 연결하거나 직접 안내해 드리겠습니다."라고.

내가 6일 동안 만든 것이 진짜 작동하고 있었다. 텔레그램이라는 익숙한 앱에서. 모바일로.

스터디에서 개념으로 봤던 hermes가 내 Notion 일정을 아는 봇이 된 순간이었다.


또 한 번 막힌 것 — 텔레그램 그룹 봇 문제

봇 4개를 텔레그램 그룹에 다 넣어서 서로 대화하게 하고 싶었다.

4개 페르소나를 한 텔레그램 그룹에 넣었는데
메시지 접근 권한이 없다고 해. 해결해줘.

우즈가 분석한 결과, 두 가지 벽이 있었다. 첫째, 텔레그램 봇은 기본적으로 그룹에서 자기 이름이 불릴 때만 메시지를 읽을 수 있다. 둘째, 봇은 다른 봇의 메시지를 아예 받을 수 없다. 텔레그램 정책이다.

봇 4개를 그룹에 넣는 방식은 원천적으로 안 되는 구조였다.

해결책은 발상을 바꾸는 것이었다. 4개 봇을 그룹에 넣는 대신, 아르케 봇 하나가 그룹에서 4개 페르소나를 모두 담당하게 했다. 사용자가 메시지를 보내면 아르케가 분석해서 관련 페르소나들의 답변을 차례로 보내주는 방식.

BotFather에서 아르케 봇의 "그룹 프라이버시 모드"를 끄는 설정 하나만 직접 하면 됐다.


마지막으로 — 아르케에 뉴스 검색 붙이기

아르케의 역할에 네이버나 다음 같은 국내 포털에 접근할 수 있도록 해줘

아르케가 라우터 역할을 하니까, 국내 뉴스나 정보를 찾을 때도 아르케가 검색해서 답해주면 좋겠다는 생각이 들었다.

우즈가 네이버 검색 API를 연결하는 모듈을 만들어줬고, 아르케한테만 붙였다. 이제 아르케는 뉴스·블로그·웹 검색도 할 수 있다.


✅ 결과 (After)

Before vs After

항목

Before

After

일정 확인

Notion 앱 열기 → 찾기

텔레그램에서 "오늘 일정 알려줘"

업무 자료 검색

폴더 뒤지기

텔레그램에서 "KoELSA 점검 기준 뭐야"

Obsidian 노트

직접 열어서 검색

텔레그램에서 소피아에게 요청

국내 뉴스 검색

포털 직접 접속

아르케에게 물어보기

AI 맥락 유지

매번 처음부터 설명

페르소나별로 역할 기억

결과물

  • 4-페르소나 Hermes 봇 시스템 운영 중

  • 텔레그램으로 언제 어디서든 접근 가능

  • Gpters 스터디에서 배운 내용을 실제 작동하는 시스템으로 구현

💬 이 과정에서 배운 AI 활용 팁

효과적이었던 것

  1. 단계를 나눠서 검증하기 — Phase 0(기본 실행) → Phase 1(페르소나 추가) → Phase 2(Notion 연결)처럼 하나씩 확인하면서 쌓았다. 한 번에 다 하려고 했으면 어디서 문제가 생겼는지 몰랐을 것이다.

  2. 에러 메시지 그대로 붙여넣기 — "왜 안 되지?" 혼자 고민하는 대신 에러 화면을 그대로 우즈에게 보여줬다. AI는 증상을 보여주면 원인을 찾아준다.

  3. "이렇게 했으면 어때?"를 물어보기 — Notion 연결이 안 될 때 우즈가 Python 래퍼 방식을 제안했다. 나는 방법을 몰랐지만 AI가 더 나은 경로를 알고 있었다.

이렇게 하면 안 돼요

  1. 처음부터 완벽하게 만들려 하지 말 것 — Day 1에 텔레그램 연동까지 다 하려고 했으면 지쳤을 거다. 먼저 기본 실행만 성공하고, 그 다음 단계로 가는 게 훨씬 수월했다.

  2. 문서만 읽고 이해됐다고 생각하지 말 것 — 스터디에서 hermes 개념을 배웠지만, 실제로 내 Notion 계정과 연결하는 건 완전히 다른 문제였다. 직접 부딪혀야 진짜 배운다.

🌍 다른 업무에 적용한다면?

이 방식은 hermes가 아닌 다른 도구로도 비슷하게 만들 수 있다.

  • 소상공인 — 재고(스프레드시트), 예약(캘린더), 고객 문의(메모)를 봇 하나에서 처리

  • 연구자 — 논문 폴더, 아이디어 노트, 일정을 역할별 봇으로 나눠서 관리

  • 팀장 — 팀 일정, 업무 문서, 공지 채널을 텔레그램 봇 하나에서 조회

핵심은 "내가 자주 왔다갔다 하는 앱들을 봇 역할로 나누는 것"이다.

🚀 앞으로의 계획

두 단계가 남아있다.

1단계 — 텔레그램 그룹 오케스트레이터 완성 아르케가 그룹 채팅에서 소피아·필로스·에르곤을 차례로 불러서 협업하는 구조를 완성한다. 예를 들어 "다음 달 점검 일정 잡아줘"라고 하면, 아르케가 필로스(Notion 일정)와 에르곤(점검 기준)에게 각각 물어서 통합 답변을 내놓는 것.

2단계 — hermes 네이티브 텔레그램 모드 지금은 Python으로 따로 만든 텔레그램 브리지를 쓰고 있는데, hermes 자체에 텔레그램 연동 기능이 있다. 이걸 완전히 전환하면 Notion·Obsidian 같은 외부 도구를 텔레그램에서 직접 쓸 수 있게 된다.

📋 재사용 가능한 프롬프트

프롬프트 1: 페르소나 설계 요청

나는 [분야]에서 일하고 있어. AI 봇을 [개수]개 만들려고 하는데, 역할을 나눠줘. 각 봇이 담당할 데이터: [첫 번째 봇 - 어떤 자료], [두 번째 봇 - 어떤 자료]. 봇들이 서로 영역을 침범하지 않게 규칙도 같이 만들어줘.

프롬프트 2: 에러 해결 요청

[도구명]을 쓰는데 이런 에러가 났어: [에러 메시지 그대로 붙여넣기] 내가 시도한 것들: [시도 1], [시도 2]. 원인이 뭔지 분석해주고, 해결 방법을 단계별로 알려줘.

프롬프트 3: 단계별 검증 요청

지금 [현재 상태]까지 만들었어. 다음 단계로 넘어가기 전에 지금 것이 제대로 작동하는지 확인하는 방법을 알려줘. 확인이 되면 그 다음에 [다음 목표]를 추가해줘.

1

함께 이야기해요 1

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

아루나 프로필 이미지
아루나2026.06.05

단계를 나눠서 검증함으로인해 어디서 오류가 났는지 확인한다는 부분이 인상깊어요. 계획을 세워서 단계별로 체크하는것도 이런 부분 때문이죠.

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

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

이런 사례도 있어요

사례 전체 보기