메시징 게이트웨이
기준일: 2026-06-06
난이도: 중급
공식 기준: Messaging Gateway
Hermes Gateway는 CLI 밖에서 Hermes와 대화하게 해주는 백그라운드 프로세스입니다. Telegram, Discord, Slack, WhatsApp, Signal, Email, Home Assistant 등 다양한 플랫폼을 연결할 수 있고, 세션과 cron 작업도 함께 운영합니다.
핵심 개념
| 항목 | 설명 |
|---|---|
| platform adapter | 각 메시징 플랫폼을 Hermes 세션으로 연결 |
| session store | 채팅별 대화 상태 관리 |
| gateway service | 백그라운드 실행/중지/상태 확인 |
| platform toolset | 플랫폼별로 노출되는 도구 범위 |
| allowlist/pairing | 누가 에이전트를 사용할 수 있는지 제한 |
게이트웨이는 편리하지만 권한 표면도 넓힙니다. 메신저에서 도착한 메시지가 로컬 터미널 도구까지 이어질 수 있으므로, 사용자 승인과 플랫폼 제한이 중요합니다.
선택 기준
게이트웨이를 쓰기 좋은 경우:
- 이동 중에도 같은 Hermes 세션을 쓰고 싶다.
- 팀 채널에서 봇 형태로 작업을 요청하고 싶다.
- cron 결과를 특정 채널로 받고 싶다.
- 음성, 이미지, 파일 첨부를 플랫폼별로 활용하고 싶다.
CLI만 유지하는 것이 나은 경우:
- 로컬 파일 시스템 접근 권한이 민감하다.
- 누가 메시지를 보낼 수 있는지 통제하기 어렵다.
- 아직 승인 정책과 allowlist를 정하지 않았다.
실습
게이트웨이 설정:
hermes gateway setup
hermes gateway status
서비스 운영:
hermes gateway
hermes gateway install
hermes gateway start
hermes gateway stop
첫 플랫폼 연결 전 확인:
이 플랫폼을 Hermes Gateway에 연결하기 전에 필요한 allowlist,
관리자 권한, 세션 reset 정책, 위험 명령 승인 기준을 점검해줘.
Hermes에 입력할 프롬프트
Telegram과 Slack 중 어느 플랫폼을 먼저 Hermes Gateway에 연결하는 게 안전한지 비교해줘.
내 기준은 개인 테스트, 허용 사용자 제한, 파일 첨부 위험, 운영 난이도야.
최소 설정 순서와 검증 명령을 제안해줘.
체크리스트
- Gateway를 켜야 하는 이유가 CLI 사용보다 명확하다.
- allowed users 또는 DM pairing을 설정한다.
- 플랫폼별 세션 reset 정책을 이해했다.
- 위험 명령 승인 정책이 gateway 환경에도 적용된다.
- gateway log와 status 확인 방법을 알고 있다.
다음 단계
- 보안과 승인에서 gateway 권한 경계를 강화합니다.
- 트러블슈팅에서 gateway 로그 확인 순서를 봅니다.
- Claude/OpenClaw와 비교에서 OpenClaw와의 차이를 정리합니다.