헤르메스 에이전트 설치 튜토리얼: VPS·도커 배포부터 슬랙 연동과 폴백 모델까지

핵심 메시지

• 24시간 켜둘 필요가 있는 에이전트는 장비 부담이 적은 VPS가 유리하며, 민감도·자동화 규모·운영 편의성을 기준으로 로컬과 나눠 쓴다.
• 호스팅어 VPS에 도커 매니저를 설치하고 원클릭 디플로이로 헤르메스 컨테이너를 올린 뒤, 터미널에서 풀 셋업으로 모델 프로바이더(오픈AI 코덱스)와 도구를 설정한다.
• 프로필을 클론해 정체성(soul.md)과 슬랙 매니페스트를 구성하고, 앱·봇 토큰과 멤버·채널 아이디 네 가지로 슬랙 게이트웨이를 연결한다.
• 파인그레인드 토큰으로 프라이빗 저장소 하나에만 접근하게 해, 스킬·메모리 변경 시마다 깃허브에 자동 백업하도록 구성한다.
• 코덱스 서버 장애나 구독 만료에 대비해 오픈라우터 기반 폴백 모델 체인을 설정해 두면 안정적으로 운영할 수 있다.

쉽게 이해하기

이 영상은 헤르메스 에이전트를 처음부터 끝까지 설치하는 튜토리얼로, 4~9단계는 로컬 PC나 클라우드에서도 동일하게 따라 할 수 있다고 안내한다. VPS는 데이터센터의 월세 컴퓨터에 비유되며, 발표자는 월 1만3천 원 수준의 호스팅어를 예로 든다.

먼저 로컬과 VPS 선택 기준을 설명한다. 카카오톡 연동이나 시스템 트레이딩처럼 규모가 크거나 내 기기에서 직접 자동화해야 하는 작업은 로컬이 낫고, PC를 꺼도 클라우드에서 에이전트가 돌아가야 하거나 간단한 테스트 자동화라면 VPS를 권한다. 호스팅어 전용 페이지에서 KVM2 플랜과 말레이시아 리전을 고르고 우분투로 진행한다.

설치는 도커 매니저 설치 → 원클릭 디플로이로 헤르메스 컨테이너 배포 → 터미널에서 셋업 명령으로 이어진다. 풀 셋업에서 가성비가 좋은 오픈AI 코덱스를 메인 모델로 인증하고, 헤드리스 크로미엄·이미지 모델·브레이브 서치 키 등 기본 도구를 설정한다.

다음으로 프로필을 클론해 캐릭터(예: 미카사)를 만들고, soul.md에는 정체성·목소리·소통 스타일만 남기도록 다듬는다. 슬랙 매니페스트를 write 명령으로 생성한 뒤 워크스페이스에 앱을 만들어 앱·봇 토큰을 발급하고, 멤버·채널 아이디를 포함한 네 가지 값으로 게이트웨이를 연결한다. 연결 중 도커 이미지 관련 에러가 나면 그 내용을 헤르메스에 그대로 던져 트러블슈팅을 요청할 수 있다.

운영 안정성을 위해 두 가지 장치를 추가한다. 하나는 깃허브 백업으로, 저장소 하나에만 접근하는 파인그레인드 토큰을 발급해 컨피그에 등록하면 헤르메스가 민감한 부분을 제외하고 스킬·메모리·매니페스트를 커밋한다. 다른 하나는 폴백 모델로, 오픈라우터에 소액을 충전하고 무료 또는 저렴한 모델을 폴백 체인에 추가한다. 다만 여러 스킬이 컨텍스트에 올라가는 작업에는 너무 싼 모델이 부적합하므로 적당한 모델을 쓰라고 조언한다.

주요 인사이트

• VPS와 로컬은 우열보다 용도의 문제로, 민감도와 자동화 규모, 24시간 가동 여부에 따라 선택하는 것이 합리적이다.
• 에러가 났을 때 그 메시지를 그대로 헤르메스에 넘겨 트러블슈팅을 맡기는 방식은, 설치 과정의 진입장벽을 크게 낮춘다.
• soul.md는 정체성·목소리·스타일만 남기고, 구체적인 업무 규칙은 스킬과 메모리로 분리하는 것이 권장된다.
• 단일 저장소만 접근하는 파인그레인드 토큰과 폴백 모델 체인은, 자동 백업과 모델 장애 대비라는 운영 리스크를 줄이는 핵심 장치다.

자주 묻는 질문

관련 AI 소식