2026 Hermes Agent 설치 완전 가이드: curl 한 줄로 Telegram 24/7 Gateway（macOS / Linux / Mac 클라우드）

1. 이 가이드의 독자

이미 3층 메모리와 상시 호스트를 읽어 Hermes가 24/7을 요구하는 이유를 아는 분께—여기서는 방법에 집중합니다. 노트북에서 curl | bash만 끝낸 뒤 Gateway가 멈춘 경험이 있다면 특히 해당합니다. Hermes Agent 공식 한 줄 스크립트부터 스마트폰 Telegram 안정 응답, 새벽에도 Gateway가 살아 있는 상태까지. upstream install.sh, hermes doctor로 경고 제거, hermes setup / hermes model, BotFather, hermes gateway setup과 hermes gateway install을 다룹니다. macOS 실기·Linux VPS·SSH Mac 클라우드 모두 가능—Mac mini 소유는 전제가 아닙니다. 하드웨어 선정과 TCO는 라즈베리파이 / VPS / Mac mini 비교를 참고하세요.

2. curl 전 세 가지 페인

1. 설치는 되는데 Gateway가 안 뜸. API Key가 ~/.hermes/.env에 없거나 terminal.backend 오류, 다른 Agent와 포트 충돌로 hermes --version만 성공하고 Telegram은 무음.
2. Token은 30초, 프로세스는 자면 안 됨. BotFather는 빠르지만 long-polling/webhook은 Gateway 상시 가동이 필요—노트북 절전, 가정용 회선 흔들림, WSL2의 Windows 절전이 매일 끊깁니다.
3. Linux VPS는 «돌아가지만» macOS 워크플로와 어긋남. Linux에서도 20+ 채널과 일곱 터미널 백엔드를 쓰지만 Keychain·Xcode·Camoufox류 Skill은 네이티브 macOS나 임대 Mac이 유리합니다.

3. 환경 요건（최소 vs 권장）

헤드리스는 bash -s -- --skip-browser로 브라우저 자동화를 건너뛸 수 있습니다. Windows 네이티브는 미성숙하므로 WSL2 후 Linux 절차를 권장합니다.

4. 플랫폼 비교: MacBook / 라즈베리파이 / VPS / Mac mini 임대

표는 어디서 아래 Runbook을 돌릴지 판단용입니다. 프로덕션 Telegram 브리지는 «Linux VPS + systemd» 또는 «Mac mini M4 임대»로 수렴하기 쉽고, 출퇴근 노트북에 Gateway를 싣지 않습니다.

5. 인용 가능 스펙（2026）

• 커뮤니티: GitHub Stars 약 17만+（2026-06）, MIT, Nous Research 유지보수; 안정 v0.14.x, 후보 v0.15.0.
• 인스톨러: 공식 install.sh가 uv, Python 3.11, Node 22, ripgrep, ffmpeg를 설치하고 ~/.hermes/hermes-agent/에 배치, hermes를 PATH에 추가.
• 채널과 모델: 단일 Gateway에 20+ IM; OpenRouter 등 300+ 모델; Skill 히트 후 token 약 38% 절감 실측（상시 온라인 전제）.
• 터미널 백엔드: 문서상 일곱 모드(로컬 shell, Docker, SSH, Singularity, Modal, Daytona, Vercel Sandbox); 대부분 Telegram 사용자는 먼저 local로 두고 샌드박스가 필요할 때만 전환하세요.

위 수치는 하드웨어 3안 글의 TCO 표와 함께 인용하면 «왜 상시 가동이 필요한지»를 팀·재무에 설명하기 쉽습니다.

6. 일곱 단계 Runbook

단계 1 — 호스트와 기본 패키지

macOS는 xcode-select --install; Ubuntu/Debian은 curl git build-essential. Unix 사용자 hermes를 분리하고 프로덕션 서명 키와 섞지 마세요. GitHub raw와 LLM API HTTPS 출구를 확인합니다.

단계 2 — 공식 한 줄 설치

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.zshrc   # 또는 source ~/.bashrc
hermes --version

성공 기준: ✅ Hermes Agent installed at ~/.hermes. Mac 클라우드에서도 SSH로 동일 명령.

단계 3 — doctor와 설정

hermes doctor
hermes setup

hermes doctor는 Python·Node·PATH·API Key·ffmpeg 등 10여 항목을 점검. hermes setup으로 일괄 구성; 고급 사용자는 hermes model로 OpenRouter / Anthropic / Ollama 전환. 키는 ~/.hermes/.env에, 예: hermes config set OPENROUTER_API_KEY sk-or-xxxx.

단계 4 — 첫 CLI 대화

hermes

대화 셸에서 «이 디렉터리 파일 수 세기» 등을 시험해 툴체인과 라우팅을 확인합니다.

단계 5 — Telegram（BotFather）

Telegram에서 @BotFather → /newbot → Token 복사; @userinfobot으로 숫자 ID 확인.

hermes gateway setup

Telegram 선택 후 Token과 TELEGRAM_ALLOWED_USERS 입력. 그룹은 Group Privacy를 끄고 Bot을 제거했다가 다시 초대. 수동은 ~/.hermes/.env.

단계 6 — Gateway 상주 서비스

hermes gateway install
hermes gateway start
hermes gateway status

macOS는 launchd 사용자 서비스; Linux는 sudo hermes gateway install --system으로 부팅 등록, 로그는 journalctl -u hermes-gateway -f.

단계 7 — 인수 스모크

Telegram 전송은 1 RTT 안에 응답; 호스트 재부팅 후 재테스트; hermes cron으로 하트비트 가능. OS 업그레이드 전 ~/.hermes/ 암호화 백업.

보충: 모델 계층과 비용

hermes model list
hermes model set default openrouter/anthropic/claude-sonnet-4
hermes config set inference.ollama.base_url http://127.0.0.1:11434

실무에서는 «저렴한 모델로 의도 분류·짧은 답, 강한 모델로 다단계 Skill»이 정석입니다. Telegram 그룹에서 긴 툴체인이 잦으면 기본 라우팅이 너무 강하면 요금이 치솟습니다. cron과 대화 세션에 서로 다른 기본값을 두는 편이 사후 rate limit보다 안정적입니다. 로컬 Ollama는 16GB Apple Silicon에서 8B–13B 보조용이지만 Gateway와 동거 시 OS용 4GB 이상을 남기세요.

보충: Webhook과 long-polling

개인 Bot은 long-polling만으로 충분한 경우가 많고 공개 HTTPS가 필수는 아닙니다. 고정 도메인에서는 webhook으로 지연을 줄일 수 있으나 프로세스 24/7 요건은 동일합니다. 가정 NAT 뒤 webhook은 역프록시·인증서 갱신 부담이 커져 VPS나 Mac 클라우드 이전이 더 싼 경우가 많습니다.

6b. 키·권한과 OpenClaw 공존

Bot Token과 클라우드 API 키를 공개 Git에 올리지 마세요. 환경 변수나 macOS Keychain 주입을 권장; Linux는 ~/.hermes를 700으로 두고 서비스 사용자 hermes만 읽게 합니다. 같은 호스트에서 OpenClaw도 돌리면 포트 충돌에 주의(OpenClaw는 18789가 흔함). Hermes와 공존 가능하나 hermes doctor로 포트와 terminal.backend 덮어쓰기를 확인하세요. 프로덕션 Telegram은 TELEGRAM_ALLOWED_USERS로 본인 user id만 허용해 스캔된 Bot의 요금 폭주를 막습니다.

원격 Mac 클라우드는 Unix 사용자를 분리하고 SSH 키와 Apple ID를 섞지 마세요. 반납 전 플랫폼 삭제 절차와 ~/.hermes 백업 속 Token 삭제를 수행합니다. 노트북에서 DC로 옮길 때 이전 기기 launchd를 unload하지 않으면 동일 Token의 이중 Gateway가 «가끔 무응답»을 만듭니다.

7. launchd와 systemd

macOS（launchd）: hermes gateway install은 ~/Library/LaunchAgents/에 KeepAlive와 함께 기록됩니다. 채널·모델 변경 후:

hermes gateway restart
launchctl kickstart -k gui/$(id -u)/com.nousresearch.hermes.gateway
launchctl print gui/$(id -u)/com.nousresearch.hermes.gateway | grep state

로그는 ~/Library/Logs/hermes/에 두고 단일 파일 비대화를 막으세요. Screen Sharing 디버깅 시에도 SSH 외 불필요 개방은 피합니다.

Linux（systemd）: loginctl enable-linger hermes 후 systemctl --user enable --now hermes-gateway.service. systemctl --user status hermes-gateway로 active 확인. SSH 종료 후에도 유지되어야 합니다. VPS에 맞지만 Keychain·Xcode·Apple 알림 Skill은 macOS 노드에 남기고 Linux는 Gateway·API 추론에 집중하는 구성이 현실적입니다.

8. 오류 대조표

9. FAQ

WSL2는? 실험 가능; Windows 절전으로 24/7 Telegram은 불안정—Gateway는 다른 상시 호스트로.재부팅하면 Skill이 사라지나요? 디스크 Skill과 사용자 모델은 남고 프로세스 내 컨텍스트만 사라집니다—이전 전 ~/.hermes 백업.Telegram 필수? 아니요, Discord/Slack 등도 hermes gateway setup으로 가능; 검수는 BotFather가 가장 빠릅니다.

9b. 노트북에서 DC로 옮기는 최소 체크리스트

MacBook에서 CLI가 통과했다면 이 순서가 안전합니다. (1) 새 호스트에서 install.sh 재실행 또는 ~/.hermes rsync 후 hermes doctor; (2) BotFather Token은 재사용 가능하나 이전 launchd는 반드시 중지; (3) hermes gateway install 후 다른 계정·두 번째 폰으로 테스트해 로컬 잔여 세션 응답과 혼동 방지; (4) hermes gateway status 서비스명·로그 경로를 Runbook에 기록; (5) 첫 재부팅 후 cron 검증까지 7분 대기해 TZ/NTP 편차 제외. 마지막으로 플랫폼 비교표의 24개월 비용 감각과 실제 월 청구를 대조해 «설치는 되는데 유지가 안 됨»을 막습니다.

10. 결론

MacBook이면 오후에 1–5단계까지 가능하지만 절전과 가정용 회선으로 장기 Telegram 호스트에는 부적합합니다. 라즈베리파이는 저렴하지만 OOM; $5 VPS는 가동률은 좋으나 macOS 도구 부재; WSL2는 데스크톱 절전을 물려받습니다. curl | bash, hermes doctor 녹색, BotFather 성공 후 durable 해법은 잠들지 않는 하드웨어에 hermes gateway install—대부분 독자에게 Mac mini M4급 macOS（구매 또는 월 임대）.

출퇴근 노트북·저가 VPS·WSL2도 명령은 같지만 덮개·macOS 부재·절전으로 24/7에서 집니다. VPSMAC Apple Silicon Mac 클라우드는 월 고정비로 DC SLA·SSH·반납 시 삭제를 얻고 절차는 책상 Mac mini와 동일—셸만 데이터센터입니다. 한 줄 curl에서 새벽 3시 Telegram까지, 출퇴근 기기에 묶이지 않는 최단 경로입니다. Skill을 더 쌓으려면 3층 메모리 글로 하드웨어를 고른 뒤, 이 글로 Gateway를 잠들지 않는 노드에 고정하세요.