2026 Hermes Agent 설치 가이드: 한 줄 명령에서 Telegram 7×24 상시 운영까지

Hermes Agent는 2026년 2월 출시 이후 「작업 종료 시 Skill 자동 작성, 유사 작업에서 토큰 약 38% 감소」 관측으로 주목받았습니다. OpenClaw가 멀티 Agent 워크플로, LangGraph가 그래프 상태 기계에 가깝다면, Hermes 차별점은 네이티브 세션 간 메모리, 20개 이상 메시징 Gateway, MCP 즉시 연결입니다. Star 후 다음 세 단계에서 막히는 경우가 많습니다.

• 환경 파편화: Python 3.11, Node 22, ripgrep, ffmpeg를 먼저 깔아야 한다고 생각하지만, 공식 스크립트는 uv로 보완합니다. PATH를 새로 고치지 않으면 hermes: command not found가 납니다.
• 모델 미설정: 설치는 됐는데 API key not set. CLI는 열리나 추론은 안 됩니다.
• 게이트웨이 비상시: Telegram Bot은 설정됐는데 노트북 덮개를 닫으면 Bot이 죽고, Skill 복리와 주간 메모리가 끊깁니다.

한 줄로 말하면, 「설치 + 모델 + 상시 게이트웨이」를 하나의 파이프라인으로 볼 수 있는지가 Hermes를 매끄럽게 쓰는지의 기준입니다.

안정 라인은 v0.15.1(2026.5.29)이며, v0.15.0 loopback Dashboard 무한 새로고침 등을 수정했습니다(공식 Release). 아래 명령은 macOS / Linux / WSL2 기준입니다. Windows PowerShell은 공식 install.ps1을 쓸 수 있으나 Dashboard 채팅은 WSL2를 권장합니다.

공식 설치 스크립트의 필수 전제는 Git뿐입니다(git --version 동작). Python, Node, ripgrep, ffmpeg는 스크립트가 감지·설치하며 sudo는 필요 없습니다.

헤드리스 서버(GUI 브라우저 자동화 없음)는 --skip-browser로 Camoufox 관련을 피합니다. 설정은 ~/.hermes/.env와 ~/.hermes/config.yaml에 모읍니다.

macOS, Linux, WSL2 터미널에서 공식 스크립트를 실행합니다(설치 문서와 동일).

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

# headless VPS optional
# curl -fsSL ... | bash -s -- --skip-browser

source ~/.zshrc
hermes doctor
hermes --version
hermes setup
hermes

스크립트는 uv → Python 3.11 → Node.js 22 → ripgrep / ffmpeg → ~/.hermes/hermes-agent/ 클론 → hermes PATH 추가 → 기본 Skills 레지스트리를 수행합니다. 성공 시 터미널에 Hermes Agent installed at ~/.hermes가 표시됩니다.

1. curl 설치: Git 사용 가능 확인. 기업 프록시는 https_proxy 선설정.
2. 셸 새로고침: source ~/.zshrc 또는 source ~/.bashrc. 생략 시 command not found.
3. 헬스 체크: hermes doctor가 Python, Node, PATH, API Key 등 약 12항목 확인.
4. 버전 확인: hermes --version은 v0.14.x 이상 권장. 업그레이드는 hermes update.
5. 모델 설정: hermes setup 또는 hermes model로 ~/.hermes/.env 기록.
6. 스모크 대화: hermes 실행 후 현재 디렉터리 파일 수 집계나 당일 AI 뉴스 요약으로 도구 연동 검증.

단축 URL curl -fsSL https://get.hermes-agent.org | bash도 사용 가능합니다. Windows PowerShell은 iex (irm .../install.ps1), Android Termux는 Linux 스크립트와 동일하며 공식 Termux 안내가 있습니다.

휴대폰에서 Agent에 항상 닿으려면 Bot 생성, Gateway 설정, 시스템 서비스 등록 세 단계가 필요합니다.

1. Bot 생성: Telegram에서 @BotFather, /newbot. 사용자명은 bot으로 끝나야 합니다. Token 저장.
2. 사용자 ID: @userinfobot에 메시지해 숫자 ID를 화이트리스트에 사용.
3. 대화형 설정(권장): hermes gateway setup, Telegram 선택, Token·ID 붙여넣기.
4. 또는 .env 수동: TELEGRAM_BOT_TOKEN=..., TELEGRAM_ALLOWED_USERS=본인ID.
5. 포그라운드 테스트: hermes gateway, 휴대폰에서 Bot에 메시지해 응답 확인.
6. 백그라운드 상시: macOS는 hermes gateway install + hermes gateway start(launchd). Linux는 sudo hermes gateway install --system + systemd, 로그 journalctl -u hermes-gateway -f.

그룹 채팅: 기본 프라이버시 모드는 / 명령만 응답합니다. 그룹 사용 시 BotFather에서 Group Privacy를 끄고 Bot을 한 번보낸 뒤 다시 초대하세요. Discord / Slack도 hermes gateway setup으로 동일합니다(공식 메시징 문서).

hermes gateway install
hermes gateway start
hermes gateway status

# Linux boot autostart (optional)
sudo hermes gateway install --system
sudo hermes gateway start --system

• GitHub 규모(2026-06): 약 175,000 Stars, MIT, 기여자 295+ 수준(저장소).
• 설치 용량: Skills 캐시 포함 약 1.5 GB부터. ~/.hermes/는 3개월 운영 시 200–600 MB 증가가 흔합니다.
• Skill 복리: 30일 내 Skill 3 → 19 관측 시 유사 작업 토큰 약 38% 감소. 호스트 7×24 온라인이 전제입니다.
• 게이트웨이 RAM(macOS 요약): Gateway + SQLite만 약 1.2–1.8 GB. Ollama 8B 병행 시 24 GB 통합 메모리 권장.

선택 확장: ~/.hermes/config.yaml의 mcp_servers로 GitHub·DB 등 MCP 연결. GUI 없는 서버는 hermes mcp login + SSH 터널로 OAuth 완료.

노트북·오버셀 VPS의 흔한 약점: ① 게이트웨이 장연결 불안정(슬립, NAT, 이웃 IO), ② macOS 전용 브라우저 자동화 Skill은 순수 Linux에서 1:1 불가, ③ 전용 RAM 없으면 병렬 서브 Agent OOM, hermes doctor는 통과해도 프로덕션은 불안정합니다.

더 안정적인 경로는 JEXCLOUD 베어메탈 Mac Mini M4를 월 단위로 임대하고 SSH로 본문과 동일한 설치 명령을 실행하며 launchd KeepAlive로 Gateway를 상시 운영하고 ~/.hermes를 항상 임대 디스크에 두는 것입니다. 가상화 오버셀 없음, Telegram 인바운드 안정, 반납 전 rsync로 Skill·메모리 백업. M4.S / M4.M / M4.XL 선정은 요금 페이지, 주문·리전 지연은 주문 페이지와 고객센터를 참고하세요.