Hermes Agent 트러블슈팅
기준일: 2026-06-06
난이도: 중급
공식 기준: FAQ & Troubleshooting
Hermes 문제는 대부분 설치, 모델, 권한, MCP, 게이트웨이 중 하나로 나뉩니다. 처음부터 재설치하지 말고 증상을 좁히면 시간을 줄일 수 있습니다.
핵심 개념
| 증상 | 먼저 볼 곳 |
|---|---|
hermes 명령이 없음 |
PATH, shell reload, 설치 로그 |
| 응답이 안 옴 | model provider, API key, portal status |
| 도구가 안 보임 | toolsets, MCP 설정, reload |
| 메모리가 반영 안 됨 | 새 세션 여부, ~/.hermes/memories/ |
| Gateway 연결 실패 | gateway status, log, allowlist |
| 위험 명령 대기 | approval prompt, timeout, cron policy |
선택 기준
진단은 다음 순서로 진행합니다.
- 명령 존재 여부:
hermes --help - 설정 존재 여부:
ls ~/.hermes - 모델 연결:
hermes model,hermes portal info - 단순 대화:
hermes chat -q "ping" - 도구/MCP: 도구 목록과 로그 확인
- Gateway:
hermes gateway status
재설치는 마지막 선택입니다. 설정 손상인지, provider 문제인지, gateway 문제인지 확인한 뒤 진행합니다.
실습
기본 점검:
which hermes
hermes --help
ls ~/.hermes
hermes model
모델/포털 점검:
hermes portal info
hermes chat -q "간단히 한 문장으로 응답해줘."
게이트웨이 점검:
hermes gateway status
tail -n 80 ~/.hermes/logs/gateway.log
MCP 점검 프롬프트:
현재 로드된 MCP 서버와 도구 목록을 알려줘.
실패한 서버가 있으면 설정 파일 위치, 로그 확인 방법, 재시작 순서를 제안해줘.
Hermes에 입력할 프롬프트
다음 에러를 원인별로 분리해줘.
설치/PATH, 모델 provider, API 키, MCP, gateway, 권한 승인 중 어디에 가까운지 판단하고
가장 적은 변경으로 확인할 명령부터 제시해줘.
아직 재설치는 권하지 마.
체크리스트
-
hermes명령과 설정 디렉터리를 확인했다. - 모델 provider 문제와 도구 문제를 분리했다.
- MCP 실패는 서버별로 하나씩 확인했다.
- Gateway 문제는 status와 log를 함께 봤다.
- 재설치 전에 설정 백업 여부를 확인했다.
다음 단계
- 설치에서 설치 경로를 다시 확인합니다.
- Provider와 모델 설정에서 모델 연결을 점검합니다.
- 보안과 승인에서 권한 대기 상태를 확인합니다.