Hermes Agent Mac 설치: 게이트웨이·마이그레이션 (2026)
Hermes Agent는 Nous Research의 MIT 오픈소스 자기개선 AI 에이전트입니다(GitHub). 단발 채팅이 아니라 학습 루프(메모리, 스킬, FTS5, cron, Telegram 등 게이트웨이)를 돌립니다. 이 가이드는 Mac(MacBook 또는 헤드리스 Mac mini) 설치 절차입니다.
Mac에서 Hermes를 쓰는 이유
- 원클릭 설치 —
install.sh가 macOS 지원. - Apple Silicon —
uv, Python 3.11, Node,ffmpeg/ripgrep. - 게이트웨이 —
hermes gateway상시 실행 시 Telegram 제어; Mac 슬립 시 끊김. - OpenClaw — OpenClaw 사용자는
hermes claw migrate로 이전.
Obra Superpowers는 프로세스, Hermes는 런타임·채널 — 함께 씁니다.
서울 리전 상시 Mac은 SSH 백엔드로 원격 실행할 때만 네트워크 선택에 유용합니다.
macOS 아키텍처
| 구성 | 경로 | 역할 |
|---|---|---|
| CLI | ~/.local/bin/hermes | TUI |
| 설정 | ~/.hermes/ | 키·도구·게이트웨이 |
| 게이트웨이 | hermes gateway start | 메시징 브리지 |
| 에이전트 | uv venv | 도구·서브에이전트 |
Mac 8단계 설치
- 사전 준비 — macOS 13+, Docker+게이트웨이 시 16GB RAM.
- 설치 — 공식 curl install.sh, zshrc reload.
- 검증 — hermes doctor, --version.
- 설정 — hermes setup (--portal 옵션).
- 모델/도구 — hermes model, hermes tools.
- TUI 테스트 — /usage 등 확인.
- 게이트웨이(선택) — gateway setup/start.
- OpenClaw 마이그레이션(선택) — claw migrate.
터미널 백엔드
| 백엔드 | 용도 | Mac 역할 |
|---|---|---|
| local | 일상 개발 | 노트북 |
| docker | 샌드박스 | Docker Desktop |
| ssh | 원격 실행 | Mac mini/VPS 제어 |
| modal/daytona | 유휴 비용 절감 | 최소 상주 |
문제 해결
command not found
PATH에 ~/.local/bin 추가.
Python/uv 오류
uv 설치 후 hermes update.
게이트웨이 무반응
토큰·화이트리스트·재시작.
Docker 백엔드 사용 시 Desktop을 최신으로 유지하세요. 게이트웨이와 cron은 같은 ~/.hermes/에 두는 것이 좋습니다.
TUI에서 /usage로 토큰을 먼저 확인한 뒤 브라우저 도구를 켜면 Telegram 비용 급증을 줄일 수 있습니다.
게이트웨이 전용 macOS 사용자를 만들고 iCloud 데스크톱 동기화를 끄면 ~/.hermes/ FTS5 인덱스가 안전합니다.8단계 후 Telegram 테스트 메시지 1통으로 도구 스트리밍을 확인한 뒤 다른 채널을 열어보세요.
서울 리전 상시 Mac에 SSH 백엔드를 두면 노트북 슬립 중에도 응답을 유지하고 API 키를 한곳에 모을 수 있습니다.
여러 에이전트를 한 호스트에서 돌릴 때는 hermes 전용 API 키와 로그 경로를 분리하고, OpenClaw 등 다른 도구의 환경 변수와 충돌하지 않게 하세요.
설치 후 hermes doctor 출력을 팀 위키에 붙여 두면, 신규 멤버가 동일 Mac 미니에서 게이트웨이를 재현할 때 시간을 절약합니다.
Telegram 외 채널을 켜기 전에 로컬 백엔드로 소규모 작업을 끝낸 뒤 SSH 백엔드로 옮기면, 원격 Mac 미니에서의 첫 도구 호출 실패를 줄일 수 있습니다.
게이트웨이 로그는 ~/.hermes/ 아래에 쌓이므로, 월 1회 로테이션을 cron에 등록해 디스크 부족을 예방하세요. OpenClaw와 병행할 때는 각각 다른 봇 토큰을 쓰고, DM 허용 목록을 문서화해 팀원이 실수로 차단되지 않게 하세요.
MacBook에서 게이트웨이만 켜 두고 SSH 백엔드로 무거운 도구를 실행하면 배터리 소모를 줄이면서도 Telegram 응답성을 유지할 수 있습니다. 첫 주는 local만 사용해 스킬·메모리 동작을 익힌 뒤 Docker 또는 SSH로 옮기는 것이 안전합니다.
FAQ
hermes claw migrate로 연결합니다.hermes gateway를 24/7로 쓸 때만 상시 Mac mini나 소형 VPS를 고려하세요.hermes update 후 hermes doctor로 확인하세요.