Hermes Dashboard 설정 및 API

개요 및 최종 구성 참고

---

Dashboard 초기 설정

Dashboard UI가 정상 로드되었으나 초기 설정이 비어있는 상태에서 Dashboard API로 직접 설정 완료.

모델 변경

대시보드의 기본 모델은 anthropic/claude-opus-4.6로 설정되어 있었으나, 사용 중인 API는 jiminbox의 deepseek-v4-flash. Config API로 모델 변경:

curl -X PUT "https://gommes.jimin.io/api/config" \
  -H "x-hermes-session-token: ${TOKEN}" \
  -d '{"config":{"model":{"default":"openai/deepseek-v4-flash"}}}'

Gateway 재시작

설정 변경 후 gateway 재시작:

curl -X POST "https://gommes.jimin.io/api/gateway/restart" \
  -H "x-hermes-session-token: ${TOKEN}"

---

Dashboard API 엔드포인트

인증: x-hermes-session-token 헤더 필요 (값은 Dashboard HTML의 window.__HERMES_SESSION_TOKEN__에서 추출)

상태 및 정보

메서드	경로	설명
GET	/api/status	Gateway/Agent 상태 (버전, 실행 여부, 세션 수, 플랫폼 연결 상태)
GET	/api/config	설정 조회
GET	/api/config/raw	Raw YAML 설정 조회
PUT	/api/config	설정 저장 ({"config":{...}})
GET	/api/env	환경변수 목록 (민감 정보는 redacted)
PUT	/api/env	환경변수 설정 ({"key":"...","value":"..."})
DELETE	/api/env	환경변수 삭제
GET	/api/model/info	모델 정보

세션

메서드	경로	설명
GET	/api/sessions	세션 목록 (limit/offset 파라미터)
GET	/api/sessions/{id}/messages	특정 세션 메시지
DELETE	/api/sessions/{id}	세션 삭제
GET	/api/sessions/search?q=	세션 내용 검색

로그 및 모니터링

메서드	경로	설명
GET	/api/logs	로그 조회 (file/lines/level 파라미터)
GET	/api/analytics/usage?days=N	사용량 분석

플랫폼 관리

메서드	경로	설명
POST	/api/gateway/restart	Gateway 재시작
POST	/api/hermes/update	Hermes 업데이트
GET	/api/actions/{id}/status	액션 상태 확인

스킬 및 확장

메서드	경로	설명
GET	/api/skills	스킬 목록
PUT	/api/skills/toggle	스킬 활성/비활성
GET	/api/tools/toolsets	툴셋 목록

Cron

메서드	경로	설명
GET	/api/cron/jobs	Cron 작업 목록
POST	/api/cron/jobs	Cron 작업 생성
POST	/api/cron/jobs/{id}/pause	Cron 일시 중지
POST	/api/cron/jobs/{id}/resume	Cron 재개

---

대시보드 UI 기능

탭	기능
STATUS	Agent/Gateway 상태 개요, 활성 세션, 연결된 플랫폼 (Discord 등)
SESSIONS	대화 세션 목록, 메시지 검색, 새 채팅
ANALYTICS	토큰 사용량, 세션 통계, 일별/모델별 분석
LOGS	실시간 로그 뷰어 (레벨/컴포넌트 필터)
CRON	정기 작업 스케줄링 (cron 표현식)
SKILLS	스킬/툴셋 활성화 관리
CONFIG	설정 편집 (JSON/YAML)
KEYS	API 키 관리 (provider/tool/messaging)