Telegram으로 Hermes 연결하기
Telegram 연동은 Hermes를 “터미널 밖에서 말 걸 수 있는 봇”으로 만드는 단계입니다. 먼저 CLI와 대시보드가 잘 되는지 확인한 뒤 진행하세요.
먼저 준비할 것
초보자라면 먼저 휴대폰에 Telegram 모바일 앱을 설치하고 로그인하는 것을 추천합니다. 그다음 같은 계정으로 Mac 앱이나 웹에서도 열 수 있습니다.
Telegram 앱 설치
휴대폰에서 Telegram 앱을 설치하고 전화번호로 로그인합니다. 이후 Mac에서도 같은 계정으로 로그인하면 BotFather와 내 봇을 찾기 쉽습니다.
BotFather에서 봇 만들기
Telegram에서 @BotFather를 검색하고 /newbot을 보냅니다. 안내대로 봇 이름과 username을 정하면 bot token이 나옵니다.
/newbot을 보내 bot token을 받습니다.내 Telegram user ID 찾기
Telegram에서 @userinfobot에게 메시지를 보내면 숫자로 된 user ID를 알려줍니다. @username이 아니라 숫자 ID를 써야 합니다.
Hermes 설정 마법사 실행
아래 명령어를 터미널에 입력하세요. 선택지가 나오면 Telegram을 고르고, bot token과 숫자 user ID를 붙여넣습니다.
hermes gateway setup
잘 모르겠으면 이렇게 하세요
테스트로 Gateway 실행
Gateway를 실행한다는 것은 Telegram과 Hermes를 이어주는 연결 다리를 켠다는 뜻입니다. 설정이 끝나면 아래 명령어를 터미널에 입력하세요. 처음에는 백그라운드 서비스로 설치하지 말고, 터미널에 켜둔 상태로 테스트하는 게 안전합니다.
hermes gateway
정상이라면 터미널에 Telegram adapter가 연결되었다는 메시지가 보입니다. 그다음 Telegram에서 방금 만든 봇에게 “안녕”처럼 짧은 메시지를 보내보세요. 이때 BotFather 채팅방이 아니라, 내가 만든 봇 채팅방을 열어야 합니다.
계속 켜두고 싶을 때
테스트가 잘 끝난 뒤에만 서비스로 설치하세요. macOS에서는 launchd로 등록되어 터미널을 꺼도 Gateway를 켤 수 있습니다.
hermes gateway install
hermes gateway start
hermes gateway status
macOS에서 로그를 보고 싶으면 아래 명령어를 터미널에 입력합니다.
tail -f ~/.hermes/logs/gateway.log
Telegram에서 시켜볼 Todo 예시
아래 문장을 Telegram 봇에게 그대로 보내보세요. 브라우저 서칭은 “웹에서 찾아보고, 출처와 함께 요약해줘”처럼 요청하면 이해하기 쉽습니다.
웹에서 Hermes Agent의 Telegram 연동 문서를 찾아보고,
초보자가 따라할 순서로 5줄 요약해줘.
마지막에는 참고 링크도 같이 보내줘.
“최신 Hermes Agent Gateway 문서를 웹에서 찾아보고 핵심 명령어만 알려줘.”
“Telegram 봇과 Discord 봇 연동 차이를 표로 정리해줘.”
“내 Telegram 연동이 안 될 때 확인할 체크리스트를 만들어줘.”