헤르메스 에이전트의 로그는 주로 ~/.hermes/logs/와 hermes logs를 위한 것입니다. v0.8.0이 로그를 중앙집중화한 이후에는 일반적인 문제 해결을 모든 곳에서 뒤집을 필요가 없습니다: 일반적으로 errors.log을 먼저 보고, 그 다음 agent.log을 보고, 메시징 플랫폼 문제라면 게이트웨이 관련 로그를 살펴보는 것이 좋습니다.
세 개의 로그 항목 사용 방법
| 입구 | 문제 해결에 적합한 것은 무엇인가요 |
|---|---|
hermes logs | 퀵테일, 최근 주행 상태를 필터링하세요 |
errors.log | 시작 실패, 도구 오류, 구성 오류 |
agent.log | 모델 호출, 도구 실행, 세션 흐름 |
| 게이트웨이 로그 | 텔레그램, 디스코드, 슬랙, 웹훅 송수신 문제 |
권장 문제 해결 순서
- 문제를 먼저 재현하고, 단지 인상만으로 구성을 바꾸지 마세요.
- 최근 오류를 보려면
hermes logs돌려보세요. - 시동 단계에서 실패하면 먼저
hermes config check가동하세요. - 게이트웨이가 메시지에 응답하지 않으면 플랫폼 토큰, 허용 목록, 채널 권한, 게이트웨이 로그를 확인하세요.
- 모델이 느리거나 실패하고 있다면, 제공자, 모델명, 429/402/인증 오류를 참조하세요.
로그는 올리지 마세요
Hermes 에이전트가 비밀 편집을 해주긴 하지만, 커뮤니티나 동료에게 보내기 전에 URL 쿼리, 헤더, 플랫폼 토큰, 개인 파일 경로, 사용자 ID 등을 반드시 확인해야 합니다. 오류 유형과 마지막 수십 줄만 올릴 수 있다면, 전체 로그는 올리지 마세요.
팁 하나: 구성을 변경하기 전에 오류 로그 조각을 저장한 후, 같은 작업이 더 짧은지, 비슷한 오류가 적은지 비교하세요. 이렇게 하면 '재설치'보다 진짜 이유를 찾기가 더 쉽습니다.
공식 오픈 소스 주소: https://github.com/NousResearch/hermes-agent; 공식 문서 입력: https://hermes-agent.nousresearch.com/.
