헤르메스 에이전트란? 초보자를 위한 설치·활용·기능 안내

AI를 활용하여 생성한 이미지입니다.

헤르메스 에이전트(Hermes Agent)는 질문에 답하는 챗봇에서 한 단계 더 나아가, 필요한 도구를 골라 웹을 찾고, 파일을 읽고, 명령을 실행하고, 결과를 정리하는 AI 에이전트예요. 공식 문서도 Hermes를 특정 IDE에 묶인 코파일럿이나 단일 API를 감싼 챗봇이 아니라, 도구와 기억을 사용해 작업을 이어 가는 자율형 에이전트로 설명하고 있어요.[1]

처음 접하면 기능이 많아서 무엇부터 눌러야 할지 오히려 막막해요. 설치부터 Telegram, MCP, Cron까지 한 번에 건드리면 문제가 생겼을 때 어디서 잘못됐는지 찾기도 어렵고요. 가장 좋은 시작은 간단합니다. 먼저 일반 대화를 한 번 성공시키고, 그 다음 파일·웹·기억·예약 작업을 하나씩 붙이면 돼요.[3]

처음 설치할 때는 무엇부터 할까?

macOS나 Windows에서는 공식 Hermes Desktop 설치 프로그램을 사용할 수 있고, 데스크톱 없이 명령줄만 설치하려면 공식 설치 안내에 나온 설치 방법을 따르면 돼요.[2] 설치가 끝난 뒤에는 hermes setup으로 모델과 기본 설정을 준비하고, 먼저 실제 대화가 한 번 정상적으로 끝나는지 확인하세요.[3]

처음부터 메신저·Cron·MCP를 함께 연결하지 않는 것이 좋아요. 일반 채팅이 작동하지 않는 상태에서 기능을 더 붙이면 인증 문제인지 모델 설정 문제인지 구분하기 어려워집니다. 공식 학습 경로도 설치, 첫 대화, 핵심 기능, 자동화와 통합을 단계별로 익히는 흐름을 제안해요.[4]

헤르메스 에이전트는 어떻게 이해하면 될까?

초보자라면 Hermes를 다음 다섯 가지가 붙어 있는 작업 도우미로 생각하면 편해요.

중요한 점은 Hermes가 알아서 모든 일을 안전하게 끝낸다는 뜻이 아니라는 거예요. 도구를 쓸 수 있는 만큼, 요청 범위와 승인 조건을 분명히 적어야 결과를 확인하기 쉬워요. 특히 파일 삭제, 공개 게시, 외부 서비스 변경처럼 되돌리기 어려운 작업은 결과를 읽어 보고 승인하는 흐름이 필요합니다.[11]

무엇을 할 수 있나요?

1. 웹 자료를 찾고 비교하기

Hermes에는 웹 검색과 페이지 내용 추출을 위한 도구가 있어요. 단순히 “이 제품이 좋아?”라고 묻는 대신, 공식 사양 페이지와 지원 문서를 찾아 비교표로 만들어 달라고 할 수 있습니다.[1][5]

공식 문서만 우선해서 찾아줘.
각 주장 뒤에 출처 링크를 붙이고,
확인하지 못한 내용은 추측하지 말아줘.
마지막에는 가격, 출시일, 호환성, 제한사항을 표로 정리해줘.

이런 요청은 검색 결과를 복사하는 데서 끝나지 않아요. 어떤 출처를 우선할지, 숫자와 날짜를 어떻게 확인할지까지 함께 정할 수 있다는 점이 중요해요. 다만 최신 가격이나 정책처럼 바뀌는 정보는 답변을 그대로 믿지 말고 링크를 직접 열어 마지막 상태를 확인하세요.

2. 파일과 폴더를 읽고 정리하기

파일 읽기, 검색, 수정, 터미널 실행 도구를 사용하면 문서 정리나 간단한 개발 작업도 맡길 수 있어요.[5] 예를 들면 여러 Markdown 파일에서 제목과 할 일을 모으거나, CSV의 열 구조를 확인하거나, 로그에서 오류 패턴을 찾는 식이에요.

이 폴더의 Markdown 파일을 먼저 목록으로 보여줘.
파일을 바로 수정하지 말고, 중복 제목과 빈 섹션 후보만 표로 정리해줘.
내가 확인한 뒤에 수정할게.

초보자에게는 “바로 고쳐줘”보다 “먼저 읽기 전용으로 점검해줘”가 더 좋은 시작이에요. 원본을 덮어쓰기 전에 백업 경로와 수정 범위를 정하고, 한두 개 파일로 시험한 뒤 전체에 적용하면 실수를 줄일 수 있어요.

3. 브라우저로 실제 화면을 확인하기

Hermes는 브라우저 이동, 화면 구조 읽기, 시각 확인을 지원해요. 따라서 웹페이지의 제목·본문만 읽는 데서 끝나지 않고, 링크가 보이는지, 이미지가 로드되는지, 모바일 화면에서 가로로 넘치는지 같은 확인도 할 수 있습니다.[1][5]

다만 로그인된 사이트를 다룰 때는 범위를 좁혀야 해요. “내 사이트를 전부 고쳐줘”보다 “이 URL 하나를 열고 제목과 대표 이미지가 보이는지 읽기 전용으로 확인해줘”처럼 요청하는 편이 안전합니다. 비밀번호와 일회용 인증 코드는 대화에 입력하지 마세요.

4. 글·표·코드 같은 결과물을 만들기

자료를 읽은 뒤 글을 쓰거나, 표와 목록을 포함한 문서로 만들거나, 코드를 작성하고 테스트하는 흐름도 가능합니다. 결과를 파일로 저장하고, 다시 읽어 오류를 찾고, 수정한 부분을 비교하는 식으로 이어 갈 수 있어요.

이때 “길게 써줘”만 적으면 일반적인 문장이 늘어날 뿐이에요. 독자, 분량, 출처, 포함할 표, 제외할 주장, 검수 기준을 함께 적어야 결과가 실제 용도에 가까워집니다.

초보자용 글로 작성해줘.
독자가 따라 할 수 있는 순서를 5단계 안으로 제한하고,
공식 문서에 없는 수치는 만들지 말아줘.
설정 전제 조건, 실패했을 때 되돌리는 방법, 비추천 상황을 넣어줘.
마지막에 후속으로 읽을 주제도 5개 제안해줘.

5. 메모리로 반복 설명 줄이기

Hermes의 메모리는 세션이 끝나도 일부 정보가 남도록 만든 기능이에요. 공식 문서에 따르면 사용자 프로필과 에이전트 메모는 정해진 크기 안에서 관리되며, 선호·프로젝트·환경처럼 다음 대화에서도 필요한 내용을 불러오는 데 쓰입니다.[6]

초보자가 저장하기 좋은 내용은 “한국어 존댓말을 선호한다”, “문서 작업은 먼저 초안과 검수를 거친다”, “macOS를 사용한다”처럼 오래 유지될 사실이에요. 반대로 일회성 비밀번호, 임시 작업 상태, 오늘의 할 일 목록은 메모리에 넣지 않는 편이 좋아요.

앞으로 한국어 존댓말로 답해줘.
설정 변경 전에는 현재 상태를 먼저 확인하고,
위험한 변경은 실행 전에 내 승인을 받아줘.
이 선호를 메모리에 저장해줘.

메모리는 장기 선호를 기억하는 기능이지, 모든 과거 대화를 완벽하게 저장하는 기능은 아니에요. 민감한 개인정보나 비밀값을 넣지 말고, 저장된 내용이 현재 요청과 맞는지 가끔 확인하세요.

6. 스킬로 전문 작업 절차 불러오기

스킬은 필요할 때 읽는 작업 지침 문서예요. Hermes 공식 문서는 스킬이 필요한 순간에만 로드되어 대화에 들어오는 정보량을 줄이고, agentskills.io 표준과 호환되는 구조라고 설명합니다.[7]

예를 들어 PDF 만들기, WordPress 관리, 로컬 이미지 생성, 코드 리뷰처럼 확인할 단계가 많은 작업은 스킬이 있으면 매번 절차를 처음부터 쓰지 않아도 돼요. 초보자는 먼저 어떤 스킬이 설치되어 있는지 확인하고, 작업을 시작하기 전에 “이 작업에 맞는 스킬을 적용해줘”라고 요청하면 됩니다.

스킬은 능력을 마법처럼 추가하는 파일이 아니에요. 도구가 없는 환경에서 스킬만 읽는다고 외부 사이트를 조작할 수 있는 것은 아니고, 위험한 명령을 스킬이 대신 승인해 주지도 않아요. 절차와 품질 기준을 불러오는 역할에 가깝습니다.

7. Telegram·Discord 같은 메신저에서 사용하기

메시징 게이트웨이를 설정하면 Hermes를 CLI나 데스크톱 앱에서만 쓰지 않고 Telegram, Discord, Slack, WhatsApp 등 여러 플랫폼에서 사용할 수 있어요. 공식 문서는 게이트웨이가 여러 메시징 플랫폼을 한 Hermes 인스턴스에 연결하는 구조라고 안내합니다.[1][8]

초보자는 먼저 로컬 대화가 정상적으로 작동하는지 확인한 뒤 메신저를 붙이세요. 연결 전에 허용할 사용자와 대화방을 정하고, 공개 그룹에서 누구나 명령을 보낼 수 있는 상태는 피해야 합니다. 메시지를 받을 수 있다는 것과 외부 계정의 파일·결제·게시 권한까지 열어도 된다는 것은 전혀 다른 문제예요.

8. Bot Mode로 역할별 에이전트 만들기

Bot Mode에서는 모델, 메모리, 스킬, 루틴과 대화를 가진 이름 있는 Bot을 만들 수 있어요. 한 Bot은 자료 조사에, 다른 Bot은 글의 구조 점검에 쓰는 식으로 역할을 나눌 수 있습니다.[9]

처음부터 여러 Bot을 만들면 관리할 설정이 많아져요. 먼저 하나의 Hermes에서 작업 흐름을 익힌 뒤, 반복되는 역할이 분명해졌을 때 Bot을 추가하는 편이 낫습니다. 예를 들어 “매일 뉴스 Bot”을 만들기 전에 먼저 같은 요청을 여러 번 실행해 필요한 출처·형식·전달 시각을 정리해 보세요.

9. Cron으로 정기 작업 예약하기

Cron은 일회성 또는 반복 작업을 예약하고, 결과를 원래 대화나 지정한 플랫폼·파일로 전달하는 기능이에요. Hermes 안에서 자연어 또는 cron 표현식으로 작업을 만들고, 일시중지·재개·수정·실행·삭제도 할 수 있습니다.[12]

매주 월요일 오전 9시에 지난주 작업 메모를 읽고,
완료되지 않은 항목과 이번 주 우선순위 3개를 정리해줘.
새 파일을 만들기 전에 기존 파일 목록을 먼저 보여줘.

예약 작업은 “등록됐다”와 “실제로 결과가 나왔다”를 구분해야 해요. 예약 시각에 컴퓨터가 꺼져 있거나 인증이 만료되거나 외부 서비스가 응답하지 않으면 실행이 중단될 수 있습니다. 첫 예약은 공개 게시나 삭제가 아니라 읽기 전용 요약처럼 실패해도 피해가 적은 작업으로 시험하세요.

10. Voice Mode로 말하면서 사용하기

Hermes는 CLI, Telegram, Discord 등에서 음성으로 상호작용하는 Voice Mode도 제공해요. 긴 메모를 말로 남기거나, 손을 쓰기 어려운 상황에서 간단한 확인을 요청하는 식으로 활용할 수 있습니다.[13]

음성으로 요청할 때도 텍스트와 같은 원칙을 지키세요. 파일을 바꾸거나 외부 서비스에 게시하는 요청이라면 대상과 승인 조건을 다시 말하고, 중요한 숫자·이름·경로는 실행 전에 화면으로 확인하는 편이 안전해요.

11. MCP로 외부 도구 연결하기

MCP(Model Context Protocol)는 Hermes 바깥에 있는 도구 서버를 연결하는 방식이에요. 공식 문서는 파일 시스템, GitHub, 데이터베이스, 브라우저 스택, 사내 API 같은 외부 도구를 MCP 서버로 연결하고, 서버별로 노출할 도구를 걸러낼 수 있다고 설명합니다.[10]

MCP를 쓰면 Hermes에 기능을 직접 개발하지 않고도 외부 도구를 사용할 수 있지만, 연결하는 서버의 권한을 반드시 먼저 확인해야 해요. 처음에는 읽기 전용 디렉터리나 테스트 저장소 하나만 연결하고, 쓰기·삭제·외부 전송 권한은 필요할 때만 열어 두세요.

초보자는 어떤 순서로 익히면 좋을까?

공식 빠른 시작 문서도 먼저 정상적인 채팅을 완성한 뒤 게이트웨이, Cron, 스킬, 음성, 라우팅을 단계적으로 추가하라고 권합니다.[3] 기능을 많이 켜는 것보다 한 가지 작업을 끝까지 확인하는 습관이 먼저예요.

처음 성공하기 좋은 실전 과제

과제 1. 폴더의 문서 목록 만들기

읽기 권한이 있는 테스트 폴더를 하나 정한 다음, 파일명·확장자·수정 시각만 표로 만들게 해보세요. 파일 내용 수정이나 삭제는 요청하지 않습니다.

이 폴더를 읽기 전용으로 살펴봐줘.
파일명, 확장자, 크기, 수정 시각만 표로 정리하고
파일 내용은 열지 말아줘.

과제 2. 공식 문서로 짧은 비교표 만들기

비교 대상 두 개와 공식 URL 우선 원칙을 정하세요. 결과에는 확인한 링크와 확인하지 못한 항목을 함께 쓰게 하면, 그럴듯한 추측과 확인된 사실을 구분하기 쉬워요.

두 공식 문서만 비교해줘.
가격·지원 운영체제·제한사항을 표로 만들고,
공식 페이지에서 확인되지 않은 항목은 “공식 수치 없음”이라고 적어줘.
출처 링크는 각 주장 가까이에 붙여줘.

과제 3. 반복 작업을 체크리스트로 바꾸기

매번 같은 순서로 하는 일을 말로 설명하고, Hermes가 실행 전 확인 목록과 실행 후 확인 목록으로 나누게 해보세요. 이 단계에서는 자동 실행보다 체크리스트 작성이 목적이에요.

과제 4. 작은 Cron 예약 만들기

처음에는 공개 글 작성이나 파일 삭제가 아니라, 매일 특정 폴더의 새 파일 개수만 알려주는 작업이 좋아요. 결과가 맞는지 며칠 확인한 뒤에 요약·정리 작업으로 확장하세요.[12]

잘못 맡기기 쉬운 일

• 비밀번호, API 키, OTP, 복구 코드를 대화에 붙여 넣지 마세요.
• 삭제·초기화·공개 게시·결제·권한 변경은 범위와 승인 조건을 먼저 적으세요.
• 웹 검색 결과의 숫자와 날짜는 원문 링크를 열어 확인하세요.
• AI가 만든 코드와 명령은 실행하기 전에 내용을 읽고 테스트 폴더에서 시험하세요.
• 메모리에는 오래 유지할 선호만 저장하고, 민감한 정보는 넣지 마세요.
• MCP 서버와 메신저 Bot에는 필요한 폴더·계정·도구만 연결하세요.
• Cron 작업은 예약 기록과 실제 실행 결과를 따로 확인하세요.

Hermes는 위험한 명령 승인, 파일 쓰기 안전장치, 컨테이너 격리, 메신저 사용자 인증, MCP 자격 증명 필터링, 프로젝트 파일의 프롬프트 인젝션 탐지 같은 여러 보안 계층을 제공해요.[11] 그래도 보안 설정이 사용자의 검토를 대신하지는 않습니다. 권한이 넓을수록 요청을 작게 나누고 결과를 읽어 보는 습관이 더 중요해져요.

기능보다 먼저 익혀야 할 요청 작성법

좋은 요청에는 적어도 다음 네 가지가 들어가요.

1. 목표: 무엇을 얻고 싶은지 한 문장으로 적어요.
2. 범위: 어떤 파일·URL·계정·기간만 볼지 제한해요.
3. 제약: 공식 출처 우선, 추측 금지, 공개하지 않기처럼 지켜야 할 조건을 적어요.
4. 검수: 결과를 어떤 형식으로 확인할지 정해요.

목표: 이 폴더의 오래된 문서를 정리할 후보를 찾고 싶어.
범위: /Documents/test 폴더 안의 .md 파일만 읽어줘.
제약: 파일을 수정·삭제하지 말고, 내용이 비슷하다는 판단에는 파일명을 함께 적어줘.
검수: 후보 목록을 먼저 보여주고, 내가 승인하기 전에는 아무것도 바꾸지 말아줘.

이 방식은 Hermes에만 해당하지 않아요. 사람이 직접 처리하더라도 목표와 범위를 먼저 적으면 실수가 줄어듭니다. 에이전트에게는 여기에 “어디까지 실행해도 되는가”를 한 줄 더 붙이는 것이 좋아요.

후속 글로 이어 가기 좋은 주제

정리

헤르메스 에이전트는 답변만 생성하는 도구라기보다, 대화 모델에 웹·브라우저·파일·터미널을 조합해 작업을 맡기는 환경에 가까워요.[1][5] 메모리와 스킬을 더하면 반복 작업의 맥락을 이어 갈 수 있어요.[6][7] Cron과 외부 연결을 붙이면 정기 작업으로 확장할 수 있습니다.[10][12]

초보자에게 맞는 순서는 기능 전체를 한꺼번에 켜는 것이 아니에요. 먼저 정상적인 대화를 만들고, 읽기 전용 웹·파일 작업을 해보고, 결과 형식과 검수 기준을 익힌 뒤 메모리와 스킬을 추가하세요. 그 다음에 Cron, 메신저, MCP, Bot Mode처럼 권한과 운영 부담이 커지는 기능으로 넘어가면 됩니다.[3][11]

처음부터 완벽한 자동화를 만들 필요는 없어요. 작은 과제를 맡기고, 결과를 확인하고, 잘 된 절차만 다음 작업에 재사용하는 방식이 Hermes를 가장 덜 어렵게 익히는 방법입니다.

관련 글

• AI · LLM 가이드 모음
• Claude 아티팩트 사용법, 채팅 답변을 문서와 코드로 다루는 순서
• AI API 키와 로컬 모델을 사용할 때 보안 구분

Sources

1. [1] Hermes Agent 공식 문서
2. [2] Hermes Agent 설치 안내
3. [3] Hermes Agent 빠른 시작
4. [4] Hermes Agent 학습 경로
5. [5] Hermes Agent 도구와 도구 모음
6. [6] Hermes Agent 메모리 시스템
7. [7] Hermes Agent 스킬 시스템
8. [8] Hermes Agent 메시징 게이트웨이
9. [9] Hermes Agent Bot Mode
10. [10] Hermes Agent MCP 통합
11. [11] Hermes Agent 보안
12. [12] Hermes Agent Scheduled Tasks (Cron)
13. [13] Hermes Agent Voice Mode