핵심 판단
에이전트를 지금 붙일지 고민될 때, 유행이 아니라 반복 구간과 검증 가능 여부, 중지 조건으로 판단하는 실전 기준.
- 아래 목차에서 필요한 절차만 골라 읽으면 됩니다.
유행처럼 도구를 붙이는 순간, 비용은 늘고 검증은 늦어집니다. Hermes Agent를 “왜 지금 붙일지”로만 보면 답이 정해집니다. 이 글은 Hermes가 잘 맞는 구간(반복/검증/되돌림 가능)을 먼저 고르고, 실제로 회사 저장소를 만지는 환경에서 어떻게 시작하는지 순서대로 남깁니다.
Hermes는 텔레그램/디스코드/슬랙 같은 메신저뿐 아니라, 일정 기반 실행(예: 매일 아침 로그 요약)처럼 “대화가 아닌 실행”을 붙일 수 있는 쪽에 강합니다. 그래서 첫 목표는 기능이 아니라 안전한 초기 상태를 만드는 것입니다. Blank Slate, 샌드박스 백엔드, 키 격리, egress 프록시까지 한 세트로 묶어 시작합니다.
이 글에서 다루는 내용은 설치가 아니라 “권한을 넓히지 않고 시작하는 방법”입니다. 빠르게 60초 셋업을 하고, 바로 Blank Slate로 들어가며, 터미널 백엔드를 Docker로 바꿉니다. 그 다음에야 Skills와 Gateway 같은 확장을 붙입니다.
끝까지 읽고 나면, Hermes를 설치했는데도 막히는 흔한 원인(컨텍스트 크기, 키 출처, 권한/게이트웨이 설정)을 역순으로 복구할 수 있게 됩니다.
또한 이 글은 “더 많은 기능을 빨리 켜기”가 아니라 “안전한 최소 상태에서 확장을 붙이는 순서”를 목표로 합니다. 업데이트가 잦은 환경에서도 왜 갑자기 막히는지 추적할 수 있는 문장과 체크 포인트를 함께 남깁니다.
Hermes가 다른 에이전트와 갈리는 지점
Hermes Agent는 Nous Research가 만든 오픈소스 에이전트입니다. Claude Code나 Cursor 같은 코딩 특화 도구와는 목적이 다릅니다.
가장 큰 차이는 터미널에 머물지 않는다는 점입니다. Telegram, Discord, Slack, WhatsApp, Signal, Email, Home Assistant, Teams에 같은 에이전트가 붙습니다. 출근길에 텔레그램으로 “어제 밤 배포 로그 요약해줘”라고 보내면, 데스크톱에서 이어서 대화할 수 있습니다.
두 번째는 비대화형 실행입니다. 자연어로 스케줄을 걸 수 있습니다. “매일 아침 8시에 어제 커밋 요약해서 텔레그램으로 보내줘” 같은 일을 게이트웨이가 사람 없이 돌립니다. 이 기능이 Hermes의 실용적인 강점이자, 동시에 첫 위험 지점입니다.
세 번째는 서브에이전트입니다. 각자 별도의 대화와 터미널을 가진 격리된 에이전트를 띄웁니다. 긴 작업에서 컨텍스트가 터지는 걸 줄이는 구조적 해법이라 실제 체감이 큽니다.
60초 설치, 그리고 첫 번째 선택
macOS나 Windows면 공식 사이트의 Hermes Desktop 설치가 가장 편합니다. CLI만 원하면 아래처럼 시작합니다.
# Linux / macOS / WSL2 / Android(Termux)
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
source ~/.zshrc # 또는 ~/.bashrc# Windows 네이티브 (PowerShell)
iex (irm https://hermes-agent.nousresearch.com/install.ps1)설치 후 hermes setup을 돌리면 세 가지 모드가 나오고, 여기서 뭘 고르느냐가 이 글의 핵심입니다.
| 모드 | 내용 | 추천 대상 |
|---|---|---|
| Quick Setup (Nous Portal) | OAuth 로그인만으로 300+ 모델과 Tool Gateway | 일단 돌려보고 싶은 사람 |
| Full Setup | 모든 프로바이더와 도구를 직접 선택 | 자기 키를 쓰는 사람 |
| Blank Slate | 최소한만 켜고 시작 | 회사 저장소를 만질 사람 |
가장 빠른 길은 한 줄입니다.
hermes setup --portal다만 회사 코드나 실제 데이터가 걸려 있다면, 빠른 길로 먼저 들어가지 말고 Blank Slate를 선택하는 게 안전합니다.
⚠️ 주의: Hermes는 최소 64K 컨텍스트 모델을 요구합니다. 그보다 작으면 시작 단계에서 거부됩니다. 로컬 모델을 쓴다면 llama.cpp는--ctx-size 65536, Ollama는-c 65536으로 잡아주세요.
Blank Slate로 시작해야 하는 이유
회사 코드나 실제 데이터가 걸려 있다면 Quick Setup을 고르지 마세요. Blank Slate를 고르세요.
Blank Slate가 켜주는 건 딱 세 가지입니다. 프로바이더와 모델, File Operations 툴셋, Terminal 툴셋만 남기고 나머지는 전부 꺼집니다. 웹, 브라우저, 코드 실행, 비전, 메모리, 위임, cron, skills, 플러그인, MCP 서버도 초기에는 비활성 상태입니다.
중요한 디테일은 Blank Slate가 설정 파일에 끄는 도구들을 명시적으로 기록한다는 점입니다. 그래서 업데이트 후에도 선택하지 않은 기능이 조용히 다시 켜지는 일이 줄어듭니다. 감사 대응이 필요한 환경에서는 이 차이가 큽니다.
필요한 걸 나중에 하나씩 여는 명령은 아래처럼 시작합니다.
hermes tools # 툴셋을 플랫폼별로 켜고 끄기
hermes skills opt-in --sync # skills 활성화
hermes setup agent # 에이전트 세부 설정첫 주 권장 상태는 Blank Slate + File Operations + Terminal(Docker 백엔드)입니다. 이 조합이면 최악의 실패가 “컨테이너 안에서 뭔가 잘못됨” 수준에서 멈추기 쉽습니다.
설정 파일 위치도 알아두세요. 비밀값은 ~/.hermes/.env, 일반 설정은 ~/.hermes/config.yaml로 자동 분리됩니다. 직접 편집은 최소화하고 CLI를 쓰면 경로 실수를 줄일 수 있습니다.
hermes config set model anthropic/claude-opus-4.6
hermes config set terminal.backend docker
hermes config set OPENROUTER_API_KEY sk-or-...샌드박스와 키 격리
Hermes는 터미널 백엔드를 여러 형태로 지원합니다. local, Docker, SSH, Singularity, Modal이 대표적입니다.
기본값이 local이면 로컬에서 직접 명령을 실행합니다. 회사 저장소를 만질 가능성이 보이면 처음부터 바꾸세요.
hermes config set terminal.backend docker
hermes config set terminal.backend sshDocker를 쓰는 경우에는 추가로 egress 프록시 설정이 있습니다.
hermes egress setup && hermes egress start이게 하는 일은 샌드박스가 진짜 API 키를 직접 보지 못하게 만드는 겁니다. 대신 불투명한 프록시 토큰만 받고, 실제 키는 로컬 TLS 인터셉트 데몬 뒤에서만 사용됩니다. 컨테이너가 탈취되거나 잘못된 경로로 데이터를 보내려 해도 키 자체 유출을 줄이는 방향입니다.
프롬프트 인젝션이 실전 위협이 된 지금, 이 설정은 “옵션”이 아니라 시작 기본값으로 둬도 좋습니다. 다만 현재 Docker에만 연결되어 있습니다. 백엔드를 바꿀 때는 지원 범위를 같이 확인하세요.
Skills - 컨텍스트를 안 먹는 매뉴얼
Skills는 특정 작업 절차를 적어둔 SKILL.md 문서입니다. 이름, 설명, 단계별 절차로 구성됩니다.
동작 방식이 영리합니다. 에이전트는 평소에 짧은 요약만 읽고 있다가, 실제로 그 작업이 필요할 때만 전체 내용을 로드합니다. 그래서 스킬을 많이 설치해도 요청이 무거워지는 걸 상대적으로 줄입니다.
hermes skills browse
hermes skills search kubernetes
hermes skills install openai/skills/k8s설치 인자는 허브의 source/path 슬러그입니다. openai/skills/k8s는 OpenAI 카탈로그의 k8s 스킬을 뜻하고, 정확한 슬러그는 browse로 확인하는 게 안전합니다.
설치된 스킬은 자동으로 슬래시 커맨드가 됩니다.
/k8s deploy the staging manifest
/k8sCLI에서도, 연결된 메신저에서도 동작이 동일합니다. 미리 다 설치할 필요는 없습니다. 대화 중 작업이 매칭되면 에이전트가 번들 스킬을 알아서 선택합니다.
💡 Tip: 남의 스킬을 받기 전에 자기 팀 배포 절차부터SKILL.md로 적어 두세요.~/.hermes/skills/에 넣으면 됩니다. 외부 스킬은 보안 스캔을 통과하더라도 절차 내용을 직접 읽고, 스킬은 결국 “에이전트에게 이렇게 하라”는 지시문이기 때문에 검수하는 편이 안전합니다.
Gateway는 마지막에
메신저 연결은 Hermes의 간판 기능이지만, 가장 나중에 붙이세요. 공식 문서도 같은 순서를 권합니다. “Hermes가 평범한 대화를 못 끝내면 기능을 더 얹지 마라”가 요지입니다.
hermes gateway setup
hermes gateway status게이트웨이를 붙이기 전에 확인할 것 세 가지입니다.
첫째, allowlist입니다. 봇이 채널에 들어가면 그 채널의 모든 사람이 에이전트를 사용할 수 있습니다. 누가 명령을 내릴 수 있는지 먼저 제한하세요.
둘째, cron은 게이트웨이가 안정된 다음에. 사람 없이 도는 작업은 사고가 나도 늦게 발견됩니다. “자는 동안 쓰기 금지” 시간대를 먼저 정하세요.
셋째, 메신저에서는 권한을 더 좁게. hermes tools로 플랫폼별 도구 접근을 따로 설정할 수 있습니다. CLI에서 터미널을 허용하더라도 텔레그램에서는 막아두는 식으로요.
막혔을 때 복구 순서
공식 문서가 권하는 순서가 있습니다. 외워두면 시간을 아낍니다.
hermes doctor
hermes model
hermes setup
hermes sessions list
hermes --continue
hermes gateway status자주 겪는 문제와 원인입니다.
| 증상 | 원인 | 해결 |
|---|---|---|
| 열리는데 응답이 비었거나 깨짐 | 프로바이더 인증 또는 모델 선택 오류 | hermes model 재실행 |
| 커스텀 엔드포인트가 이상한 답을 함 | base URL/모델명 오류 | 다른 클라이언트로 먼저 검증 |
| 게이트웨이는 떴는데 메시지가 안 감 | 봇 토큰 또는 allowlist 미완성 | hermes gateway setup 재실행 |
--continue가 세션을 못 찾음 | 프로필이 바뀌었거나 저장 안 됨 | hermes sessions list 확인 |
| 모델이 이상하게 폴백됨 | 라우팅/폴백 설정 과함 | 베이스 프로바이더 안정될 때까지 라우팅 끄기 |
마지막 줄이 특히 중요합니다. 멀티 프로바이더 폴백은 매력적이지만, 기본 대화가 안정되기 전에 켜면 문제가 어디서 났는지 잊히기 쉽습니다.
작은 팁도 하나. 에이전트가 엉뚱한 길로 가고 있으면 새 메시지를 입력하고 Enter만 누르세요. 현재 작업을 중단하고 새 지시로 전환합니다. Ctrl+C도 됩니다. 잘못된 방향으로 10분 돌게 두는 것보다 훨씬 낫습니다.
그리고 hermes --tui를 한번 써보세요. 클래식 CLI와 세션/설정/슬래시 커맨드를 공유하지만, 모달 오버레이와 논블로킹 입력이 있어서 긴 작업에서 체감이 다릅니다.
OpenClaw와 뭐가 다른가
둘 다 오픈소스이고 셀프호스팅이며 모델 중립입니다. 다만 비교 글은 대체로 이렇게 남깁니다.
OpenClaw는 스킬 생태계가 더 크고 멀티에이전트·멀티채널 조율에 강합니다. 대화 전체를 기억했다가 압축하는 방식이라 최근 맥락 유지가 좋다는 쪽으로 평가됩니다. 대신 통제 폭이 넓은 만큼 문제가 생겼을 때 파고들 곳이 많습니다.
Hermes는 백그라운드 실행과 메모리 깊이가 강점으로 꼽힙니다. 큐레이팅된 grep 가능한 메모리를 쓰기 때문에 세션이 끊겨도 살아남는 편이라 운영 감각이 좋다는 평가가 많습니다. 운영 비용도 대체로 낮게 나오는 경우가 있습니다.
거칠게 정리하면, 조율이 문제면 OpenClaw, 사람 없이 도는 반복 작업이 문제면 Hermes 쪽이 먼저 후보입니다. 다만 이 비교는 제3자 평가에 기반한 것이고 프로젝트는 빠르게 바뀌기 때문에, 결정 전에 각자 자기 작업 하나로 이틀씩 돌려보는 게 가장 정확합니다.
그래서 지금 붙일 만한가
Gartner는 2027년까지 에이전틱 AI 프로젝트의 40%가 취소될 것으로 봅니다. 이유는 기술 한계가 아니라 비용 증가, 불명확한 가치, 미흡한 리스크 통제입니다. 셋 다 설치 전에 정할 수 있습니다.
세 개 다 있으면 후보입니다.
주 3회 이상 반복되고, 결과가 맞았는지 테스트나 로그로 검증되며, 틀렸을 때 5분 안에 롤백됩니다. 하나라도 없으면 지금은 후보가 아닙니다. 검증 장치를 먼저 만드는 게 결과적으로 빠릅니다.
Hermes에 잘 맞는 첫 작업 세 가지.
야간 CI 실패 로그를 원인별로 묶어 아침에 텔레그램으로 보내기. cron과 게이트웨이가 딱 이걸 위해 있고, 실패해도 저장소가 안 바뀝니다.
의존성 업데이트 changelog에서 breaking change 문단만 추려 주간 요약 만들기. 사람이 모든 패키지를 다 읽지는 않습니다.
주간 에러 트래커에서 신규 항목만 기존 이슈와 대조해 중복 이슈 생성을 줄이기. 이 정도만 해도 값이 나옵니다.
셋 다 읽고, 정리하고, 사람 앞에 놓는 것까지만 합니다.
팀에 공유할 한 문장은 이렇게 씁니다.
2주간 Hermes를 Blank Slate + Docker 백엔드 + egress 프록시로 설치해, 스테이징 CI 실패 로그 분류만 자동화한다. 검수 시간이 직접 하던 시간의 40% 미만이면 다음 범위를 논의하고, 일일 예산 초과 2회 또는 승인 없는 프로덕션 변경이 1회라도 발생하면 담당자가 즉시 실험 키를 회수한다.
이득과 중지 조건과 담당자가 한 문장에 다 있으면 승인이 됩니다. 이득만 있으면 제안이 아니라 희망입니다.
출처와 링크
- Hermes Agent docs
- NousResearch/hermes-agent GitHub
- Gartner press release
- OWASP Top 10 for LLM Applications
- NIST AI Risk Management Framework
조사 기준: 2026년 7월. Hermes는 활발히 개발 중이라 명령어와 옵션이 바뀔 수 있습니다. 설치 전 공식 Quickstart 문서를 한 번 대조하세요. 또한 OpenClaw 비교는 제3자 경험 기반이라 단정 대신 “내 작업 이틀 테스트”로 확인하는 게 더 정확합니다.
FAQ
자주 묻는 질문
Nous Portal을 꼭 써야 하나요?
아닙니다. Hermes는 여러 프로바이더를 지원하고 `hermes model`로 구성을 바꿀 수 있습니다. Portal은 OAuth와 Tool Gateway를 묶는 편의 옵션이라, 회사 환경은 Blank Slate 기반으로 시작하고 필요할 때만 붙이세요.
Anthropic 계정으로 붙이려면요?
OAuth로 붙이면 계정 권한과 사용 크레딧/한도를 먼저 확인해야 합니다. 실험 구간이라면 운영 키와 분리된 별도 키(또는 별도 설정)를 쓰고, 콘솔 hard limit을 먼저 거세요. 알림만 두면 밤사이 비용이 커질 수 있습니다.
첫날에 뭘 하면 되나요?
설치 후 Blank Slate로 들어가서 기본 동작이 되는지 확인합니다. 이후 `terminal.backend`를 Docker로 바꾸고, egress 프록시가 예상대로 동작하는지 한 번 점검하세요. 기본 대화가 안정된 뒤에야 Skills나 Gateway를 붙입니다.
회사 저장소에 바로 붙여도 되나요?
권하지 않습니다. 사내 보안 검토 전에 권한을 넓히면 되돌리기 비용이 커집니다. 개인/회사 키 출처를 섞지 말고, 먼저 읽기/관측 범위를 고정한 뒤 실험 키로 통과를 확인하세요.
개인 프로젝트도 이렇게까지 해야 하나요?
일지는 줄여도 됩니다. 다만 hard limit과 중지 규칙은 그대로 두는 편이 안전합니다. 상한 없는 종량제 기본은 야간 루프 사고에 취약합니다.
Blank Slate로 시작하면 뭘 끄나요?
초기에는 프로바이더/모델과 File Operations, Terminal만 남기고 확장 도구셋은 비활성입니다. 선택하지 않은 기능이 다시 켜지지 않게 끄는 상태를 설정 파일에 명시적으로 남깁니다. 그 다음에야 필요한 것만 순서대로 열어갑니다.