Hermes Agent 설치 가이드 macOS Linux VPS Telegram 7×24 표지

2026 Hermes Agent 완전 설치 가이드: macOS / Linux / VPS에서 Telegram 7×24까지

Nous Research Hermes Agent는 GitHub 스타 수와「한 줄 설치」로 2026년 화제가 됐지만, 현장에서는 hermes: command not found, 모델 401, Telegram 무반응으로 막히는 경우가 많습니다. 이 글은 설치부터 Telegram 연결까지만 다룹니다. 공식 install.sh, ~/.hermes, hermes setup, BotFather TELEGRAM_BOT_TOKEN, hermes gateway install 순서로 따라 하면 첫날 Bot을 상시 가동할 수 있습니다. 영속 메모리·하드웨어 비교는 20260527·20260528 자매 글을 참고하세요.

1. 자주 막히는 세 가지

  1. PATH 미반영: ~/.local/bin 설치 직후 hermes 미인식.
  2. 대화형 셸만 Key: launchd 게이트웨이 401·침묵.
  3. 포그라운드만: 터미널 종료·절전 시 Bot 중단.

2. macOS / Linux / VPS 비교 매트릭스

항목 macOS(원격 Mac 포함) Linux / WSL2 클라우드 VPS
최소 16GB RAM, 30GB 디스크 2 vCPU·4GB, Ubuntu 22.04+ Linux 동급, swap 주의
권장 Mac mini M4 16~24GB, NVMe에 ~/.hermes 4 vCPU·8GB+ 고정 IP, 8GB+ 메모리
7×24 launchd + 절전 해제 systemd user unit 안정적, macOS 도구 없음
Telegram LaunchAgent EnvironmentVariables EnvironmentFile + daemon-reload HTTPS 또는 장시간 outbound

실험은 WSL2 가능. Telegram 장기 운영은 상시 Mac·고정 IP VPS 권장.

3. 1단계: install.sh 원클릭 설치

macOS·Linux·WSL2(sudo 불필요, ~/.hermes 저장):

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

성공: hermes --version, ~/.hermes/config.yaml. 30GB 여유.

4. 2단계: hermes doctor

hermes doctor

Node ≥ 20, 쓰기 권한, 포트 충돌 확인. PATH는 rc에 ~/.local/bin 추가.

5. 3단계: hermes setup LLM 설정

hermes setup

config.yaml에 OpenRouter·Anthropic·Ollama(127.0.0.1:11434) 설정. hermes chat "ping" 후 채널.

6. 4단계: Telegram BotFather

  1. Telegram에서 @BotFather → /newbot으로 Bot 생성, Token 발급.
  2. 환경 변수 설정(일반적으로 TELEGRAM_BOT_TOKEN):
export TELEGRAM_BOT_TOKEN="123456789:ABCdefGHIjklMNOpqrsTUVwxyz"

Token은 LaunchAgent·EnvironmentFile에. 교체 후 deleteWebhook·재시작.

7. 5~6단계: gateway install·7×24

hermes gateway install
hermes gateway start
hermes gateway status

macOS: launchd·절전 해제. Linux: loginctl enable-linger. Telegram 테스트·gateway status 검증.

8. 흔한 오류 표

증상 원인 조치
command not found PATH 미설정 ~/.local/bin 추가, doctor 재실행
401 unauthorized 데몬에 Key 없음 LaunchAgent/systemd 환경 변수
Telegram 무반응 Token 공백·Webhook 충돌 status 확인, deleteWebhook
install 실패 포트 점유 lsof로 해제, 비 root 재시도
SSH 끊기면 중단 데몬 미등록 gateway install 필수

9. FAQ

Q: curl | bash 안전? 저장·검토 후 실행.

Q: OpenClaw 공존? 포트·~/.hermes 분리.

Q: VPS만으로? Telegram+API면 대개 충분.

10. 정리 및 원격 Mac 안내

문턱은 데몬에 자격 전달과 24시간 가동. install → doctor → setup → BotFather → gateway → status.

SFTPMAC 원격 Mac mini M4 임대로 launchd·NVMe ~/.hermes·SFTP 확보. 하드웨어는 20260527·20260528 참고.