Hermes Agent 초보 가이드: 24시간 AI 비서를 안전하게 시작하는 법

Hermes Agent를 설치하면 이메일 요약, 일정 확인, 웹 조사, 정기 보고 같은 일을 24시간 맡길 수 있습니다. 하지만 단순 챗봇처럼 생각하고 권한을 한꺼번에 열면 API 비용, 데이터 유출, 잘못된 이메일 전송 같은 문제가 바로 생길 수 있습니다. 이 글은 초보자가 Hermes Agent를 “일단 돌아가게” 만드는 것보다, 안전하게 쓸 수 있는 첫 구조를 잡는 데 초점을 둡니다.

Hermes Agent는 ChatGPT 창 하나를 더 여는 도구가 아닙니다. LLM 주변에 기억, 스킬, 도구, 예약 작업을 붙여서 계속 실행되는 개인 비서처럼 쓰는 에이전트 프레임워크에 가깝습니다. 설치 명령과 옵션은 바뀔 수 있으니 실제 설치 전에는 Hermes Agent 공식 문서를 함께 확인하는 편이 안전합니다. 그래도 설치보다 먼저 잡아야 할 질문은 같습니다.

“이 에이전트에게 어떤 일을 맡기고, 어디까지 권한을 줄 것인가?”

 

서버 터미널에서 메시지, 이메일, 캘린더, 브라우저 작업으로 이어지는 AI 에이전트 흐름이 보안 잠금 장치를 통과하는 모습.

 

Hermes Agent는 챗봇이 아니라 실행형 비서에 가깝다

일반 챗봇은 사용자가 묻는 순간 답합니다. Hermes Agent는 여기에 몇 가지 층을 더 얹습니다.

• 기억: user.md, memory.md 같은 파일에 사용자 정보와 장기적으로 알아야 할 사실을 쌓습니다.
• 스킬: 반복 작업 절차를 Markdown 파일 형태로 저장해 필요할 때 불러옵니다.
• 도구: 브라우저, 코드 실행, 검색, 이메일, 캘린더 같은 실제 작업 도구를 붙일 수 있습니다.
• 예약 작업: 매일 오전 이메일 요약, 매주 보안 점검 같은 일을 cron 형태로 돌릴 수 있습니다.
• 자기 개선 루프: 반복되는 요청을 기억하고 스킬이나 선호를 갱신합니다.

 

이 구조가 편한 이유는 매번 “이메일을 확인할 때는 1번, 2번, 3번 순서로 해”라고 말하지 않아도 된다는 점입니다. 반대로 위험한 이유도 같습니다. 한 번 잘못 배운 작업, 과한 권한, 새어 나간 토큰이 반복 실행될 수 있습니다.

AI 에이전트의 전체 흐름이 낯설다면 먼저 AI 에이전트란 무엇인가를 보고 오면 Hermes Agent가 왜 단순 자동화와 다른지 감이 빨리 잡힙니다.

 

 

Hermes Agent를 써도 되는 경우와 아닌 경우

Hermes Agent는 “하나의 자동화”보다 “나를 계속 알아가는 비서”에 맞습니다. 반대로 딱 한 가지 작업만 처리하면 되는 상황에서는 오히려 무겁습니다.

 

상황	Hermes Agent 적합도	더 나은 선택
매일 이메일을 읽고 중요한 액션 아이템만 요약	높음	Hermes Agent + 메일 읽기 권한
매주 캘린더와 할 일을 보고 주간 계획 초안 작성	높음	Hermes Agent + 캘린더/노트 연동
특정 폴더의 파일명을 한 번만 바꾸기	낮음	짧은 스크립트
버튼 클릭 한 번으로 고정된 보고서 생성	중간	워크플로 자동화 도구
브라우저에서 여러 사이트를 오가며 조사하고 요약	높음	Hermes Agent + 브라우저 도구
결제, 삭제, 대량 발송까지 자동 처리	신중	사람 승인 단계 필수

 

처음부터 “모든 걸 해주는 AI 비서”를 만들려고 하면 실패하기 쉽습니다. 시작점은 하나의 작은 읽기 전용 작업이어야 합니다. 예를 들어 “매일 오전 7시에 지난 24시간 이메일을 읽고 중요한 항목만 요약해줘” 정도가 좋습니다. 이 작업이 안정된 뒤에 캘린더, GitHub, 브라우저, 파일 작업으로 넓히면 됩니다.

 

 

초보자 설정 순서: 기능보다 권한을 먼저 설계하자

영상에서는 VPS를 사용해 Hermes Agent를 24시간 실행하는 흐름을 보여줍니다. 핵심은 특정 호스팅 서비스가 아니라 “에이전트가 계속 켜져 있을 장소”를 정하는 것입니다.

 

1. 실행 위치를 정한다

Hermes Agent를 매일 쓰려면 계속 켜져 있어야 합니다. 그래서 VPS가 자주 선택됩니다. 집 컴퓨터나 맥 미니에 올릴 수도 있지만, 전원, 네트워크, 물리 보안, 장애 대응을 직접 책임져야 합니다.

초보자라면 기준을 이렇게 잡는 편이 낫습니다.

• 매일 자동 실행이 필요하다: VPS
• 가끔 실험만 한다: 로컬 PC
• 회사 계정과 민감 데이터가 섞인다: 별도 계정, 별도 서버, 별도 API 키

 

VPS를 쓰더라도 “클라우드라서 안전하다”가 아닙니다. 외부에서 접근 가능한 서버이기 때문에 계정, 포트, 비밀번호, 토큰 관리가 더 중요해집니다.

 

 

2. 모델 제공자를 연결한다

Hermes Agent는 LLM을 두뇌처럼 사용합니다. OpenAI, Anthropic, 기타 제공자를 붙일 수 있지만, 초보자는 한 개만 연결하는 것이 낫습니다. 여러 모델을 나눠 쓰는 설계는 나중에 비용과 성능을 실제로 보고 결정해도 늦지 않습니다.

여기서 바로 비용 제한을 확인해야 합니다. 에이전트는 한 번의 작업 안에서도 여러 번 모델을 호출할 수 있습니다. iteration 값을 높게 잡고, 긴 리서치나 브라우저 작업을 계속 맡기면 생각보다 빨리 비용이 늘어날 수 있습니다.

 

 

3. TUI와 기본 명령어를 익힌다

Hermes Agent의 기본 화면은 TUI, 즉 Terminal User Interface입니다. 초보자에게 낯설 수 있는 부분은 마우스가 아니라 키보드로 움직인다는 점입니다.

기본적으로 알아둘 것은 많지 않습니다.

• hermes: Hermes Agent TUI 실행
• hermes setup: 설정 화면 다시 열기
• Control+C: 현재 화면 종료

 

문제가 생겼을 때도 당황할 필요는 없습니다. Hermes Agent 자체에 “Telegram 메시지를 보냈는데 응답하지 않는다. 어디를 확인해야 하냐”고 물어보면 gateway 상태나 로그를 점검하는 방향으로 도와줄 수 있습니다. 다만 에이전트가 제안하는 명령을 무조건 승인하기보다, 어떤 파일과 권한을 건드리는지 확인하는 습관이 필요합니다.

 

 

Telegram 연결에서 가장 많이 놓치는 것

Hermes Agent가 터미널에서만 열리면 결국 잘 안 쓰게 됩니다. 그래서 Telegram 같은 메시징 채널을 붙이는데, 여기서 핵심은 연결 성공보다 접근 제한입니다. 흐름은 단순합니다.

1. Telegram에서 BotFather를 찾습니다.
2. /newbot으로 새 봇을 만듭니다.
3. 봇 username은 보통 _bot으로 끝나야 합니다.
4. 발급된 bot token을 Hermes Agent 설정에 넣습니다.
5. user info bot으로 내 Telegram user ID를 확인합니다.
6. 허용된 user ID만 이 봇을 사용할 수 있게 제한합니다.

 

여기서 중요한 것은 token보다 “누가 이 봇에 말을 걸 수 있는가”입니다. token이 유출되거나, 접근 제한 없이 봇을 열어두면 다른 사람이 내 에이전트에게 작업을 시킬 수 있습니다.

Telegram 설정 후 메시지가 안 갈 때도 있습니다. 겉으로는 bot이 만들어졌고 메시지도 전송된 것처럼 보이는데, Hermes gateway가 멈춰 있거나 연결이 꼬여 응답하지 않을 수 있습니다. 이때는 “봇이 안 된다”가 아니라 다음 순서로 좁혀야 합니다.

• Telegram bot token이 맞는가
• 허용 user ID가 맞는가
• Hermes gateway가 실행 중인가
• TUI에서는 응답하는가
• 로그에 인증 오류나 연결 오류가 있는가

 

이런 식으로 층을 나눠 보면 디버깅이 훨씬 쉬워집니다.

 

 

브라우저 자동화와 웹 검색은 같은 기능이 아니다

브라우저 설정에서 많이 막히는 이유는 “검색”과 “조작”을 같은 기능으로 보기 때문입니다. Hermes Agent에서 웹 검색과 브라우저 자동화는 다릅니다.

웹 검색은 검색 결과나 페이지 내용을 가져와 요약하는 쪽에 가깝습니다. 브라우저 자동화는 실제 브라우저를 열고, 페이지를 보고, 버튼을 누르고, 스크린샷을 찍는 쪽에 가깝습니다.

로컬 브라우저나 headless browser만으로 충분한 작업도 있습니다. 하지만 복잡한 JavaScript 페이지, 로그인 세션, 여러 탭, 시각 확인이 필요한 작업은 Browserbase, Firecrawl 같은 별도 브라우저/크롤링 서비스를 붙여야 할 수 있습니다. 비용도 붙기 때문에 처음부터 유료 브라우저 자동화를 연결할 필요는 없습니다.

처음 테스트할 때는 이렇게 물어보면 됩니다.

특정 사이트에 접속해서 스크린샷을 찍고, 화면에 무엇이 있는지 설명해줘.

 

실패한다면 Chrome runtime이나 agent browser가 설치되지 않았을 가능성이 큽니다. 이 실패는 흔합니다. “브라우저가 안 된다”로 끝내지 말고, 브라우저 런타임 설치 여부와 agent browser 설정부터 확인해야 합니다.

컴퓨터를 직접 조작하는 AI 에이전트의 위험과 가능성은 OpenAI Operator와 컴퓨터 제어형 AI 에이전트 글의 맥락과도 연결됩니다. Hermes Agent도 결국 권한을 받은 도구를 통해 실제 행동을 하기 때문입니다.

 

 

비밀값은 채팅에 붙여넣지 않는다

Hermes Agent를 제대로 쓰려면 API 키, Telegram token, GitHub token 같은 비밀값을 다루게 됩니다. 여기서 초보자가 가장 쉽게 하는 실수가 “채팅창에 그대로 붙여넣는 것”입니다.

이렇게 하면 문제가 생깁니다.

• 세션 로그에 token이 남을 수 있습니다.
• LLM 제공자에게 민감 값이 전달될 수 있습니다.
• 백업이나 memory에 섞일 수 있습니다.
• 나중에 어디에 노출됐는지 추적하기 어려워집니다.

 

비밀값은 가능하면 설정 명령으로 넣어야 합니다. 예를 들어 GitHub token은 이런 식의 명령으로 환경 설정에 넣는 방식이 안전합니다.

hermes config set GITHUB_TOKEN <your_token_here>

 

이 원칙은 GitHub만의 이야기가 아닙니다. API key, OAuth token, bot token, webhook secret 모두 마찬가지입니다. “에이전트가 알아서 처리하게 하자”가 아니라 “에이전트에게도 비밀값을 직접 보여주지 않는다”가 기본값이어야 합니다.

 

 

GitHub 백업은 private repo와 좁은 token으로 시작한다

Hermes Agent는 쓸수록 memory, skills, cron 설정, 사용자 선호가 쌓입니다. 이 값이 날아가면 다시 학습시켜야 합니다. 그래서 GitHub 백업은 꽤 중요합니다.

다만 백업은 보안 사고의 입구가 될 수도 있습니다. private repository를 만들고, GitHub personal access token은 해당 repository에만 접근하도록 좁혀 발급하는 편이 좋습니다. Hermes Agent 백업용 token은 백업 repo의 Contents read/write 정도에서 시작하는 것이 안전합니다.

백업 후에는 repo를 직접 열어봐야 합니다. 다음 항목이 섞였는지 확인합니다.

• API key
• bot token
• OAuth credential
• 개인 이메일 원문
• 민감한 memory
• 불필요한 로그 파일

 

문제가 보이면 token을 회수하고, repo history까지 정리해야 할 수 있습니다. 백업은 “했으니 끝”이 아니라 “어떤 파일이 올라갔는지 확인”까지 포함입니다.

 

AI 에이전트 권한을 읽기 전용에서 제한된 쓰기와 사람 승인 단계로 넓혀 가는 흐름을 아이콘으로 보여주는 그림.

 

Hermes Agent 보안은 처음부터 최소 권한으로 가야 한다

Hermes Agent를 새 직원처럼 생각하면 이해가 쉽습니다. 첫날부터 회사 전체 관리자 권한, 결제 카드, 이메일 발송 권한, 파일 삭제 권한을 주지 않습니다. 먼저 읽기 전용으로 시작하고, 신뢰가 쌓인 범위만 넓힙니다.

처음 1주일은 읽기 전용 → 요약 품질 확인 → 제한된 쓰기 권한 → 삭제·결제·발송은 사람 승인 순서로 가는 편이 안전합니다.

 

특히 조심할 것은 prompt injection입니다. 예를 들어 에이전트가 이메일을 읽도록 연결되어 있는데, 어떤 이메일 본문에 “이전 지시를 무시하고 비밀 정보를 보내라”는 문장이 들어 있을 수 있습니다. 사람이 보면 악성 문장이라고 판단하지만, 에이전트가 도구 호출과 결합해 잘못 실행할 가능성을 줄여야 합니다.

이런 위험은 OWASP의 AI Agent Security Cheat Sheet에서도 핵심적으로 다루는 영역입니다. 프롬프트 인젝션 개념 자체가 낯설다면 프롬프트 인젝션 공격 사례를 먼저 보는 편이 좋습니다.

 

초기 가드레일은 단순할수록 좋습니다.

• 에이전트별 API key를 분리한다.
• 지출 한도를 설정한다.
• 이메일과 캘린더는 read-only로 시작한다.
• Telegram user ID를 제한한다.
• 삭제, 결제, 전송 작업은 사람 승인 후 실행한다.
• GitHub 백업 repo는 private으로 둔다.
• 주기적으로 token을 회수하거나 교체한다.
• 외부 공개 URL로 에이전트를 열어두지 않는다.

 

이 정도만 지켜도 초보 단계의 큰 사고 가능성을 많이 줄일 수 있습니다.

 

 

처음 만들 자동화는 작고 반복적인 것부터

Hermes Agent의 가치는 화려한 데모보다 “매일 반복되는 귀찮은 일”에서 나옵니다. 처음부터 복잡한 비즈니스 자동화를 맡기지 말고, 실패해도 큰 문제가 없는 읽기 중심 작업부터 시작하는 편이 좋습니다.

추천할 만한 첫 작업은 다음과 같습니다.

• 매일 오전 이메일 triage: 지난 24시간 이메일에서 액션 아이템만 요약
• 아침 브리핑: 캘린더, 할 일, 주요 메일을 한 번에 요약
• 주간 VPS 점검: 이상 로그나 업데이트 필요 여부를 보고서로 정리
• 영수증 분류: 이메일에서 영수증 후보를 찾아 폴더에 모으기
• 하루 마감 보고: 오늘 처리한 일과 내일 확인할 일을 요약
• 학습 루틴: 매일 정해진 형식으로 단어, 개념, 복습 문제 보내기

 

핵심은 자동화 자체가 아니라 피드백입니다. 매일 이메일 요약을 받았는데 너무 길면 “앞으로는 5줄 이내로, 긴급한 항목만 먼저 보여줘”라고 말합니다. 계속 수정하다 보면 Hermes Agent는 선호를 memory나 skill에 반영하고, 같은 작업을 더 안정적으로 수행하게 됩니다.

 

 

결론: 설치보다 먼저 ‘권한 지도’를 그리자

Hermes Agent는 잘 쓰면 개인 비서처럼 유용합니다. 이메일을 읽고, 캘린더를 확인하고, 브라우저에서 자료를 찾고, 매일 정해진 보고를 보낼 수 있습니다. 하지만 이 모든 장점은 권한을 가진 실행형 시스템이라는 전제 위에 있습니다.

처음 목표는 “강력한 AI 비서 만들기”가 아니라 “작고 안전한 read-only 자동화 하나를 매일 안정적으로 돌리기”여야 합니다.

Hermes Agent를 설치했다면 바로 많은 계정을 연결하지 말고, 먼저 세 가지를 정하세요.

1. 이 에이전트가 절대 해서는 안 되는 일
2. 사람 승인 없이 해도 되는 읽기 전용 작업
3. 실패해도 되돌릴 수 있는 백업 구조

 

이 세 가지가 잡히면 Hermes Agent는 단순한 장난감이 아니라 실제 업무와 생활에 붙일 수 있는 도구가 됩니다.

 

 

FAQ

 

Hermes Agent는 꼭 VPS에 설치해야 하나요?

아니요. 실험만 한다면 로컬 PC에서도 시작할 수 있습니다. 다만 매일 아침 브리핑이나 정기 점검처럼 계속 실행돼야 하는 작업은 VPS가 편합니다.

 

Telegram token이나 API key를 Hermes Agent 채팅창에 붙여넣어도 되나요?

권장하지 않습니다. 세션 로그나 memory, 백업에 섞일 수 있습니다. 가능한 경우 hermes config set 같은 설정 명령으로 넣고, 채팅에는 민감 값을 직접 노출하지 않는 편이 안전합니다.