헤르메스 텔레그램 연동 가이드

시도하고자 했던 것과 그 이유

브라우저 켜고 ChatGPT 탭 여는 게 은근히 번거롭더라구요. 특히 외근 중에 한 줄만 물어보고 싶을 때 모바일이 답답했어요.

그래서 평소 쓰는 메신저에 AI를 붙이고 싶었어요. 카톡은 봇 등록이 까다롭고, 디스코드는 폰에서 무겁고, 슬랙은 회사용이라 사적인 용도엔 부담돼서요.

남은 게 텔레그램이었어요. 봇 만들기 가장 쉽고, 가볍고, 알림 깔끔하고. @BotFather 라는 텔레그램 공식 봇으로 5분이면 내 전용 AI 봇이 생긴다는 게 결정적이었습니다.

목표: "폰에서 AI한테 말 걸 수 있게 만들기"

진행 방법: 도구와 프롬프트 활용

사용한 도구

• 헤르메스 에이전트 (Hermes Agent v0.14.0) — 로컬 Mac에서 돌아가는 AI 에이전트. 텔레그램/슬랙/디스코드를 한 번에 붙일 수 있어요.

• Claude Code (CLI) — 작업 전체를 옆에서 도와준 AI 코딩 어시스턴트

• 텔레그램 BotFather — 봇 생성·토큰 발급 담당

핵심 프롬프트

처음에 던진 한 줄:

헤르메스 설치했는데, 슬랙이랑 연동좀 해줄래

이 한 줄에서 시작해서 슬랙·텔레그램·디스코드까지 다 자동으로 셋업됐어요.

중간에 디버깅 도와달라고 던진 프롬프트:

3번은 했는데 확인 한번해줄래

Claude Code가 헤르메스 게이트웨이 로그를 뒤져서 모델 설정 문제까지 짚어줬어요. "Anthropic Claude API로 바꾸면 더 똑똑한 답변 나옵니다" 까지 자동 진단.

텔레그램 연동 4단계

1단계 — BotFather에서 봇 만들기

텔레그램 앱에서 @BotFather 검색 → /newbot → 봇 이름 + 사용자명 입력 → 토큰 발급

2단계 — 헤르메스 .env에 토큰 등록

~/.hermes/.env 파일에 3줄 추가:

7599322699:AAGw-Goz8gY1NedhZtokrP2jH_xxxxx

ALLOWED_USERS는 본인 텔레그램 ID예요. 안 넣으면 누구나 봇한테 말 걸 수 있어 위험합니다. 본인 ID는 텔레그램에서 @userinfobot 한 번 말 걸면 알려줘요.

3단계 — 게이트웨이 재시작

TELEGRAM_BOT_TOKEN=7599322699:AAGw-Goz8gY1NedhZtokrP2jH_xxxxx

TELEGRAM_ALLOWED_USERS=7499691954

TELEGRAM_HOME_CHANNEL=7499691954

이 한 줄이면 끝. 헤르메스가 자동으로 텔레그램 API에 접속하고 슬래시 명령어 30개를 등록합니다. 성공하면 이런 로그가 떠요:

hermes gateway restart

4단계 — 폰에서 봇한테 말 걸기

텔레그램 앱에서 본인 봇 검색 → /start → "안녕?" 던지면 끝.

결과와 배운 점: 시행착오와 개선

결과

이제 폰에서 텔레그램 앱 열고 봇한테 말 걸면 끝이에요. 외근 중에 "이메일 답장 초안 좀 써줘" 한마디면 답이 옵니다.

Before vs After:

시행착오

1. 모델이 약하면 봇도 멍청해진다 처음엔 가벼운 모델(gpt-5.4-mini)로 셋업했는데 답변이 짧고 무성의했어요. 같은 셋업이라도 모델만 Claude Sonnet/Opus급으로 바꾸면 훨씬 똑똑해진다는 걸 깨달았습니다.

2. 텔레그램은 쉬웠지만 다른 메신저는 함정이 있다 디스코드는 "Privileged Gateway Intents" 3개를 개발자 포털에서 켜야 메시지가 읽혀요. 이거 모르면 봇이 무반응. 텔레그램은 이런 설정 없이 바로 됐어요.

꿀팁

1. 메신저 봇 처음이면 무조건 텔레그램부터 디스코드/슬랙은 권한 설정이 미로 같지만 텔레그램은 BotFather가 다 해줍니다. 5분 컷.

2. .env 파일에 토큰 모아두기 헤르메스는 토큰을 .env에 추가하고 재시작만 하면 자동 연결돼요. 토큰 관리가 깔끔합니다.

3. ALLOWED_USERS 화이트리스트 꼭 걸기 토큰 노출 시 폭주 방지. 본인 user ID만 넣어두세요.

도움이 필요한 부분

• Anthropic API 결제 이슈: $5 충전이 안 되는데, 카드 3D Secure 문제인지 확실치 않아요. 해외 결제 팁 있으시면 공유 부탁드려요. 취소는 되는데 추가등록버튼 클릭이 안되더라구요. PC, 휴대폰 둘다!

앞으로의 계획

1. AWS Lightsail에 헤르메스 띄우기 — 노트북 꺼지면 봇도 죽어요. 클라우드에 24/7 띄울 예정.

2. Anthropic Claude API로 모델 업그레이드

3. 음성 입력 추가 — 텔레그램 음성 메시지 → 받아쓰기 → AI 응답 → TTS 답변까지

참고한 글과 자료

• [지피터스] AI 에이전트 셋업 가이드 — AWS Lightsail에 헤르메스 띄우는 전체 로드맵 https://pitch-touch-bab.notion.site/AI-345b8640666181b9ae33dafffad71327

• Telegram Bot API 공식 문서 — BotFather 명령어 정리 https://core.telegram.org/bots

• Hermes Agent 공식 문서 (로컬 ~/.hermes/HERMES.md)