Hermes Agent를 Telegram에 연결하고 휴대폰으로 작업을 관리하는 방법

컴퓨터에서 떨어져 있을 때 휴대폰의 Telegram으로 Hermes Agent에 메시지를 보내거나 작업을 음성으로 지시하고, 같은 채팅에서 결과를 받을 수 있습니다. 예약 작업의 결과는 한 번 지정해 둔 홈 채팅으로 도착합니다.

아직 Hermes가 없다면 이 에이전트가 무엇이며 설치하는 방법 가이드부터 시작한 다음, 돌아와 Telegram을 연결하세요.

자세한 안내는 Ailoot 문서에서 확인할 수 있습니다.

Hermes Agent를 Telegram에 연결하려면 무엇이 필요한가요?#

hermes doctor 명령은 Hermes 설치 상태와 모델 연결을 확인합니다. Telegram 앱에서 봇을 만들며, 터미널에서 명령을 실행할 컴퓨터가 필요합니다.

BotFather를 통해 봇을 만드는 방법#

모든 Telegram 봇에는 봇을 제어하는 비밀 키인 토큰이 있습니다. 이 토큰은 Telegram의 공식 봇인 @BotFather가 발급합니다.

1. @BotFather 열기

   Telegram에서 @BotFather를 검색하거나 t.me/BotFather를 여세요. 실제 BotFather에는 파란색 인증 체크 표시가 있습니다. “Start”를 눌러 대화를 시작하세요.

2. /newbot 명령 보내기

   BotFather가 이름 두 개를 요청합니다. 첫 번째는 표시 이름으로, 예를 들어 “내 에이전트”처럼 무엇이든 가능합니다. 두 번째는 사용자 이름입니다. 고유해야 하며 bot으로 끝나야 합니다. 예: moy_agent_bot.

3. 토큰 받기

   BotFather가 축하 메시지와 123456789:ABCdefGHIjklMNOpqrSTUvwxYZ 형식의 긴 문자열을 보냅니다. 이것이 봇 토큰입니다. 문자열 전체를 복사하세요.

BotFather와 직접 대화하지 않아도 되는 빠른 방법도 있습니다. Hermes 웹 대시보드(hermes dashboard)와 데스크톱 앱의 “Messaging → Telegram” 페이지에 있는 “Create with QR” 버튼을 누르세요. 휴대폰으로 코드를 스캔하면 Hermes가 봇을 만들고 ID를 감지한 뒤, 설정에 토큰을 저장하고 게이트웨이를 다시 시작합니다. 아래 단계는 수동 설정 방법을 설명합니다. QR을 선택했다면 바로 연결 확인으로 넘어가세요.

Telegram ID는 어떻게 찾으며, 왜 필요한가요?#

Telegram 계정에는 두 가지 식별자가 있습니다. @ 기호가 붙은 공개 사용자 이름과 내부 숫자 ID입니다. Hermes는 숫자 ID를 사용합니다.

The quick “Create with QR” method described above detects your ID automatically. Write it down next to your token.

Hermes Agent에 토큰을 전달하고 게이트웨이를 시작하는 방법#

1. 설정 마법사 실행

   hermes gateway setup
   

   Hermes가 설치된 컴퓨터에서 명령을 실행하세요. 마법사가 메시징 앱 목록을 표시합니다.

2. Telegram을 선택하고 정보 입력

   마법사가 봇 토큰과 허용할 ID를 요청합니다. 여러 개를 입력할 수 있으며 쉼표로 구분합니다. 모든 정보는 설정에 직접 저장됩니다.

3. 게이트웨이 시작

   hermes gateway
   

   게이트웨이가 시작되어 Telegram에 연결됩니다. 몇 초 후 앱에서 봇에 아무 메시지나 보내세요. Hermes가 답하면 연결이 완료된 것입니다.

마법사 대신 수동으로 설정하려면 ~/.hermes/.env 파일을 열고 BotFather에서 받은 토큰과 숫자 ID를 넣어 다음 두 줄을 추가하세요.

TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ
TELEGRAM_ALLOWED_USERS=123456789

두 번째 줄은 개인 채팅과 그룹의 지정 사용자를 허용합니다. 별도의 그룹 채팅 허용으로 접근이 부여될 수도 있습니다. 여러 사람은 쉼표로 구분하세요. 파일을 저장한 뒤 동일한 hermes gateway 명령으로 게이트웨이를 시작합니다.

비공개 채팅에서도 봇이 응답하지 않으면 같은 터미널에서 게이트웨이 로그를 확인하고, 먼저 토큰과 접근 목록의 ID가 올바른지 확인하세요. 다른 오류는 이 글 끝의 표에서 다룹니다.

Telegram 봇으로 휴대폰에서 무엇을 할 수 있나요?#

휴대폰에서 가장 자주 사용할 기능은 다섯 가지입니다.

텍스트 및 음성 메시지. 말로 작업을 작성하거나 음성 메시지를 녹음해 보내세요. 음성 인식이 설정되어 있으면 Hermes가 이를 텍스트로 변환하고 이해합니다. 로컬 공급자를 사용하면 키가 필요하지 않습니다. 에이전트가 실행되는 컴퓨터에서 모든 처리가 이루어집니다.

파일 및 사진. 문서, 스프레드시트 또는 스크린샷을 봇에 전달하면 에이전트가 첨부 파일로 받습니다. 생성한 파일을 돌려보낼 수도 있습니다. 보고서를 요청하면 채팅에서 파일로 보내 줍니다.

위험한 작업에 대한 확인. 에이전트가 파일 삭제처럼 위험한 작업을 하려는 경우 먼저 채팅으로 묻습니다. “yes” 또는 “y”라고 답하면 실행하고, “no” 또는 “n”이라고 답하면 취소합니다.

직접 입력하는 대신 버튼 사용. 에이전트에 확인할 내용이 있으면 인라인 선택 버튼이 달린 질문을 보냅니다. 옵션을 누르면 에이전트가 작업을 계속합니다. 인수 없이 /model 명령을 입력하면 같은 종류의 버튼이 있는 모델 선택 메뉴가 표시됩니다.

조용한 알림. 기본적으로 최종 응답, 확인 요청, 명령 확인에만 휴대폰 벨이 울립니다. “도구 호출”이나 “컨텍스트 압축” 같은 서비스 알림은 소리 없이 도착하므로 매 단계마다 벨이 울리지 않습니다. 매 단계마다 알림음을 원한다면 설정에서 모드를 바꾸세요.

백그라운드 작업 결과를 채팅에서 받는 방법#

예약 작업을 위한 홈 채팅. Hermes는 “매일 아침 7:43에 요약을 작성해 줘”와 같은 예약 작업을 지원합니다. 봇과의 대화에서 /sethome 명령을 한 번 보내 홈 채팅을 지정하면, 작업 결과가 그곳으로 전송됩니다. 게이트웨이가 실행 중인 동안 요약이 자동으로 도착합니다.

백그라운드 작업. 긴 작업을 백그라운드에서 실행하도록 보내고 하루 일과를 계속할 수 있습니다. 작업이 끝나면 봇이 메시지를 보냅니다. 주제에서 시작한 작업은 같은 주제로 답변을 보내므로 결과를 놓치지 않습니다.

중요한 제한 사항: 게이트웨이가 실행 중일 때만 봇이 응답합니다. Hermes를 실행하는 컴퓨터를 끄거나 절전 모드로 전환하면 컴퓨터가 다시 작동할 때까지 봇은 답하지 않습니다. 봇을 항상 온라인 상태로 유지하려면 에이전트를 서버로 옮기세요. Hermes Agent를 24시간 계속 실행하는 방법에 대한 별도 가이드가 있습니다. 기본적으로 게이트웨이는 새 메시지를 받기 위해 Telegram을 폴링합니다. 수신 트래픽이 없으면 절전 상태가 되는 클라우드 플랫폼의 경우, 문서에서 웹훅 모드를 제공합니다. 이 모드에서는 연결 방향을 반대로 바꾸어 Telegram이 봇에 요청을 보냅니다.

낯선 사람이 봇을 사용하지 못하게 하는 방법#

사용자 이름으로 Telegram 검색에서 봇을 찾을 수 있으므로, 보호는 접근 목록과 토큰을 비밀로 유지하는 두 가지에 달려 있습니다.

먼저 TELEGRAM_ALLOWED_USERS로 발신자 접근을 설정하세요. 그룹에서는 TELEGRAM_GROUP_ALLOWED_CHATS도 확인하세요. 채팅을 여기에 넣으면 개인 허용 목록에 없는 발신자라도 모든 구성원이 허용됩니다. 개인 목록이 비어 있다는 것만으로 모든 그룹이 닫혔다고 볼 수 없습니다.

둘째, 토큰입니다. 스크린샷, 전달된 메시지 또는 저장소에 토큰이 노출되어서는 안 됩니다. 토큰이 유출되면 BotFather에서 /revoke 명령으로 폐기하세요. 그런 다음 설정에 새 토큰을 입력하고 게이트웨이를 다시 시작합니다.

그룹의 발신자 허용과 채팅 허용은 다릅니다. TELEGRAM_GROUP_ALLOWED_CHATS로 허용한 그룹의 구성원은 ID가 TELEGRAM_ALLOWED_USERS에 없어도 사용할 수 있습니다. 개인별 접근을 유지하려면 그룹 전체를 허용하지 말고 설치한 버전의 발신자 제한을 설정·검증하세요. 그룹에서 호출될 때만 봇이 응답하게 하려면 telegram.require_mention 설정을 사용하세요. 그러면 @멘션, 봇 메시지에 대한 답장, /command@yourbot과 같은 명령, telegram.mention_patterns에 지정한 패턴과 일치하는 경우에 응답하고 일반 그룹 메시지는 무시합니다.

그룹에서 봇이 응답하지 않는 이유와 해결 방법#

새 Telegram 봇은 기본적으로 개인정보 보호 모드가 켜져 있습니다. Hermes 문서는 이 모드가 그룹에서 봇을 사용할 때 가장 흔히 혼란을 일으키는 원인이라고 설명합니다. 이 모드에서 봇은 / 명령으로 시작하는 메시지, 자신의 메시지에 대한 답장, 서비스 알림만 받습니다. 일반 그룹 메시지는 아예 받지 않습니다. Telegram이 해당 메시지를 봇에 보내지 않기 때문에 에이전트 설정으로 해결할 수 없습니다.

해결 방법:

1. @BotFather를 열고 /mybots를 보냅니다.
2. 봇을 선택합니다.
3. “Bot Settings” → “Group Privacy” → “Turn off”를 엽니다.
4. 봇을 그룹에서 제거한 다음 다시 추가합니다.

네 번째 단계를 놓치기 쉽습니다. 그러면 봇이 “여전히 응답하지 않는” 상태로 남습니다. Telegram은 봇이 그룹에 들어왔을 때의 개인정보 보호 설정을 기억하며, 봇을 그룹에서 제거하고 다시 추가하기 전까지 설정을 업데이트하지 않습니다.

개인정보 보호를 전역적으로 끄고 싶지 않다면 두 번째 방법이 있습니다. 봇을 그룹 관리자로 지정하세요. 관리자 봇은 개인정보 보호 모드와 관계없이 모든 메시지를 받습니다.

흔한 연결 오류와 해결 방법#

사람들이 Telegram의 Hermes Agent에 관해 자주 묻는 내용#

준비가 되면 Ailoot을 알아보세요.