헤르메스 AI 에이전트 구축 방법, 코딩 없이 Gemini로 설치하고 텔레그램·옵시디언 연동까지 총정리

업무 자동화를 해보고 싶어도 터미널과 파이썬이라는 말부터 막막하게 느껴질 수 있습니다.
그런데 헤르메스 AI 에이전트는 설치 중 생기는 오류를 Gemini에 그대로 물어보며 따라가면 비개발자도 구축해볼 수 있습니다.
핵심은 복잡한 코드를 직접 작성하는 것이 아니라, 화면과 오류 메시지를 정확히 전달하고 받은 명령어를 한 단계씩 실행하는 것입니다.
설치를 마치면 텔레그램에서 내 PC에 작업을 요청하거나 옵시디언 노트를 읽고 정리하는 개인용 업무 비서로 활용할 수 있습니다.

 

 

헤르메스 AI 에이전트는 무엇이 다를까요?

일반적인 챗봇은 질문에 답하는 데 그치지만, 로컬 에이전트는 사용자의 컴퓨터에서 파일을 찾고 수정하거나 명령어를 실행할 수 있습니다.
헤르메스는 모델과 대화하는 기능에 로컬 파일 작업과 자동화 기능을 연결하는 방식입니다.
따라서 반복 보고서 작성, 데이터 정리, 메모 저장처럼 실제 행동이 필요한 업무에 활용하기 좋습니다.

다만 내 PC를 직접 다룰 수 있다는 것은 그만큼 권한 관리가 중요하다는 뜻이기도 합니다.
처음부터 중요한 업무 폴더 전체를 열어두지 말고 테스트용 폴더에서 시작하는 것이 안전합니다.
API 키와 텔레그램 봇 토큰도 외부에 노출되지 않도록 별도로 보관해야 합니다.

 

 

“코딩을 몰라도 설치할 수 있을까요?”
명령어를 직접 만들 필요는 없지만, 오류 화면을 읽고 한 단계씩 확인하는 과정은 필요합니다.
막히면 오류 문구 전체를 Gemini에 전달하는 방식이 가장 현실적입니다.

 

 

윈도우에서 기본 설치부터 시작합니다

먼저 윈도우 터미널이나 명령 프롬프트에서 파이썬과 pip를 사용할 수 있는지 확인합니다.
준비가 끝났다면 pip install hermes-agent 명령으로 설치를 진행합니다.
설치 후 실행 파일이 윈도우 보안 정책에 의해 차단된다면 무리하게 보안을 해제하기보다 python -m hermes_agent 방식으로 실행해볼 수 있습니다.

실행 과정에서 영어 질문이 나오더라도 제공자, API 키, 모델, 작업 공간을 순서대로 선택하면 됩니다.
모델 제공자는 Google AI Studio의 Gemini 모델을 선택하고, 발급받은 API 키를 입력합니다.
API 키를 붙여넣었는데 화면에 글자가 보이지 않아도 보안 입력 방식일 수 있으니 한 번 입력한 뒤 엔터를 누르세요.

작업 공간은 내 PC에서 파일과 명령을 처리하려면 로컬 환경으로 설정합니다.
설정 화면의 모델 목록은 버전마다 달라질 수 있으므로 속도와 비용을 고려해 현재 제공되는 Gemini 모델 중 하나를 고르면 됩니다.

 

 

헤르메스 공식 페이지 확인하기

현재 제공되는 설치 방식과 운영체제별 안내를 먼저 확인하세요.

 

 

Gemini API 키를 연결하는 방법

Google AI Studio에 로그인한 뒤 API 키 메뉴에서 새 키를 발급합니다.
복사한 키는 메신저나 공개 문서에 적지 말고 개인 메모장이나 안전한 비밀관리 도구에 보관하세요.
헤르메스 초기 설정에서 해당 키를 입력하면 에이전트가 Gemini 모델을 이용해 답변과 작업 계획을 생성합니다.

텔레그램 연동 뒤 모델 오류가 발생한다면 C:\Users\사용자명\.hermes\ 폴더의 환경설정 파일을 확인합니다.
GEMINI_API_KEY 항목에 불필요한 공백이나 따옴표가 들어갔는지 살펴보고 수정한 뒤 서비스를 다시 실행하세요.
오류 내용을 임의로 줄이지 말고 전체 문장을 Gemini에 보여주면 원인을 찾기 쉽습니다.

 

 

Google AI Studio에서 API 키 발급하기

Gemini 모델 연결에 사용할 API 키를 생성하고 안전하게 보관하세요.

 

 

텔레그램을 연결하면 외부에서도 지시할 수 있습니다

텔레그램에서 BotFather를 이용해 새 봇을 만들고 발급된 토큰을 헤르메스 설정에 입력합니다.
이 토큰은 봇을 제어하는 비밀번호와 같으므로 화면 캡처나 블로그 글에 그대로 노출하면 안 됩니다.

그다음 userinfobot 등으로 본인의 숫자형 사용자 ID를 확인하고 허용 목록에는 내 ID만 등록합니다.
이 설정을 빼먹으면 다른 사람이 봇에 메시지를 보내 내 PC의 에이전트 기능에 접근할 위험이 있습니다.
자동화 완료 알림을 받을 홈 채널도 본인의 텔레그램 대화방으로 지정하세요.

PC를 켤 때마다 수동으로 터미널을 실행하기 번거롭다면 Gateway를 윈도우 예약 작업이나 백그라운드 서비스로 등록할 수 있습니다.
다만 충분히 테스트하기 전에는 자동 시작을 켜지 말고, 종료와 재실행 방법부터 익혀두는 것이 좋습니다.

 

 

나만의 업무 비서로 만드는 핵심은 Soul과 Skill입니다

설치만 마친 상태에서는 범용 에이전트에 가깝습니다.
사용자 폴더의 soul.md 파일에 담당 역할과 답변 기준을 적으면 업무 성격에 맞는 비서로 조정할 수 있습니다.
예를 들어 데이터 분석 담당자라면 오류율과 처리시간을 우선 검토하고, 결과를 근거와 함께 제시하도록 지시할 수 있습니다.

반복 작업은 자연어로 스킬 생성을 요청할 수 있습니다.
“JSON 로그를 읽고 실패율과 지연시간을 계산해 엑셀 보고서로 저장해줘”처럼 입력 파일, 처리 기준, 결과 형식을 구체적으로 말하는 것이 좋습니다.
처음 생성된 스크립트는 바로 실무 파일에 적용하지 말고 복사본으로 결과를 확인하세요.

 

 

옵시디언을 연결하면 장기 기억처럼 활용할 수 있습니다

옵시디언 보관함 경로를 환경설정에 지정하면 헤르메스가 마크다운 노트를 검색하고 내용을 추가하도록 구성할 수 있습니다.
텔레그램에서 회의 내용을 보내고 “오늘 데일리 노트에 요약해서 추가해줘”라고 요청하는 식입니다.
기존 파일을 통째로 다시 쓰게 하기보다 원문을 보존한 채 필요한 부분만 덧붙이도록 지시하는 것이 안전합니다.

옵시디언 플러그인을 이용하면 노트를 작성하는 도중 에이전트를 호출해 관련 과거 자료를 찾거나 다음 문단을 작성하게 할 수도 있습니다.
하지만 개인 기록이나 회사 기밀이 들어 있다면 접근할 폴더를 제한하고 백업을 먼저 만들어두세요.

 

 

옵시디언 공식 홈페이지 확인하기

로컬 마크다운 노트 환경을 설치하고 보관함 경로를 확인하세요.

 

 

로컬 AI 에이전트는 편리하지만 잘못된 명령도 실제 파일에 반영할 수 있습니다.
중요 폴더 백업, 최소 권한 설정, 사용자 ID 허용 목록을 먼저 챙기세요.

 

 

헤르메스 AI 에이전트 구축의 흐름은 어렵지 않습니다.
파이썬 설치, Gemini API 연결, 로컬 작업 공간 설정, 텔레그램 보안 연동, 옵시디언 경로 지정 순서로 진행하면 됩니다.
비개발자라면 한 번에 모든 자동화를 만들려고 하지 말고 파일 검색이나 메모 추가처럼 작은 작업부터 테스트하세요.
오류가 생길 때마다 화면과 메시지를 Gemini에 그대로 전달하면 설치 과정에서 헤매는 시간을 크게 줄일 수 있습니다.