메시징 게이트웨이

기준일: 2026-06-07
난이도: 중급
공식 기준: Messaging Gateway, Tool Gateway, Nous Portal

Hermes Messaging Gateway는 CLI 밖에서 Hermes와 대화하게 해주는 백그라운드 프로세스입니다. Telegram, Discord, Slack, WhatsApp, Signal, Email, Home Assistant 등 다양한 플랫폼을 연결할 수 있고, 세션과 cron 작업도 함께 운영합니다.

주의할 점은 Messaging Gateway와 Nous Tool Gateway가 다르다는 것입니다. Messaging Gateway는 외부 채팅 플랫폼을 연결하고, Tool Gateway는 web search, image generation, TTS, cloud browser 같은 도구 호출을 Nous Portal 구독으로 라우팅합니다.

핵심 개념

게이트웨이는 편리하지만 권한 표면도 넓힙니다. 메신저에서 도착한 메시지가 로컬 터미널 도구까지 이어질 수 있으므로, 사용자 승인과 플랫폼 제한이 중요합니다.

선택 기준

게이트웨이를 쓰기 좋은 경우:

• 이동 중에도 같은 Hermes 세션을 쓰고 싶다.
• 팀 채널에서 봇 형태로 작업을 요청하고 싶다.
• cron 결과를 특정 채널로 받고 싶다.
• 음성, 이미지, 파일 첨부를 플랫폼별로 활용하고 싶다.

CLI만 유지하는 것이 나은 경우:

• 로컬 파일 시스템 접근 권한이 민감하다.
• 누가 메시지를 보낼 수 있는지 통제하기 어렵다.
• 아직 승인 정책과 allowlist를 정하지 않았다.

실습

게이트웨이 설정:

hermes gateway setup
hermes gateway status

서비스 운영:

hermes gateway
hermes gateway install
hermes gateway start
hermes gateway stop

Nous Tool Gateway 상태 확인:

hermes setup --portal
hermes tools
hermes portal info
hermes portal tools
hermes status

hermes tools에서는 web, image generation, TTS, browser 같은 도구별로 Nous Subscription 또는 개별 provider key를 선택합니다. use_gateway: true는 해당 도구를 Nous 경유로 라우팅하고, 직접 키가 있는 도구는 개별 provider를 유지할 수 있습니다.

첫 플랫폼 연결 전 확인:

이 플랫폼을 Hermes Gateway에 연결하기 전에 필요한 allowlist,
관리자 권한, 세션 reset 정책, 위험 명령 승인 기준을 점검해줘.

Hermes에 입력할 프롬프트

Telegram과 Slack 중 어느 플랫폼을 먼저 Hermes Gateway에 연결하는 게 안전한지 비교해줘.
내 기준은 개인 테스트, 허용 사용자 제한, 파일 첨부 위험, 운영 난이도야.
최소 설정 순서와 검증 명령을 제안해줘.

체크리스트

• Gateway를 켜야 하는 이유가 CLI 사용보다 명확하다.
• allowed users 또는 DM pairing을 설정한다.
• 플랫폼별 세션 reset 정책을 이해했다.
• Messaging Gateway와 Nous Tool Gateway를 혼동하지 않는다.
• 도구별 라우팅은 hermes portal info, hermes portal tools, hermes status로 확인한다.
• 위험 명령 승인 정책이 gateway 환경에도 적용된다.
• gateway log와 status 확인 방법을 알고 있다.

다음 단계

• 보안과 승인에서 gateway 권한 경계를 강화합니다.
• 트러블슈팅에서 gateway 로그 확인 순서를 봅니다.
• Claude/OpenClaw와 비교에서 OpenClaw와의 차이를 정리합니다.