2026년 Nous Research가 오픈소스로 공개한 Hermes Agent는 「채팅 가능한 모델」을 내 머신에 상주하는 장기 프로세스로 끌어올립니다. 세션을 넘는 기억, Skill 자동 축적, Telegram 등 20여 게이트웨이를 통한 원격 지시가 한 흐름입니다. 많은 팀이 첫날에 막히는 지점은 의존성 불일치, API 키 오설정, Telegram Bot이 응답하지 않음입니다.
본문은 macOS / Linux / WSL2에서 처음부터 Hermes를 통과하려는 개발자와 소규모 팀을 위한 글입니다. 설치 전 과제와 호스트 비교를 정리한 뒤 공식 한 줄 스크립트 → hermes doctor → hermes setup → 첫 대화 → Telegram Gateway → launchd 상주까지 6단계 체크리스트를 제시합니다. 읽고 나면 ~/.hermes/를 노트북에 둘지 7×24 온라인 Mac mini에 둘지 판단할 수 있어야 합니다.
01 Hermes Agent 설치 전에 알아야 할 과제: OpenClaw와 같은 길이 아닙니다
Hermes와 커뮤니티에서 자주 비교되는 OpenClaw는 모두 Gateway를 제공하지만 기본 설계가 다릅니다. OpenClaw는 멀티 채널 제어 평면과 플러그인 생태계에 가깝고, Hermes는 3계층 기억 + Skill 자기 진화 + MCP를 강조합니다. 공식 설치기는 Python 3.11, Node.js 22, ripgrep, ffmpeg 등을 한 번에 ~/.hermes/hermes-agent/venv에 넣어 시스템 Python을 직접 맞출 필요가 없습니다.
- 의존 체인이 깁니다: 수동 pip 설치 시 「시스템 Python과 venv 불일치」「dotenv 누락」이 흔합니다. 공식은 항상 설치기 경로를 권장합니다.
- 절전 시 Gateway 단절: MacBook에서 검증은 가능하지만 Cron과 메시징에는 절전하지 않는 전용 Mac이 적합합니다.
- Linux VPS 숨은 비용: x86 VPS에서도 Gateway + 클라우드 API는 동작하지만 macOS 전용 브라우저 자동화 경로는 Linux에서 재현이 어렵습니다.
- Telegram 그룹 프라이버시: Bot 기본 설정에서는 일반 메시지가 보이지 않습니다. Hermes 결함이 아니라 BotFather 정책입니다.
- 버전 드리프트: 업그레이드 후
Missing config after update가 보이면hermes config check와 migrate로 schema를 맞추십시오.
결론적으로 설치 자체는 15분 안에 끝날 수 있습니다. 체감 품질을 가르는 것은 호스트가 7×24 온라인인지,
~/.hermes/백업·이전이 가능한지입니다.
명령과 동작은 Nous Research 공식 문서를 기준으로 하십시오. 릴리스마다 아래 링크를 다시 확인하시기 바랍니다.
02 Hermes Agent 요구 사항과 호스트 비교: 어디에 올리면 가장 수월한가
공식 설치기는 macOS 12+, Ubuntu 20.04+, WSL2, Termux를 지원합니다. Windows 네이티브 PowerShell은 초기 Beta이므로 프로덕션에서는 WSL2에서 Linux 스크립트를 쓰는 편이 안전합니다. 아래 표는 선정용이며 공식 Prerequisites를 대체하지 않습니다.
| 호스트 | 7×24 가용성 | 설치 마찰 | Skill / Gateway 복리 | 전형적 약점 |
|---|---|---|---|---|
| MacBook 로컬 | 절전·덮개로 단절 | 낮음 (공식 경로 성숙) | 시험용, 프로덕션 약함 | OS 업데이트 재시작 |
| Raspberry Pi 4B 8GB | 체감 약 88% | 중 (IO·ARM 패키지) | 경량 Gateway 가능 | 장시간 작업·브라우저 자동화 타임아웃 |
| x86 Linux VPS | 약 99.5% | 중 (헤드리스는 --skip-browser) | API 모드 안정 | macOS 전용 툴체인 없음 |
| Mac mini M4 월 대여 베어메탈 | 데이터센터 SLA | 낮음 (SSH는 로컬과 동일) | launchd + UMA 적합 | 리전·계약 기간 선정 |
최소 사양 (공식 설치 페이지): Gateway + 클라우드 API만이면 4 GB RAM부터 가능합니다. 로컬 모델·브라우저 자동화를 쓰면 16 GB 통합 메모리를 권장합니다. 디스크는 1.5 GB(Skills 캐시 포함)를 확보하고 프로덕션에서는 20 GB SSD 여유가 좋습니다. 원격 서버에서는 네트워크 지연과 방화벽으로 Telegram 장시간 연결이 끊기지 않는지 확인하십시오.
03 Hermes Agent 한 줄 설치와 헬스 체크: macOS / Linux 공통
대상 호스트 터미널에서 실행합니다 (공식 README와 동일. 릴리스 후 main 브랜치 스크립트 경로를 다시 확인하십시오):
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
헤드리스 서버는 브라우저 스택 생략:
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash -s -- --skip-browser
source ~/.zshrc
hermes doctor
hermes --version설치기는 일반적으로 uv 설치, Python 3.11 확보, Node.js 22, ripgrep·ffmpeg 설치, ~/.hermes/hermes-agent/ 클론, hermes PATH 등록을 수행합니다. 성공 시 installed at ~/.hermes에 가까운 메시지가 표시됩니다.
hermes doctor는 Python, Node, ripgrep, ffmpeg, PATH, API Key 등을 자가 진단합니다. 실패 항목은 hermes setup 전에 수정해 Gateway로 문제를 넘기지 마십시오.
Telegram 채널 설정은 공식 Messaging 가이드를 참고하십시오.
04 6단계 구현: 모델 설정, 첫 대화, Telegram, Gateway 7×24 상주
- LLM 설정:
hermes setup으로 전체 마법사를 돌리거나hermes model로 공급자만 전환합니다. OpenRouter / Anthropic / OpenAI / Ollama 등을 지원하며 키는~/.hermes/.env에 저장합니다. - 첫 CLI 대화:
hermes를 실행해 「현재 디렉터리 파일 수 세기」처럼 검증 가능한 작업으로 도구 호출과 로그를 확인합니다. - Telegram Bot 생성: Telegram에서
@BotFather에/newbot을 보내 Token을 기록하고@userinfobot으로 숫자 User ID를 받습니다. - Gateway 연결:
hermes gateway setup에서 Telegram을 선택해 Token과 허용 사용자 ID를 입력하거나TELEGRAM_BOT_TOKEN,TELEGRAM_ALLOWED_USERS를 수동 설정합니다. - 포그라운드 스모크 테스트:
hermes gateway를 전경 실행한 뒤 휴대폰에서 Bot에 메시지를 보내 응답을 확인합니다. 그룹은 BotFather에서 Group Privacy를 끈 뒤 Bot을 다시 초대하십시오. - 백그라운드 상주: macOS에서는
hermes gateway install과hermes gateway start(launchd). Linux에서는sudo hermes gateway install --system과 systemd를 사용합니다. 월 대여 Mac 노드에서도 동일 절차로 7×24 접근이 가능합니다.
hermes setup
hermes gateway setup
hermes gateway install
hermes gateway start
hermes gateway statusCALMVPS 베어메탈 Mac에 배포할 때는 가격 페이지에서 M4 메모리와 리전을 고른 뒤 SSH로 접속해 로컬과 같은 명령을 실행하십시오. 호스트 변경 전 ~/.hermes/ 디렉터리 전체를 아카이브합니다. 주문은 클라우드 주문 페이지에서 진행합니다.
05 인용 사양, 흔한 오류, CALMVPS로 마무리
- 설치기 구성: uv + Python 3.11 + Node.js 22 + ripgrep + ffmpeg (공식 Installation 문서. 버전은 릴리스마다 변하므로
hermes --version으로 확인). - 설정 영속화: 핵심은
~/.hermes/(.env, skills, memories, Gateway 상태). 이전 시 채팅만이 아니라 디렉터리 전체를 백업하십시오. - 전력 (M4 호스트): 커뮤니티·데이터센터 실측에서 유휴 약 4–6 W, 전형 Agent 부하 15–25 W 수준이 보고됩니다 (계량기·Apple 사양으로 검증).
| 현상 | 흔한 원인 | 조치 |
|---|---|---|
| hermes: command not found | PATH 미반영 | source ~/.zshrc 또는 새 터미널 |
| API key not set | LLM 미설정 | hermes model 또는 ~/.hermes/.env 편집 |
| 그룹 무응답 | Bot 프라이버시 모드 | BotFather에서 Group Privacy 끄고 Bot 재초대 |
| Missing config after update | 설정 schema 변경 | hermes config check 및 migrate |
자주 덮개를 닫는 노트북에서는 Gateway 연속성과 Skill 복리가 약하고, 저가 해외 VPS에서는 macOS 툴체인과 지연이 약점이며, Raspberry Pi에서는 IO와 장시간 작업이 병목입니다. Telegram 7×24, launchd 네이티브 상주, 메모리 빠른 증설이 필요한 프로덕션에서는 CALMVPS 베어메탈 Mac mini M4 월 대여가 대체로 최선입니다. SSH 즉시 사용, Apple Silicon 단독 점유, 월 단위 유연 계약이 가능합니다. 기종은 CALMVPS 가격 페이지, 주문은 클라우드 주문에서 하십시오.