H Hermes 튜토리얼
대시보드 장으로 돌아가기 학습 경로 보기 FAQ 보기 다음: 프로필 만들기
Telegram Guide

Telegram으로 Hermes 연결하기

Telegram 연동은 Hermes를 “터미널 밖에서 말 걸 수 있는 봇”으로 만드는 단계입니다. 먼저 CLI와 대시보드가 잘 되는지 확인한 뒤 진행하세요.

먼저 준비할 것

초보자라면 먼저 휴대폰에 Telegram 모바일 앱을 설치하고 로그인하는 것을 추천합니다. 그다음 같은 계정으로 Mac 앱이나 웹에서도 열 수 있습니다.

1

Telegram 앱 설치

휴대폰에서 Telegram 앱을 설치하고 전화번호로 로그인합니다. 이후 Mac에서도 같은 계정으로 로그인하면 BotFather와 내 봇을 찾기 쉽습니다.

2

BotFather에서 봇 만들기

Telegram에서 @BotFather를 검색하고 /newbot을 보냅니다. 안내대로 봇 이름과 username을 정하면 bot token이 나옵니다.

BotFather는 Telegram에서 새 봇을 만들어주는 공식 관리자입니다. 여기서는 BotFather에게 /newbot을 보내 bot token을 받습니다.
bot token은 절대 공개하지 마세요. 토큰이 유출되면 다른 사람이 내 봇을 조작할 수 있습니다.
BBotFather
/newbot
좋아요. 새 봇의 이름을 보내주세요.
Hermes Helper
이제 username을 보내주세요. 예: hermes_helper_bot
hermes_helper_bot
완료되었습니다. 이 bot token을 Hermes 설정에 넣으세요.
참고 이미지: BotFather에게는 봇을 “만드는” 대화를 합니다.
3

내 Telegram user ID 찾기

Telegram에서 @userinfobot에게 메시지를 보내면 숫자로 된 user ID를 알려줍니다. @username이 아니라 숫자 ID를 써야 합니다.

4

Hermes 설정 마법사 실행

아래 명령어를 터미널에 입력하세요. 선택지가 나오면 Telegram을 고르고, bot token과 숫자 user ID를 붙여넣습니다.

Telegram setup
hermes gateway setup

잘 모르겠으면 이렇게 하세요

테스트로 Gateway 실행

Gateway를 실행한다는 것은 Telegram과 Hermes를 이어주는 연결 다리를 켠다는 뜻입니다. 설정이 끝나면 아래 명령어를 터미널에 입력하세요. 처음에는 백그라운드 서비스로 설치하지 말고, 터미널에 켜둔 상태로 테스트하는 게 안전합니다.

Gateway foreground
hermes gateway

정상이라면 터미널에 Telegram adapter가 연결되었다는 메시지가 보입니다. 그다음 Telegram에서 방금 만든 봇에게 “안녕”처럼 짧은 메시지를 보내보세요. 이때 BotFather 채팅방이 아니라, 내가 만든 봇 채팅방을 열어야 합니다.

you@macmini ~ % hermes gateway
[Gateway] Starting Hermes Gateway...
[Gateway] Telegram adapter connected
[Gateway] Cron scheduler started
HHermes Helper Bot
안녕
안녕하세요. Hermes Gateway를 통해 연결되었습니다. 무엇을 도와드릴까요?
웹에서 Hermes Telegram 연동 문서를 찾아보고 5줄로 요약해줘.
헷갈리지 마세요. “안녕”은 BotFather가 아니라 내가 만든 봇에게 보내는거에요! BotFather는 봇을 만들고 연동할 때만 사용합니다.

계속 켜두고 싶을 때

테스트가 잘 끝난 뒤에만 서비스로 설치하세요. macOS에서는 launchd로 등록되어 터미널을 꺼도 Gateway를 켤 수 있습니다.

Install service
hermes gateway install
hermes gateway start
hermes gateway status

macOS에서 로그를 보고 싶으면 아래 명령어를 터미널에 입력합니다.

macOS logs
tail -f ~/.hermes/logs/gateway.log

Telegram에서 시켜볼 Todo 예시

아래 문장을 Telegram 봇에게 그대로 보내보세요. 브라우저 서칭은 “웹에서 찾아보고, 출처와 함께 요약해줘”처럼 요청하면 이해하기 쉽습니다.

Browser search prompt
웹에서 Hermes Agent의 Telegram 연동 문서를 찾아보고,
초보자가 따라할 순서로 5줄 요약해줘.
마지막에는 참고 링크도 같이 보내줘.
검색

“최신 Hermes Agent Gateway 문서를 웹에서 찾아보고 핵심 명령어만 알려줘.”

비교

“Telegram 봇과 Discord 봇 연동 차이를 표로 정리해줘.”

점검

“내 Telegram 연동이 안 될 때 확인할 체크리스트를 만들어줘.”

다음 페이지로 이어가기

Telegram 연결이 끝났다면, 다음에는 역할별로 Hermes를 나누는 프로필 기능을 보면 좋습니다.

역할별 프로필 만들기 페이지 열기