hermes doctor로 환경 검증；③ hermes setup으로 LLM 연결；④ hermes gateway install로 7×24화. 환경 매트릭스, 6단계 Runbook, 오류 표, 호스트 선정까지 한 번에 다룹니다.
2026년 Hermes Agent를 설치하는 이유: OpenClaw와의 차이
「오픈소스 AI Agent 튜토리얼」을 찾다 보면 Hermes Agent, OpenClaw, LangGraph, CrewAI 비교에 이릅니다. 한 줄로 말하면 Hermes는 「내 머신에 상주하는 개인 오퍼레이터」입니다. USER.md / MEMORY.md / Skill을 ~/.hermes에 두고 Gateway가 채널을 담당합니다. OpenClaw는 멀티채널 Gateway와 ClawHub 스킬 생태계가 중심이고, LangGraph / CrewAI는 오케스트레이션 프레임워크에 가까워 기억과 배포는 직접 조립해야 합니다.
자기 진화 Skill: 같은 유형 작업은 ~/.hermes/skills/를 우선 로드합니다. 커뮤니티 사례에서 30일간 Skill이 한 자릿수에서 10여 개로 늘 때, 유사 작업 token이 약 38% 줄었다는 보고가 있습니다(품질 지표가 아닌 참고치).
모델 독립: Anthropic, OpenAI, OpenRouter, GitHub Copilot, Ollama 등을 지원합니다. 키는 ~/.hermes/.env에 저장합니다.
MCP 확장: Model Context Protocol을 지원해 GitHub, 브라우저 자동화 등 Server를 붙일 수 있습니다.
Hermes Agent 설치 환경: macOS, Linux, VPS 선택
| 항목 | 최소 요구 | 권장(프로덕션 Gateway) |
|---|---|---|
| OS | macOS 12+, Ubuntu 20.04+, WSL2 | macOS 14+(Apple Silicon) 또는 Ubuntu 24.04 LTS |
| Python / Node | 스크립트가 3.11 / Node 18+ 자동 설치 | 기본 Node 22, sudo 불필요 |
| 메모리 | 4 GB(API + Gateway만) | 16 GB(브라우저 자동화 + 로컬 7B 폴백) |
| 디스크 | 약 1.5 GB(Skills 캐시 포함) | ≥ 20 GB SSD |
| 네트워크 | GitHub raw + LLM API 접근 가능 | 안정적 저지연 egress |
| 호스트 시나리오 | 7×24 체감 | 적합 단계 |
|---|---|---|
| 노트북 덮개 닫기 | ≈ 60%, Skill 복리 끊김 | POC만 |
| x86 VPS 4GB | ≈ 99.5%, macOS 전용 Skill 경로 없음 | Linux 전용 사용자 |
| Mac Mini M4 월 대여 | 데이터센터 SLA, launchd 네이티브 | Telegram 프로덕션, Camoufox 자동화 |
Hermes Agent 완전 설치: 6단계 Runbook(macOS / Linux)
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash source ~/.zshrc
헤드리스 서버는 브라우저 의존을 건너뛸 수 있습니다: bash -s -- --skip-browser. 스크립트는 uv, Python 3.11, Node 22, ripgrep, ffmpeg를 설치하고 저장소를 ~/.hermes/hermes-agent/에 두며, 전역 hermes를 PATH에 넣습니다. 성공 표시: ✅ Hermes Agent installed at ~/.hermes.
설치 실행: 위 curl 명령. Windows는 PowerShell install.ps1도 있으나, 프로덕션은 WSL2 + Linux 스크립트 권장입니다.
Shell 갱신: source ~/.zshrc 또는 source ~/.bashrc. hermes: command not found의 전형적 해결입니다.
헬스 체크: hermes doctor가 Python, Node, ripgrep, ffmpeg, PATH, API Key 등 약 12항목을 검사합니다. hermes --version으로 v0.14.x / v0.15 후보를 확인하세요.
모델 설정: hermes setup 마법사 또는 hermes model로 OpenRouter / Anthropic / Ollama 선택. 키는 ~/.hermes/.env에. 예: hermes config set OPENROUTER_API_KEY sk-or-xxxx.
CLI 스모크: hermes를 실행해 「오늘 AI 뉴스 요약」「현재 디렉터리 파일 수」 등으로 도구 호출과 라우팅을 확인합니다.
업그레이드와 이전: 일상은 hermes update. 업그레이드 후 설정 누락 시 hermes config check && hermes config migrate를 실행합니다.
Hermes Agent Telegram 연동: BotFather부터 gateway install까지
CLI만으로는 「그 PC에서의 대화」에 그칩니다. 스마트폰에서 언제든 일을 맡기려면 Gateway가 필요합니다. Telegram에서 @BotFather → /newbot → Token 저장 → @userinfobot으로 본인 숫자 ID를 확인합니다.
hermes gateway setup hermes gateway install hermes gateway start hermes gateway status
대화형 마법사가 TELEGRAM_BOT_TOKEN과 TELEGRAM_ALLOWED_USERS를 기록합니다. Linux 프로덕션은 sudo hermes gateway install --system과 journalctl -u hermes-gateway -f로 로그를 봅니다. macOS는 launchd 사용자 서비스면 충분합니다.
| 오류 / 현상 | 원인 | 조치 |
|---|---|---|
hermes: command not found | PATH 미반영 | 터미널 재시작 또는 rc source |
API key not set | LLM 미설정 | hermes model |
| 그룹 무응답 | Bot 프라이버시 | BotFather Group Privacy 끄기, 재초대 |
ModuleNotFoundError: dotenv | 시스템 Python 오사용 | ~/.hermes/hermes-agent/venv/bin/hermes 사용 |
팁: 자주 쓰는 명령은 hermes tools, hermes config check입니다. MCP는 ~/.hermes/config.yaml의 mcp_servers로 선언하고, 헤드리스에서는 hermes mcp login + SSH 터널로 OAuth를 완료합니다.
설치 이후: Skill 복리와 Mac Mini M4 호스트 수치
Star 규모: 2026년 6월 기준 hermes-agent는 약 174,720 Star. 설치와 Telegram 문서는 macOS 경로가 가장 성숙합니다.
소비 전력: M4 유휴 약 4–6W, Gateway + 자동화 시 전형 15–25W. 상시 가동에 적합합니다.
통합 메모리: 16GB UMA에서 Gateway 상주가 약 4GB급. Camoufox, SQLite WAL과 주소 공간을 공유해 x86 소형 VPS보다 swap 흔들림이 적습니다.
노트북 덮개, Raspberry Pi I/O 병목, Linux VPS만으로는 macOS 브라우저 Skill 불가——이는 「설치 실패」가 아니라 호스트 선택 오류로 Gateway SLA가 안 맞는 것입니다. Telegram 7×24 수주와 Skill 축적을 원한다면 MESHLAUNCH Mac Mini M4 클라우드 베어메탈 월 대여가 현실적입니다. SSH에서 동일 curl 설치, launchd 상주, 해지 전 ~/.hermes 통째 이전 가능. 대여 요금으로 일 단위 시험, 운영 경계는 고객 센터를 확인하세요.
아닙니다. install.sh가 uv로 Python 3.11과 Node 22를 설치합니다. doctor가 실패하면 시스템 Python이 아닌 venv 내부 hermes를 쓰는지 확인하세요.
BotFather에서 Group Privacy를 끈 뒤 Bot을 그룹에서 내보내고 다시 초대해야 합니다. TELEGRAM_ALLOWED_USERS도 확인하세요. Gateway 전용으로M4 일 대여해 분리 테스트하는 방법도 있습니다.
디스크 기억은 남지만 Gateway 오프라인 중 Skill 복리와 Cron이 끊깁니다. 프로덕션에서는 hermes gateway install을 7×24 호스트에서 돌리세요. 자세히는3계층 메모리 글을 참고하세요.