헤르메스 에이전트,
20분 설치보다 먼저 정할 것
VPS를 결제하고 명령어를 붙여 넣는 일은 어렵지 않습니다. 진짜 설정은 어떤 모델에 비용을 지불할지, 텔레그램에서 누가 에이전트를 호출할 수 있는지, 그리고 어디까지 실행 권한을 줄지 결정하는 과정입니다.
모델과 도구를 연결하는 에이전트 실행 환경입니다.
Nous Research는 Hermes를 경험에서 스킬을 만들고 세션을 넘어 지식을 축적하는 오픈소스 에이전트로 설명합니다. 설치와 명령어는 빠르게 바뀔 수 있으므로 항상 공식 문서를 기준으로 확인해야 합니다.
먼저 구조부터: 텔레그램이 AI를 실행하는 것은 아닙니다
텔레그램은 에이전트에게 메시지를 전달하는 창구입니다. 실제 Hermes 프로세스는 내 컴퓨터나 VPS에서 실행되고, 선택한 AI 제공자에게 요청을 보내며, 필요한 경우 GitHub 저장소를 수정하거나 배포 작업을 수행합니다. 이 구조를 이해하면 어느 지점에 비용과 위험이 생기는지 보입니다.
20분 안에 설치할 수 있다는 말과, 20분 안에 안전한 AI 직원을 만들 수 있다는 말은 전혀 다릅니다.
설치 전에 고를 세 가지 실행 방식
내 Windows PC
- 시작 비용이 거의 없음
- 테스트와 학습에 적합
- PC를 끄면 에이전트도 멈춤
소형 VPS
- 24시간 메신저 연결 가능
- 개인 PC와 작업 환경 분리
- 월 비용과 서버 관리 필요
Hermes Desktop
- Windows·macOS 설치가 간단
- CLI와 데스크톱을 함께 사용
- 상시 운영에는 PC 전원 필요
처음부터 VPS를 결제할 필요는 없습니다. Windows에서 기능을 확인하고, 실제로 반복할 업무와 예상 모델 비용을 파악한 다음 VPS로 옮기는 편이 안전합니다. 반대로 텔레그램에서 하루 종일 호출해야 한다면 VPS가 구조적으로 더 자연스럽습니다.
현재 공식 설치 흐름은 더 단순해졌습니다
공식 문서는 Windows와 macOS에서 Hermes Desktop 설치 프로그램을 가장 쉬운 경로로 안내합니다. 명령줄만 사용하려면 Windows PowerShell용 설치 방식과 Linux·WSL2용 설치 방식이 별도로 제공됩니다.
실행 장소 결정
Windows PC, WSL2, Linux VPS 중 하나를 고릅니다. Native Windows와 WSL2의 데이터 위치가 다르므로 중간에 혼용하지 않는 편이 좋습니다.
공식 설치 프로그램 사용
검색 광고나 재배포 사이트가 아니라 Hermes 공식 홈페이지에서 설치 프로그램 또는 공식 명령을 확인합니다.
모델 제공자 설정
hermes model로 Nous Portal, OpenAI Codex, OpenRouter 등 사용할 제공자를 선택합니다.
상태 점검 후 게이트웨이 연결
hermes doctor로 기본 상태를 확인한 뒤 텔레그램 같은 외부 채널을 연결합니다. 설치와 외부 공개를 한 번에 진행하지 않는 것이 핵심입니다.
# 설치 명령은 운영체제별 공식 문서에서 복사 $ hermes setup $ hermes model $ hermes doctor $ hermes # 기본 대화가 정상일 때만 메신저 연결 $ hermes gateway setup
Codex 연결: API 키와 ChatGPT 구독 인증은 다른 경로입니다
Hermes 공식 제공자 문서에는 OpenAI API 키를 사용하는 직접 API 방식과 ChatGPT 계정의 기기 코드 인증을 사용하는 Codex 방식이 구분되어 있습니다. Codex 경로는 hermes model에서 ChatGPT 또는 Codex Subscription 항목을 선택해 인증합니다.
이미 Codex CLI 인증 정보가 있는 환경이라면 Hermes가 해당 자격 증명을 가져올 수 있지만, Hermes 자체 인증 저장소에도 별도로 보관됩니다. 토큰 갱신이 실패하면 무한 재시도하지 않고 재인증을 요구하도록 설계되어 있습니다.
텔레그램 연결에서 가장 중요한 값은 봇 토큰이 아닙니다
BotFather에서 받은 토큰은 봇을 작동시키지만, 누가 그 봇을 호출할 수 있는지는 별도 설정입니다. 공식 보안 문서는 허용 사용자 목록이나 일회성 페어링을 사용하고, 아무 설정도 없을 때는 기본적으로 미승인 사용자를 거부하도록 안내합니다.
공개하기 전에 반드시 확인할 네 가지
TELEGRAM_ALLOWED_USERS에 본인의 숫자 ID만 등록합니다.그룹 채팅에서는 사용자 허용 목록과 그룹 허용 목록이 별도로 작동합니다. 그룹 전체를 허용하면 모든 구성원이 에이전트를 호출할 수 있으므로, 개인용이라면 사용자 단위 허용이 더 보수적인 선택입니다.
GitHub와 Vercel은 마지막 단계입니다
랜딩페이지를 만들고 배포하는 데모는 결과가 눈에 보여 인상적이지만, 실제 흐름은 네 개의 권한이 연결되는 작업입니다. 에이전트의 파일 수정 권한, GitHub 저장소 쓰기 권한, Vercel 프로젝트 접근 권한, 모델 제공자의 인증이 모두 맞아야 합니다.
처음부터 운영 사이트에 배포 권한을 주기보다 별도 저장소와 Preview Deployment로 시작하는 편이 좋습니다. 에이전트가 만든 결과를 검토한 뒤 사람이 프로덕션 반영을 승인하는 구조가 실수 비용을 크게 줄입니다.
설치 전에 펼쳐보는 현실 체크
VPS 사양은 어느 정도가 필요할까요?
Hermes 자체와 메신저 게이트웨이만 운영할 때와 브라우저 자동화·컨테이너·여러 에이전트를 동시에 사용할 때의 요구량이 다릅니다. 가장 작은 요금제로 시작하되 메모리 부족과 디스크 사용량을 확인하고 올리는 방식이 합리적입니다. 영상에 나온 특정 VPS 상품을 모든 사용자에게 동일하게 권장할 수는 없습니다.
노트북을 꺼도 계속 작동하나요?
Hermes 프로세스가 VPS에서 실행 중이고 게이트웨이가 서비스로 유지된다면 가능합니다. Hermes가 내 PC에서만 실행 중이라면 PC를 끄는 순간 멈춥니다.
ChatGPT Plus만 있으면 별도 API 비용이 없나요?
Codex 구독 인증 경로와 OpenAI API 키 경로는 다릅니다. 선택한 제공자, 보조 모델과 도구 사용에 따라 별도 비용이 생길 수 있습니다. 현재 플랜의 한도와 Hermes의 실제 라우팅 정보를 각각 확인해야 합니다.
에이전트에게 GitHub와 Vercel 권한을 줘도 안전한가요?
권한 범위를 제한하고 별도 테스트 저장소와 미리보기 환경을 사용하면 위험을 줄일 수 있습니다. 비밀 키를 저장소에 넣지 말고, 운영 배포는 사람이 검토한 뒤 승인하는 방식을 권합니다.
그래서 누가 써볼 만할까요?
추천합니다
반복되는 조사·개발·콘텐츠 작업을 스킬로 축적하고 싶거나, 텔레그램에서 장시간 실행되는 개인 에이전트를 운영하려는 분께 매력적입니다. 모델과 도구를 직접 선택하고 운영 환경을 관리하는 과정도 즐기는 분에게 특히 잘 맞습니다.
먼저 데스크톱부터
터미널과 API 키, 서버 권한이 낯설거나 가끔 AI와 대화하는 것이 목적이라면 VPS보다 Hermes Desktop 또는 다른 완성형 앱으로 시작하는 편이 좋습니다. 상시 에이전트는 편리함만큼 관리 책임도 늘어납니다.
총평: 설치 속도보다 권한 설계가 성능을 결정합니다
Hermes Agent의 매력은 특정 모델 하나가 아닙니다. 대화를 이어가고, 경험을 스킬로 만들고, 메신저와 개발 도구를 하나의 작업 흐름으로 묶을 수 있다는 데 있습니다. Windows에서 실험한 설정을 VPS로 옮겨 24시간 운영할 수 있다는 확장성도 분명합니다.
하지만 모델, 메신저, 저장소, 배포 서비스가 연결될수록 실패 지점도 늘어납니다. 설치 명령이 정상 종료됐다는 사실은 시작에 불과합니다. 허용 사용자를 제한하고, 비밀 값을 분리하고, 테스트 저장소에서 검토하며, 비용 경로를 확인해야 비로소 쓸 수 있는 시스템이 됩니다.
따라서 첫 목표는 ‘20분 안에 랜딩페이지 배포’보다 ‘내 메시지만 받는 에이전트가 안전한 작업 폴더에서 한 가지 일을 끝내는 것’이 좋습니다. 그 한 단계가 안정되면 GitHub, Vercel, 자동화 순으로 넓혀도 늦지 않습니다.
- Hermes Agent 공식 문서 — 기능과 빠른 시작
- 공식 설치 가이드 — Windows·WSL2·Linux 설치 경로
- 공식 모델 제공자 문서 — OpenAI Codex와 API 방식 구분
- 공식 Telegram 가이드 — 게이트웨이와 허용 사용자 설정
- 공식 보안 가이드 — 페어링·허용 목록·기본 거부
- NousResearch 공식 GitHub 저장소 — 소스·라이선스·최신 명령
2026년 9월 2일 확인 기준입니다. Hermes Agent는 빠르게 업데이트되는 오픈소스 프로젝트이므로 실제 설치 전 공식 문서의 최신 명령과 지원 범위를 다시 확인하세요. 특정 VPS·모델·구독 상품의 협찬 글이 아니며, 영상의 문장이나 설정 순서를 복제하지 않은 독립적인 입문 분석입니다.