2026년 Hermes Agent 설치를 따라 하다 PATH·API Key·Telegram 그룹 무응답에 막힌 개발자를 위해 재현 가능한 가이드를 정리했습니다. 공식 curl 한 줄 설치부터 hermes setup 모델 설정, hermes gateway Telegram 연결, launchd/systemd 7×24 상시 구동까지 다루며 macOS·Linux·클라우드 Mac을 포함합니다. 다섯 가지 막힘, 네 플랫폼 비교표, 6단계 실습, 흔한 오류 대조표를 얻을 수 있습니다. 3계층 메모리, 30일 체험과 함께 읽으세요.
01

2026년 Hermes Agent란? OpenClaw와의 차이

Hermes AgentNous Research가 2026년에 공개한 MIT 오픈소스 자율 Agent입니다. 프로세스가 장기 상주하며 작업 성공 후 경로를 ~/.hermes/skills/ Skill로 저장해 유사 작업의 토큰 소비를 줄입니다. 일회성 ChatGPT 웹 대화와 달리 머신에 상주하는 엔지니어처럼 Telegram에서 지시를 받고 셸·검색·저장소 변경을 백그라운드에서 수행합니다.

OpenClaw와 비교하면 OpenClaw는 메시지 채널 Gateway와 workspace 파일 중심이며 openclaw CLI 생태계가 큽니다. Hermes는 Closed Learning Loop(자기 진화 Skill), 3계층 메모리(세션 / MEMORY.md / USER.md), MCP 확장을 강조합니다. LangGraph·CrewAI 같은 멀티 Agent 오케스트레이션과 달리 Hermes는 개인·소규모 팀의 단일 머신 상주 비서에 가깝고 진입점은 공식 스크립트 한 줄입니다.

본문은 「왜 7×24인가」(메모리 아키텍처 글 참고)를 반복하지 않고 설치·설정·Telegram 응답·서비스 상시에 집중합니다. macOS 로컬, Linux VPS/WSL2, KVMNODE 클라우드 Mac 프로덕션 배포를 가정합니다.

01

PATH 미갱신: 직후 hermes 입력 시 command not found. 셸 reload가 필요합니다.

02

API Key 누락: hermes setup·hermes model 생략 시 API key not set가 납니다.

03

노트북 절전: 덮개를 닫으면 Gateway가 종료되고 Telegram이 쌓이며 Skill은 늘지만 복리가 멈춥니다.

04

그룹 프라이버시: Bot은 기본적으로 / 명령만 응답합니다. BotFather에서 Group Privacy를 끄지 않으면 고장으로 오해합니다.

05

헤드리스 의존성: Linux에서 --skip-browser 없이 또는 시스템 Python 사용 시 ModuleNotFoundError가 잦습니다.

먼저 배포 평면을 고른 뒤 6단계 명령으로 진행합니다.

02

Hermes Agent는 어디에 둘까? MacBook, VPS, 월 대여 Mac Mini?

공식 설치 스크립트는 macOS와 Linux에서 가장 검증됩니다. uv, Python 3.11, Node.js 22, ripgrep, ffmpeg를 자동 설치하고 저장소는 ~/.hermes/hermes-agent/에 둡니다. API+Gateway만이면 4GB RAM으로 충분합니다. 로컬 모델·브라우저 자동화 Skill은 16GB 이상을 권장합니다.

배포 평면7×24 가용성공식 경로 완성도Skill 복리월 비용 체감
개인 MacBook절전 시 끊김(약60%)높음(macOS)잦은 중단하드웨어 0+운영 불안
Raspberry Pi 4B 8GB약88%Linux, Metal 없음I/O 병목하드웨어 일시
x86 VPS 4GB약99.5%Linux, macOS Skill 제한비교적 안정종량 과금
월 대여 Mac Mini M4데이터센터 SLA, 약100%최고(launchd+UMA)지속 누적고정 OpEx, 반납 가능

설치 가이드는 「돌아가게」 하고, 플랫폼 선정은 「얼마나 오래·Skill이 복리되는지」를 결정합니다. 프로덕션 Telegram 비서에는 macOS 전용 노드를 권장합니다.

03

한 줄 설치와 환경 점검: curl, doctor, setup

공식 권장 한 줄 설치(macOS / Linux / WSL2 / Termux):

shell
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.zshrc
hermes doctor
hermes --version

스크립트는 uv 설치, uv 경유 Python 3.11(sudo 불필요), Node.js 22·ripgrep·ffmpeg, ~/.hermes/hermes-agent/ 클론, hermes PATH 추가, 기본 Skills 레지스트리를 수행합니다. 성공 시 Hermes Agent installed at ~/.hermes 유사 메시지가 표시됩니다.

헤드리스 서버는 브라우저 스택을 건너뜁니다:

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

hermes doctor는 Python, Node, ripgrep, ffmpeg, PATH, API Key 등 10여 항목을 점검합니다. 모델 설정은 마법사 또는 개별 명령입니다:

shell
hermes setup
hermes model
hermes config set OPENROUTER_API_KEY sk-or-xxxx
hermes

키는 ~/.hermes/.env에 저장합니다. Nous Portal, OpenRouter, Anthropic, OpenAI, GitHub Copilot, Ollama 등을 지원합니다. CLI 대화 확인 후 Gateway를 켜는 흐름이 안전합니다.

팁: 업그레이드 후 Missing config가 나오면 hermes config check && hermes config migrate를 실행하세요. 시스템 Python 대신 ~/.hermes/hermes-agent/venv/bin/hermes를 사용합니다.

04

6단계로 Telegram 연결과 7×24 상시 구동

01

Bot 생성: Telegram @BotFather, /newbot, Token 기록. @userinfobot으로 숫자 ID 확인.

02

Gateway 마법사: hermes gateway setup에서 Telegram 선택, Token과 TELEGRAM_ALLOWED_USERS 설정.

03

포그라운드 시험: hermes gateway 실행 후 휴대폰으로 Bot에 메시지를 보내 응답 확인.

04

데몬 등록: macOS hermes gateway install && hermes gateway start. Linux는 sudo hermes gateway install --system 가능.

05

그룹(선택): BotFather에서 Group Privacy를 끄고 Bot을 제거했다가 다시 초대합니다. 그렇지 않으면 / 명령만 응답합니다.

06

클라우드 Mac 주문: 7×24·macOS Skill 경로가 필요하면 주문 페이지에서 전용 M4 월 대여 후 SSH로 동일 명령. 반납 전 ~/.hermes/ 아카이브.

shell
hermes gateway setup
hermes gateway install
hermes gateway start
hermes gateway status
journalctl -u hermes-gateway -f

클라우드 이전은 30일 이전 체크리스트를 참고하세요. skills, .env, config.yaml을 백업한 뒤 새 노드에서 재설치 후 디렉터리만 복원하면 됩니다.

05

환경 요건, Skill 복리, 흔한 오류

인용하기 쉬운 세 가지: ① 공식 스크립트는 Python 3.11 + Node 22 고정, Skills 캐시 포함 디스크 약 1.5GB, 로컬 모델은 20GB SSD+. ② 커뮤니티 보고에 Skill 히트 후 토큰 약 38% 감소 사례(전제: 호스트 7×24 온라인). ③ 2026년 6월 안정선은 v0.14.x가 많고 v0.15 후보 업그레이드 후 hermes config migrate 필수.

오류원인조치
command not foundPATHsource ~/.zshrc
API key not set모델 미설정hermes model
그룹 무응답프라이버시 모드BotFather Privacy 끄기, Bot 재초대
dotenv 누락시스템 Pythonvenv 내 hermes

대안 정리: 절전 MacBook은 설치되나 Gateway를 지키기 어렵습니다. 저가 Linux VPS는 Telegram은 되나 macOS 브라우저 자동화·Metal 로컬 추론이 없습니다. 라즈베리파이는 I/O·메모리가 긴 세션 SQLite에 부담입니다. KVMNODE 전용 Mac Mini M4 월 대여로 launchd 상시·UMA에 Gateway와 선택적 로컬 모델을 올리고 SSH에서도 로컬과 동일 절차로 설치할 수 있습니다. 월 OpEx로 30일 검증 후 구매 여부를 결정하는 것이 Skill 복리를 노리는 팀에는 「가끔 켜는 노트북」보다 현실적입니다. 요금은 요금 페이지, 인도·네트워크는 고객 센터를 참고하세요.