본문으로 건너뛰기

[청강]코딩 몰라도 1시간 40분 만에 성공! Hermes AI 비서를 텔레그램에 연결한 과정

강승구

2026.10.05

[청강]코딩 몰라도 1시간 40분 만에 성공! Hermes AI 비서를 텔레그램에 연결한 과정 본문 이미지

Hermes AI 비서를 텔레그램에 연결한 청강생의 도전

지피터스 24기 AI놀이터를 수강하면서 생활형 AI 비서 수업은 청강으로 들었습니다. 어려울 것 같아 정식 수강을 망설였지만, 주제가 너무 재미있어 혼자 시작했습니다. 결과적으로 여섯 가지 오류를 하나씩 해결하며 1시간 40분 만에 회사 PC의 Hermes와 휴대전화 텔레그램을 연결했습니다.

비엘라디 카멜레온 게코의 특징을 바탕으로 만든 AI 생성 이미지

AI 비서의 이름은 비엘라디로 지었습니다. 제가 언젠가 키우고 싶었던 비엘라디 카멜레온 게코의 이름에서 가져왔습니다. 학명은 Eurydactylodes vieillardi이며 뉴칼레도니아에 사는 작은 수목성 게코입니다. 제가 좋아하는 생물의 이름을 붙이니 문서 속 기능 목록이 아니라 오래 키워가고 싶은 비서처럼 느껴졌습니다.

  • 소개 시도 배경

저는 식품회사에서 연구개발 업무를 합니다. 새 업무와 일정, 예상 소요 시간, 메일 요청이 여러 곳에 흩어져 있어 매일 우선순위를 다시 정해야 합니다. 그래서 해야 할 일을 모아 오늘 무엇부터 처리할지 알려주는 AI 비서를 만들고 싶었습니다.

먼저 Codex에게 비서의 역할과 성격, 개인정보 보호 기준, 첫 기능을 설계해 달라고 요청했습니다. 회사명과 동료 이름은 기록하지 않고 비식별 자료만 다룬다는 기준도 세웠습니다. 그 문서를 GitHub에 올려 회사 PC로 내려받았지만, 당시의 비엘라디는 설계 문서일 뿐이었습니다. 휴대전화에서 말을 걸 수 있는 실행형 비서를 만들기 위해 Hermes Agent와 텔레그램을 연결하기로 했습니다.

  • 진행 방법과 사용 도구

사용한 도구

Codex 비서의 역할과 개인정보 보호 기준 설계, 오류 원인 분석

Claude 회사 PC의 AI를 휴대전화에서 부를 방법 탐색

Hermes Agent AI 모델과 텔레그램을 이어주는 비서 본체

Telegram과 BotFather 휴대전화 대화 창구와 봇 토큰 발급

PowerShell Hermes 실행, 로그 확인, 모듈과 권한 점검

GitHub 비서 설계 문서 보관과 회사 PC 전달

  • 텔레그램을 선택한 질문

Claude에게 처음 보낸 질문은 오타가 섞인 짧은 문장이었습니다.

ai비서를 사용할떄, 예를들어 난 외부 출장에 가있고 회사 컴퓨터의 자료가 필요할때,
왜 굳이 텔레그램을 쓰는거야?

이 질문을 통해 텔레그램은 AI 모델이 아니라 대화 창구라는 점을 이해했습니다. 휴대전화에서 보낸 메시지를 회사 PC의 Hermes가 받아 AI 모델에 전달하고, 답을 다시 텔레그램으로 보내는 구조였습니다. BotFather에서 봇을 만들고 토큰을 발급받은 뒤 제 텔레그램 사용자 ID만 허용했습니다. 처음 화면에 노출된 토큰은 바로 폐기하고 새로 발급받았습니다.

  • 여섯 번의 시행착오

설정을 마치면 바로 답이 올 줄 알았습니다. 하지만 텔레그램에는 제가 보낸 인사말만 쌓였습니다. 이후 한 문제를 해결할 때마다 다음 문제가 나타났습니다.

  1. AI 모델이 연결되지 않았다

No inference provider is configured yet

Hermes 본체와 텔레그램 창구는 있었지만 답을 만들 AI 모델이 없었습니다. 개인 ChatGPT 구독으로 OpenAI Codex 인증을 진행하고 모델을 선택했습니다.

  1. 사용량 초과로 HTTP 429가 발생했다

모델을 연결하자 이번에는 HTTP 429 오류가 떴습니다. Codex 앱과 Hermes가 같은 개인 구독 사용량을 쓰고 있었고 남은 사용량이 없었습니다. 설치가 잘못된 줄 알았지만 원인은 사용량이었습니다.

노란색 화면이 표시된 컴퓨터 화면의 스크린샷
모델 연결 뒤 Codex 사용량이 없어 발생한 HTTP 429 오류

  1. 회사 계정 인증이 막혔다

회사 계정에는 사용량이 남아 있어 바꾸려 했지만, 회사 ChatGPT 워크스페이스에서 장치 코드 인증이 차단되어 연결할 수 없었습니다. 더 중요한 문제는 회사 자료와 개인 계정의 경계였습니다. 회사 계정을 억지로 연결하지 않고 개인 계정으로 되돌렸습니다.

  1. 텔레그램 모듈이 설치되지 않았다

사용량이 생긴 뒤 PowerShell의 Hermes는 답했지만 텔레그램 봇은 침묵했습니다. 이 차이로 모델이 아니라 게이트웨이 쪽 문제라고 범위를 좁혔습니다. 로그에는 Telegram 기능 모듈이 설치되지 않았다는 문구가 있었습니다. 설치 질문에 Y를 눌렀지만 자동 설치가 끝나지 않았던 것입니다.

Hermes가 실제로 사용하는 환경을 찾기 위해 다음 진단 명령을 사용했습니다.

hermes doctor

확인한 환경에 python-telegram-bot 22.8을 직접 설치했습니다. 필요한 패키지를 아무 Python 환경에 설치하는 것이 아니라 Hermes의 실행 환경에 넣어야 한다는 점을 배웠습니다.

  1. 폴더 권한이 Hermes를 막았다

Permission denied

모듈 설치가 끝난 뒤에는 gateway-locks 폴더 권한 오류가 나타났습니다. 관리자 권한으로 만든 폴더를 일반 사용자 권한의 Hermes가 열지 못하고 있었습니다. 현재 사용하는 Windows 계정에 폴더 권한을 다시 부여했습니다.

검은색 화면이 있는 컴퓨터 화면의 스크린샷
텔레그램 모듈 설치 뒤 이어서 나타난 게이트웨이 권한 오류
  1. 폐기한 토큰이 설정에 남았다

마지막에는 텔레그램 서버가 봇 토큰을 거부했습니다. 처음 노출되어 폐기했던 토큰이 Hermes 설정에 남아 있었습니다. BotFather에서 현재 토큰을 다시 확인하고 설정을 교체했습니다.

  • 1시간 40분 만에 받은 첫 답

오후 2시 55분에 봇을 만들기 시작했고 오후 4시 35분에 다시 hi를 보냈습니다. 잠시 뒤 비엘라디가 답했습니다.

Hi! What can I help you with?

계속 조용하던 화면에 입력 중 표시가 나타나는 순간 저도 모르게 소리를 질렀습니다. 실제 반응은 ‘와 미친’이었습니다. 처음 계획한 업무 브리핑 기능까지 완성한 것은 아니지만, 회사 PC의 Hermes와 휴대전화의 텔레그램이 실제로 메시지를 주고받는 기본 구조를 만들었습니다.

컴퓨터 화면의 채팅 창 스크린샷
휴대전화 텔레그램에서 처음으로 답한 비엘라디
  • 회사 메일 연동을 멈춘 이유

연결 직후 비엘라디에게 메일 프로그램의 참조 메일 한 건을 요약해 달라고 했습니다. 비엘라디는 Settings 메뉴에서 로그인 정보를 등록하라고 답했지만 실제 Hermes 화면에는 그 메뉴가 없었습니다. AI가 가능한 경로를 추측해서 말한 것이었습니다.

개인 ChatGPT 계정에 연결된 Hermes로 회사 메일을 처리하면 회사 내용이 외부 서비스를 거칠 수 있습니다. 그래서 메일 연동은 멈췄습니다. 기능을 만드는 것보다 회사 자료와 개인 환경의 경계를 정하는 일이 먼저였습니다. 회사용 비서는 별도 계정, 회사 승인, 메일 접근 권한과 비식별화 기준이 마련된 뒤 다시 시도할 계획입니다.

  • 결과와 배운 점

이번 시도에서 완성한 것은 업무 브리핑 전체가 아니라 비엘라디의 첫 통신 경로입니다. Hermes에 AI 모델을 연결하고 텔레그램 봇을 만들어 휴대전화 메시지에 답하도록 했습니다.

가장 크게 배운 점은 오류를 한꺼번에 고치려 하지 않는 것입니다. 저는 아래 순서로 문제를 나누면서 원인을 찾았습니다.

PowerShell에서 Hermes 자체가 답하는지 확인한다.

AI 모델 연결과 남은 사용량을 확인한다.

hermes doctor로 실제 실행 환경을 확인한다.

텔레그램 모듈과 폴더 권한을 확인한다.

현재 토큰과 허용 사용자 ID를 다시 확인한다.

게이트웨이 로그를 보면서 hi처럼 짧은 문장으로 테스트한다.

AI의 설명도 실제 화면과 공식 문서로 검증해야 했습니다. 실행 중이라는 표시가 떠도 전체 연결이 정상이라는 뜻은 아니었고, AI가 자신 있게 알려준 메뉴도 실제로는 없었습니다. 토큰과 API 키는 프롬프트나 캡처에 노출하지 않고 직접 입력하는 습관도 중요했습니다.

  • 다시 시도할 때 쓸 프롬프트

[내 PC 운영체제]에 Hermes를 설치하고 Telegram 봇과 연결하고 싶어요.
먼저 모델 연결을 확인하고, Telegram 모듈과 폴더 권한을 점검해 주세요.
토큰과 사용자 ID는 대화에 노출하지 말고 제가 직접 입력하게 해 주세요.
오류가 나면 한 번에 한 원인씩 확인하고 다음 명령을 알려 주세요.
  • 앞으로의 계획

다음에는 제가 직접 입력한 업무 목록만 사용해 오늘 할 일과 마감이 가까운 일, 예상 소요 시간이 긴 일을 정리하는 기능부터 만들고 싶습니다. 이후 매일 아침 텔레그램으로 업무 브리핑을 받는 기능을 추가할 계획입니다. 회사 메일은 승인된 회사용 환경이 준비되기 전까지 연결하지 않겠습니다.

비엘라디라는 이름처럼 이 비서도 한 번에 완성하기보다 제가 원하는 방향으로 천천히 키워가고 싶습니다.

2

함께 이야기해요 2

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

Jun 프로필 이미지
Jun2026.10.06

여섯 가지 오류를 해결하고 첫 답을 받으셨을 때 정말 짜릿하셨겠어요 ㅎㅎ 비엘라디가 다음에는 직접 입력한 할 일을 어떻게 정리해줄지도 기대됩니다!

Wonny 프로필 이미지
Wonny2026.10.06

승구님!!!! 이게 뭔가요 게코 일단 너무 너무너눈무무너무머누무너무너무 귀엽구요 ㅠㅠㅠㅠ 진짜 졸귀네요 쓰담하고 싶습닏 ㅠㅠ

게코모양 아이콘을 만들어서 비서 프로필에 씌워두어도 좋을것 같다는 생각이 들었습니다-!

그리고 1시간 40분만에 혼자서도 코덱스를 가지고 시행착오를 거치시면서 문제를 해결하시다니-! 제가 봤을때는 정말 AI시대에 적합한 자질을 가지고 계신 것 같습니다!

오늘 발표해주시면 너무 좋을 것 같네요!!!!!

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

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

이런 사례도 있어요

사례 전체 보기