테스트 환경: Windows 11, Hermes Desktop v0.5.x 기준으로 작성되었습니다. 버전에 따라 일부 설정 항목이 다를 수 있습니다.
면책 문구: 이 설정은 작업 자동화의 안정성을 높이지만, 콘텐츠 품질이나 결과를 보장하지는 않습니다.
에르메스(Hermes)란?
에르메스(Hermes)는 로컬 환경에서 실행되는 오픈소스 AI 작업 자동화 에이전트입니다. 스케줄러, 메모리 시스템, 스킬(플러그인) 구조를 갖추고 있어 반복적인 작업을 자동으로 처리할 수 있습니다.
공식 문서 및 소스코드: Hermes GitHub 저장소
초기 설정을 그냥 두면 생기는 문제들
자동화 AI 에이전트 '에르메스(Hermes)'를 처음 설치하면 기본 설정 때문에 원하는 대로 작동하지 않는 경우가 많습니다. 이 글에서는 실제 작동 테스트를 기반으로 안정적인 자동화 환경을 구축하는 10가지 필수 설정을 소개합니다.
대표적인 초기 문제들:
- 시스템 재시작 후 이전 작업 맥락이 사라진다
- 스케줄러가 의도한 시간이 아닌 UTC 기준으로 실행된다
- 에러가 발생해도 알림이 오지 않아 작업 중단을 모른다
- 완료된 파일이 어디에 저장됐는지 찾기 어렵다
이 문제들은 모두 기본값 그대로 사용하기 때문에 발생합니다. 아래 10가지 설정으로 해결할 수 있습니다.
10가지 필수 설정 한눈에 보기
설정 상세 가이드
설정 1. 기억 저장소 절대 경로 지정
MEMORY_PATH
절대 경로를 지정하면 시스템 재부팅이나 업데이트 후에도 기억이 유지됩니다. 기본값은 임시 폴더를 사용하기 때문에 세션이 종료되면 이전 작업 내용이 모두 사라집니다.
MEMORY_PATH = C:/Users/이름/HermesMemory설정하면 작업의 연속성과 정확도가 향상됩니다. 특히 며칠에 걸쳐 진행하는 장기 작업에서 차이가 큽니다.
설정 2. 스케줄러를 내 지역 시간대로 설정
SCHEDULER_TIMEZONE
에르메스의 기본 시간대는 UTC입니다. 한국 기준으로 UTC와 9시간 차이가 나기 때문에, "오전 9시 실행"으로 설정해도 실제로는 오후 6시에 작동합니다.
SCHEDULER_TIMEZONE = Asia/Seoul시간대 설정이 정확하면 예약 작업이 의도한 시간에 실행되며, 외부 서비스와의 연동 시 타임스탬프 오류도 줄어듭니다.
설정 3. 재시작 없이 새로운 스킬을 즉시 인식하도록 자동 감지 켜기
SKILLS_WATCH
기본값 false 상태에서는 새 스킬을 추가해도 에르메스를 재시작해야 적용됩니다. true로 변경하면 스킬 파일이 변경되는 즉시 자동으로 감지합니다.
SKILLS_WATCH = true진행 중인 자동화를 중단하지 않고 기능을 확장할 수 있습니다.
설정 4. 작업 시작 시 규칙 파일을 미리 읽어오기
CONTEXT_FILES
매번 프롬프트에 규칙을 직접 입력하는 대신, 글쓰기 톤, 키워드 전략, 브랜드 가이드라인 등을 파일로 관리하고 자동으로 불러오게 설정합니다.
CONTEXT_FILES = [
"brand_guidelines.md",
"keyword_strategy.md",
"tone_of_voice.md"
]일관된 콘텐츠 톤앤매너 유지에 도움이 되며, 프로젝트마다 다른 규칙 세트를 교체하기도 쉬워집니다.
설정 5. 과거 기억을 참조하는 깊이를 5개에서 20개로 늘리기
MEMORY_RETRIEVAL_DEPTH
기본값 5는 최근 5개의 기억만 참조합니다. 20으로 늘리면 더 오래된 맥락까지 반영해 장기 프로젝트에서 의사결정의 일관성을 높여줍니다.
MEMORY_RETRIEVAL_DEPTH = 20값을 너무 크게 설정하면 응답 속도가 느려질 수 있습니다. 20을 기준으로 상황에 맞게 조정하세요.
설정 6. 결과물 저장 폴더를 지정 경로로 고정
OUTPUT_PATH
기본값은 에르메스 실행 폴더 내에 결과물이 저장됩니다. 절대 경로로 지정하면 어떤 환경에서 실행해도 항상 같은 위치에 파일이 저장됩니다.
OUTPUT_PATH = C:/Users/이름/ObsidianVault/Hermes-Output옵시디언(Obsidian) 볼트나 팀 공유 폴더 등 자신의 워크플로우에 맞는 경로로 지정하면 파일 관리 시간을 줄일 수 있습니다.
설정 7. 작업 완료 및 에러 발생 시 텔레그램 알림 받기
TELEGRAM_BOT_TOKEN, TELEGRAM_CHAT_ID
텔레그램 봇을 연결하면 작업 완료·에러 발생 시 모바일로 즉시 알림을 받습니다. 컴퓨터 앞에 없어도 작업 상태를 확인할 수 있습니다.
TELEGRAM_BOT_TOKEN = 여기에_봇_토큰_입력
TELEGRAM_CHAT_ID = 여기에_채팅_ID_입력
NOTIFY_ON_COMPLETE = true
NOTIFY_ON_ERROR = true텔레그램 봇 생성은 @BotFather를 통해 무료로 가능합니다.
설정 8. A 작업이 끝나면 B 작업이 자동으로 시작되는 스킬 체이닝
SKILL_CHAIN
여러 스킬을 순서대로 연결하면 사용자 개입 없이 작업이 이어집니다. 키워드 조사 → 초안 작성 → 저장 → 알림 순서를 한 번에 설정할 수 있습니다.
SKILL_CHAIN:
- keyword_research
- blog_draft_writer
- save_to_output
- notify_telegram단계별로 로그가 기록되므로, 어느 단계에서 문제가 발생했는지 추적하기 쉽습니다.
설정 9. 매일 밤 메모리 압축 스케줄 추가
MEMORY_CONSOLIDATOR_SCHEDULE
기억이 계속 쌓이면 불필요한 중간 과정 데이터가 판단에 영향을 줄 수 있습니다. 매일 새벽 핵심 정보만 추출해 압축 저장합니다.
MEMORY_CONSOLIDATOR_SCHEDULE = "0 3 * * *"
MEMORY_KEEP_TOP_N = 100장기적으로 에르메스의 응답 일관성을 유지하는 데 기여합니다.
설정 10. 에러 발생 시 자동 재시도 및 복구 불가 시 알림
SKILL_RETRY, ALERT_ON_FAILURE
API 오류, 네트워크 일시 장애 등으로 자동화가 중단되는 것을 방지합니다. 3회 재시도 후에도 실패하면 텔레그램으로 알림을 보냅니다.
SKILL_RETRY = 3
RETRY_DELAY_SECONDS = 60
ALERT_ON_FAILURE = true재시도 횟수를 너무 높게 설정하면 설정 자체가 잘못된 경우에도 반복 실행되어 시스템에 부하를 줄 수 있습니다. 3회가 일반적으로 적절합니다.
설정 후 기대 효과
자동화 활용 예시
예시 1: 콘텐츠 초안 작성 워크플로우
매일 아침 7시, 에르메스가 RSS 피드에서 키워드를 수집하고 Markdown 초안을 작성해 지정된 폴더에 저장합니다. 완료 알림을 받은 후 사용자가 직접 내용을 검토합니다.
예시 2: 멀티 포맷 콘텐츠 변환
긴 형식의 글 초안이 준비되면 SKILL_CHAIN으로 연결된 스킬들이 순서대로 짧은 소셜 포스트용, 영상 스크립트용으로 변환해 각각의 폴더에 저장합니다.
자주 묻는 질문 / 주의사항
Q. MEMORY_PATH에 잘못된 경로를 입력하면 어떻게 되나요?
에르메스가 시작 시 경로 유효성을 검사합니다. 잘못된 경로일 경우 기억 저장에 실패하고 임시 폴더로 fallback됩니다. 반드시 존재하는 폴더의 절대 경로를 입력하세요.
Q. SKILL_RETRY를 10으로 올려도 되나요?
권장하지 않습니다. 근본적인 설정 오류인 경우 10번 반복 실행되어 시스템 부하가 발생합니다. 3회 재시도 후 알림을 받고 수동으로 원인을 파악하는 것이 안전합니다.
Q. MEMORY_RETRIEVAL_DEPTH를 100으로 설정하면 더 좋은가요?
깊이가 깊을수록 응답 속도가 느려지고, 오래된 무관한 정보가 판단에 영향을 줄 수 있습니다. 20을 기준으로 상황에 맞게 조정하세요.
마치며
위 10가지 설정은 에르메스를 처음 설치한 뒤 반드시 확인해야 할 기반 설정입니다. 특히 메모리 경로, 시간대, 재시도 설정은 가장 먼저 적용하는 것을 권장합니다.