Hermes Agent 운영 가이드

일상적인 운영에 필요한 명령어와 절차를 모아둡니다.

---

Dashboard 접속

1. 브라우저에서 https://gommes.jimin.io/ 접속
2. Dashboard UI에서 모든 기능 사용 가능
3. STATUS 탭에서 Gateway/Discord 상태 실시간 확인

---

Discord 연동 상태 확인

curl -s https://gommes.jimin.io/api/status | python3 -c "
import sys,json
d=json.load(sys.stdin)
print(f'Gateway running: {d[\"gateway_running\"]}')
print(f'Discord: {d[\"gateway_platforms\"].get(\"discord\",{}).get(\"state\",\"N/A\")}')
print(f'Sessions: {d[\"active_sessions\"]}')
"

---

세션 토큰 확인

Dashboard API 호출에 필요한 인증 토큰:

curl -s https://gommes.jimin.io/ | grep -o '__HERMES_SESSION_TOKEN__="[^"]*"' | cut -d'"' -f2

---

Gateway 재시작

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

---

API 키 및 환경변수 관리

키 등록

TOKEN="<session-token>"
curl -X PUT "https://gommes.jimin.io/api/env" \
  -H "x-hermes-session-token: ${TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{"key":"VARIABLE_NAME","value":"variable-value"}'

키 확인

curl -s "https://gommes.jimin.io/api/env" \
  -H "x-hermes-session-token: ${TOKEN}"

키 삭제

curl -X DELETE "https://gommes.jimin.io/api/env" \
  -H "x-hermes-session-token: ${TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{"key":"VARIABLE_NAME"}'

---

설정 변경

# 모델 변경
curl -X PUT "https://gommes.jimin.io/api/config" \
  -H "x-hermes-session-token: ${TOKEN}" \
  -d '{"config":{"model":{"default":"openai/deepseek-v4-flash"}}}'
 
# 설정 확인 (JSON)
curl -s "https://gommes.jimin.io/api/config" -H "x-hermes-session-token: ${TOKEN}"
 
# Raw YAML 확인
curl -s "https://gommes.jimin.io/api/config/raw" -H "x-hermes-session-token: ${TOKEN}"

---

Docker 명령어

# 컨테이너 쉘 접속
docker exec -it hermes-dydp3k-gateway-1 bash
 
# 컨테이너 내부에서 CLI 사용
source /opt/hermes/.venv/bin/activate
hermes <command>
 
# 전체 경로로 직접 실행
/opt/hermes/.venv/bin/hermes <command>
 
# 페어링 승인
source /opt/hermes/.venv/bin/activate && hermes pairing approve discord <코드>

---

Cron 작업 (정기 작업)

Dashboard CRON 탭에서 관리 가능:

• 일일 보고서
• 정기 백업
• 주간 감사

슬래시 명령어 예시: /cron add "0 9 * * *" "오늘 할 일 요약해줘" --channel #general

---

주요 포트

서비스	내부 포트	용도
gateway	8642	OpenAI 호환 API, 헬스체크
dashboard	9119	Web UI (Traefik → HTTPS 443)

---

문제 발생 시 체크리스트

1. 컨테이너 상태 확인: dokploy_docker-getContainersByAppNameMatch(appName="hermes-dydp3k")
2. Gateway 상태 확인: GET /api/status
3. Dashboard 접속 확인: https://gommes.jimin.io/
4. Discord 연결 확인: /api/status > gateway_platforms.discord.state
5. Gateway 재시작: POST /api/gateway/restart
6. 컨테이너 교체: Dokploy UI에서 stop → deploy