2026 Hermes Agent 설치·배포 가이드
macOS / Linux / Telegram Gateway 7단계로 7×24 상시 운영

대상: Nous Research / hermes-agent를 팔로우했지만 「설치 실패 / Gateway 중단 / Telegram 무응답」에 막힌 개발자.범위: 본문은 설치·검증·Gateway 상시·채널 연결만 다루며, 3계층 메모리 이론은 7×24 상시 가이드로 넘깁니다.결과: 공식 curl, hermes setup, hermes doctor, hermes gateway로 약 90분 안에 모바일 Telegram 응답을 받습니다.

Hermes Agent 설치 및 Telegram Gateway 상시 운영

2026년 6월, Hermes Agent(Nous Research, MIT)는 curl -fsSL https://get.hermes-agent.org | bash로 macOS/Linux에 CLI를 두고 Gateway로 Telegram에 연결합니다. 지속 메모리·호스트 선정, 30일 실측과 달리 본문은 설치 How-To입니다. 호스트 매트릭스, 7단계, 데이터 3개, 임대 전환을 담았습니다. 원격 macOS는 일일 Mac 임대 FAQ, 요금은 Mac mini M4 요금 안내를 보세요.

목차 · TABLE OF CONTENTS

  1. 01 설치 전 세 가지 막힘
  2. 02 호스트·환경 선정 매트릭스
  3. 03 7단계: curl → setup → doctor → gateway → Telegram
  4. 04 Telegram: BotFather, Token, hermes gateway
  5. 05 호스트 비교: MacBook / Linux VPS / Mac mini M4
  6. 06 설치 데이터 3개·흔한 오류
  7. 07 전환: Mac mini M4 일일 임대로 옮길 때

01. 설치 전 세 가지 막힘

  1. curl 중단·PATH 미반영: 프록시, 구형 bash, pip 구버전 혼용. get.hermes-agent.org만 쓰고 hermes doctor로 확인.
  2. Gateway 미상시: CLI만 실행, hermes gateway start/install 누락, MacBook 절전. systemd·LaunchAgent 필요.
  3. Telegram Token·allowlist 오류: Token 유출, export 누락, Bot Start 전 테스트. gateway 마법사 후 모바일 Start.
관련 글: 메모리는 상시 가이드, Skill은 30일 실측. 본문은 「설치·연결·24시간 수신」에 집중.

02. 호스트·환경 선정 매트릭스

호스트 설치 적합 주의
MacBook(검증) macOS curl 당일 CLI 절전 시 Gateway 중단
Linux VPS(2 vCPU / 4GB+) curl + systemd 저렴한 공인 IP 해제 전 ~/.hermes/ 백업
자체 Mac mini M4 get.hermes-agent.org 장기 7×24, Ollama 선택 가정망은 Tailscale 권장
MacDate M4 일일 임대 동일 macOS Telegram 검증 후 구매 반납 NIST 삭제—tar 필수

필요: LLM API 키, Telegram Bot Token, SSH(FAQ), 디스크 10GB+.

03. 7단계: curl → setup → doctor → gateway → Telegram

macOS/Linux 공통. 60~90분(재부팅 테스트 포함).

  1. 로그인·아웃바운드: curl -fsSLI https://get.hermes-agent.org.
  2. 공식 설치: curl -fsSL https://get.hermes-agent.org | bash, hermes --version.
  3. hermes setup: Provider·API 키, ~/.hermes/ 쓰기.
  4. hermes doctor: 경고 해소 후 진행. hermes memory status 선택.
  5. Gateway: hermes gateway setup → start 또는 install.
  6. Telegram: export TELEGRAM_BOT_TOKEN=..., hermes channels add telegram, 모바일 Start.
  7. 자동 시작·백업: launchd/systemd, 재부팅 ping, tar czf ~/.hermes/.
# 2~4 $ curl -fsSL https://get.hermes-agent.org | bash $ hermes setup $ hermes doctor # 5~6 $ hermes channels add telegram --token "$TELEGRAM_BOT_TOKEN" $ hermes gateway start $ hermes gateway status

04. Telegram: BotFather, Token, hermes gateway

@BotFather /newbot → 환경 변수 Token → allowlist에 본인 user ID → hermes gateway start. 대부분 롱폴링 아웃바운드만으로 inbound 포트 불필요. Token은 API 키와 동급 보호.

05. 호스트 비교: MacBook / Linux VPS / Mac mini M4

「설치됨」과 「7×24 적합」은 다릅니다. MacBook은 시험, VPS는 systemd, Mac mini/MacDate는 macOS 네이티브·낮은 Telegram 지연. TCO는 상시 가이드. 이전 후 hermes doctor 재실행.

06. 설치 데이터 3개·흔한 오류

  • ① 진입점: curl -fsSL https://get.hermes-agent.org | bash가 README와 동기.
  • ② Gateway 메모리: Telegram+클라우드 API만이면 상시 < 300 MB, 4GB VPS 충분.
  • ③ 순서 setup → doctor → gateway: 「Bot 온라인·모델 401」 가짜 장애 감소.

command not found: hermes는 shell 재로드, gateway timeout은 아웃바운드·Token. 메모리 플러그인은 30일 글에서 조정.

07. 전환: Mac mini M4 일일 임대로 옮길 때

MacBook 설치만으로는 24시간 Telegram·Cron·Gateway가 부족합니다. MacDate M4 일일 임대로 동일 curl·gateway install을 원격 macOS에서 재현, 반납 전 tar·NIST 삭제(Nous Research 무관). 요금, SSH FAQ, 7×24 이유를 함께 보세요.

더 읽기