H Hermes 튜토리얼
학습 순서 FAQ 처음으로
Telegram Guide

Telegram으로 Hermes 연결하기

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

Telegram 연동 시작하기

여기부터가 Telegram을 Hermes에 연결하는 본격적인 단계입니다. 초보자라면 휴대폰의 Telegram 앱으로 먼저 진행하고, 같은 계정으로 Mac 앱이나 웹을 함께 열어두면 복사와 붙여넣기가 편합니다.

1

Telegram 앱 설치

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

2

BotFather에서 봇 만들기

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

철자가 비슷한 봇이 많으니 @BotFather를 정확하게 입력하세요. 헷갈리면 https://t.me/BotFather 링크로 열면 됩니다.
BotFather는 Telegram에서 새 봇을 만들어주는 공식 관리자입니다. 여기서는 BotFather에게 /newbot을 보내 bot token을 받습니다.
bot token은 절대 공개하지 마세요. 토큰이 유출되면 다른 사람이 내 봇을 조작할 수 있습니다.
BBotFather
/newbot
좋아요. 새 봇의 이름을 보내주세요.
Hermes Helper
이제 username을 보내주세요. 예: hermes_helper_bot(내 봇의 id 로 희망하는 값을 입력해주세요)
hermes_helper_bot
완료되었습니다. 이 bot token을 Hermes 설정에 넣으세요.
(실제로는 bot token이 나옵니다. 예: 123456789:AA...)
참고 이미지: BotFather에게는 봇을 “만드는” 대화를 합니다.
3

내 Telegram user ID 찾기

Hermes는 “이 봇에게 말을 걸 수 있는 사람”을 숫자 user ID로 확인합니다. Telegram의 @username이나 전화번호가 아니라, 숫자로 된 ID를 써야 합니다.

철자가 비슷한 봇이 많으니 @userinfobot을 정확하게 입력하세요. 헷갈리면 https://t.me/userinfobot 링크로 열면 됩니다.
  1. Telegram 검색창에서 @userinfobot을 검색합니다.
  2. 채팅방을 열고 /start 또는 아무 짧은 메시지를 보냅니다.
  3. 봇이 알려주는 Id 항목의 숫자를 따로 복사해둡니다.
UserInfoBot 채팅에서 /start를 보내고 Id 항목의 숫자를 확인하는 Telegram 화면
실제 화면 예시입니다. 빨간 화살표가 가리키는 Id 옆 숫자를 Hermes 설정의 user ID로 사용합니다.
4

Hermes 설정 마법사 실행

이제 앞 단계에서 찾은 두 가지를 Hermes에 넣습니다. 하나는 BotFather가 준 bot token이고, 다른 하나는 @userinfobot에서 확인한 숫자 user ID입니다.

아래 명령어를 터미널에 입력하세요.

Telegram setup
hermes gateway setup
  1. 터미널에 선택지가 나오면 Telegram을 선택합니다. 잘 모르겠으면 화살표 키로 Telegram에 맞춘 뒤 Enter를 누르세요.
  2. Bot token을 물어보면 2단계에서 BotFather가 알려준 긴 문자열을 붙여넣습니다. 예: 123456789:AA...
  3. Allowed user ID 또는 user ID를 물어보면 3단계에서 @userinfobot이 알려준 숫자 ID를 붙여넣습니다. 예: 123456789
  4. 저장 여부를 물어보면 Enter를 눌러 기본값으로 진행합니다.
you@macmini ~ % hermes gateway setup
? Which messaging service do you want to set up?
❯ Telegram
? Paste your Telegram bot token
123456789:AA... ← BotFather에서 받은 bot token
? Paste your allowed Telegram user ID
123456789 ← user ID 찾는 봇에서 확인한 숫자
Telegram gateway configuration saved.

실제 화면은 조금 다를 수 있지만, bot token과 user ID를 지시에 따라 입력하면서 진행해주세요.

잘 모를경우 체크 리스트!

테스트로 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는 봇을 만들고 연동할 때만 사용합니다.

Gateway를 계속 켜두고 싶을 때

테스트가 잘 끝난 뒤에만 서비스로 설치하세요. 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를 나누는 프로필 기능을 보면 좋습니다.

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