Hermes Agent VPS 호스팅 — 빠른 시작 가이드
초기 설정이 완료된 후, Hermes Agent를 빠르게 사용하기 위한 가이드입니다.
💡 요약 정리
- 웹 대시보드:
http://{아이디}.mycafe24.com:9119 - 터미널 채팅: SSH 접속 후
hermes-chat한 줄이면 시작 - 텔레그램 연동 시 PC/모바일/태블릿 어디서든 대화 가능
- 대화 중 중요한 정보는 AI가 자동으로 영구 기억
- 파일 읽기/쓰기, 코드 실행, 27개 카테고리 78개 내장 스킬, 크론 작업까지 지원
1. 웹 대시보드 접속
브라우저에서 아래 주소로 대시보드에 접속할 수 있습니다.
http://{아이디}.mycafe24.com:9119
대시보드에서는 에이전트 상태 확인, 로그 조회, 설정 관리 등을 웹 UI로 수행할 수 있습니다.
접속이 안 되면 방화벽관리에서 9119번 포트에 접속 IP가 등록되어 있는지 확인하세요.
2. 터미널 채팅 (hermes-chat)
SSH 접속 후 한 줄이면 바로 AI와 대화할 수 있습니다.
ssh root@{아이디}.mycafe24.com
hermes-chat
터미널 TUI 화면이 열리며, 텍스트를 입력하면 AI가 응답합니다.
채팅 중 유용한 기능
| 명령 | 설명 |
|---|---|
/help | 도움말 표시 |
/model | 현재 모델 확인 / 변경 |
/session | 세션 정보 확인 |
/clear | 현재 세션 초기화 |
/exit | 채팅 종료 |
Ctrl+C | 현재 응답 중단 |
Ctrl+B | 음성 입력 (마이크) |
3. 텔레그램으로 대화하기
초기 설정에서 텔레그램을 연동했다면, 봇에게 메시지를 보내면 됩니다.
- 텔레그램에서 설정한 봇 검색
- 메시지 입력 → AI 응답 수신
텔레그램은 어디서든 사용 가능 — PC, 모바일, 태블릿
4. AI에게 기억시키기
Hermes Agent의 핵심 기능은 영구 기억입니다. 대화 중 중요한 정보를 말하면 AI가 자동으로 기억합니다.
예시:
사용자: 나는 카페24에서 호스팅 사업을 담당하고 있어
Hermes: 알겠습니다. 카페24 호스팅 사업 담당이시군요. 기억해둘게요.
(다음 날)
사용자: 어제 뭘 부탁했더라?
Hermes: 어제 카페24 호스팅 사업 관련해서...
기억 관련 명령
| 방법 | 설명 |
|---|---|
| 자연스럽게 대화 | AI가 중요한 정보를 자동 감지하여 기억 |
| "이것 기억해" | 명시적으로 기억 요청 |
hermes-setup > [0] > [1] | 세션/메모리 초기화 (기억 삭제) |
5. 파일 작업
Hermes Agent는 서버 내 파일을 직접 읽고 쓸 수 있습니다.
예시:
사용자: /opt/hermes/data/ 안에 있는 파일 목록 보여줘
사용자: report.md 파일을 만들어서 오늘 회의 내용 정리해줘
사용자: config.yaml 파일 내용 확인해줘
6. 코드 실행
AI에게 코드를 실행하도록 요청할 수 있습니다.
예시:
사용자: Python으로 현재 날짜/시간 출력해줘
사용자: 이 CSV 파일 분석해서 차트 만들어줘
사용자: curl로 내 서버 상태 확인해줘
코드 실행은 approvals.mode 설정에 따라 승인이 필요할 수 있습니다.
기본값은 manual — AI가 코드를 실행하기 전에 사용자 확인을 요청합니다.
7. 스킬 활용
Hermes Agent에는 27개 카테고리, 78개 내장 스킬이 있습니다.
주요 스킬 카테고리
| 카테고리 | 할 수 있는 것 |
|---|---|
productivity | 일정 관리, 메모, 할 일 목록 |
software-development | 코드 작성, 디버깅, TDD |
data-science | 데이터 분석, 시각화 |
email | 이메일 읽기/보내기 (IMAP/SMTP) |
github | GitHub 리포 관리, PR, 이슈 |
research | 웹 검색, 논문 조회 |
creative | 글쓰기, 아이디어 브레인스토밍 |
devops | 서버 관리, 배포 자동화 |
social-media | SNS 관리 |
smart-home | 스마트홈 기기 제어 |
자동 스킬 생성
반복적으로 요청하는 작업이 있으면 Hermes가 자동으로 스킬로 만들어줍니다.
사용자: 매주 월요일 아침에 이번 주 할 일 정리해줘
Hermes: 매주 월요일 09:00에 실행되는 '주간 할 일 정리' 스킬을 만들까요?
8. 크론 작업
정기적으로 반복할 작업을 설정할 수 있습니다.
사용자: 매일 오전 9시에 뉴스 요약해줘
사용자: 매주 금요일에 주간 리포트 만들어줘
크론 작업은 /opt/hermes/data/cron/에 저장되며, 60초 간격으로 실행 여부를 확인합니다.
설정 변경, Credential Pool, Fallback Model 등 고급 관리는 운영 가이드를 참조하세요.
빠른 참고: 관리 명령어
| 하고 싶은 것 | 명령어 |
|---|---|
| AI와 터미널 대화 | hermes-chat |
| 웹 대시보드 접속 | 브라우저에서 http://{아이디}.mycafe24.com:9119 |
| 설정 변경 | hermes-setup |
| 에이전트 + 대시보드 시작 | hermes-start |
| 에이전트 + 대시보드 중지 | hermes-stop |
| 전체 재시작 | hermes-restart |
| 최신 이미지로 업데이트 | hermes-update |
| 이전 이미지로 롤백 | hermes-update --rollback |
| 모델 변경 | hermes-setup > [1] > Model & Provider, 또는 /model |
| 메신저 추가 | hermes-setup > [1] > Messaging Platforms, 또는 CLI hermes setup gateway |
| 상태 확인 | hermes-setup > [2] Status Check |
| 로그 보기 | hermes-setup > [3] View Logs |
| 기억 초기화 | hermes-setup > [0] > [1] Reset Sessions/Memories |