Hermes v2026.7.7 새로운 기능: 더 간편해진 WhatsApp, Windows 자가 복구 등

안녕하세요, Hermes 팬 여러분! 최신 업데이트가 도착했습니다. 이번 업데이트는 꽤 큽니다. WhatsApp 설정을 훨씬 간편하게 만들고, Windows 사용자를 위한 안정성 개선도 대폭 추가했으며, 내부적으로도 여러 가지를 다듬었습니다. 자세히 살펴볼까요?

WhatsApp: 이제 내장 브리지로 간편하게 (Meta 계정 불필요)

가장 흥미로운 추가 기능 중 하나는 새로운 WhatsApp 통합입니다. 이제 Hermes는 Baileys 기반의 내장 브리지를 통해 WhatsApp에 연결됩니다. WhatsApp Web 세션을 에뮬레이션하는 방식이라고 생각하면 됩니다. Meta 개발자 계정도, 비즈니스 인증도, 번거로운 절차도 필요 없습니다.

빠른 시작: hermes gateway setup을 실행하고 WhatsApp을 선택하면 단계별 안내를 받을 수 있습니다.

두 가지 사용 방식

모드	작동 방식	추천 대상
전용 봇 번호 (권장)	봇 전용 전화번호를 하나 할당합니다. 사람들이 그 번호로 직접 메시지를 보냅니다.	깔끔한 UX, 다중 사용자, 차단 위험 낮음
개인 셀프 채팅	본인의 WhatsApp을 사용합니다. 자신에게 메시지를 보내 에이전트와 대화합니다.	빠른 설정, 단일 사용자, 테스트용

주의사항 한마디

WhatsApp은 공식 비즈니스 API 외부의 서드파티 봇을 공식적으로 지원하지 않습니다. 이 브리지를 사용하면 계정 제한의 약간의 위험이 있습니다. 안전하게 사용하려면:

봇 전용 전화번호를 따로 사용하세요 (개인 번호 말고)
대량 발송이나 스팸 메시지는 금지 — 대화 형태를 유지하세요
먼저 메시지를 보낸 사람이 아닌 상대에게 자동 발신 메시지를 보내지 마세요

또한 WhatsApp은 주기적으로 Web 프로토콜을 업데이트하며, 이로 인해 일시적으로 호환성이 깨질 수 있습니다. WhatsApp 업데이트 후 봇이 작동을 멈추면 최신 Hermes 버전을 받아 다시 페어링하세요.

WhatsApp 설정: 단계별 가이드

1단계: 설정 마법사 실행

hermes whatsapp

마법사가 다음 작업을 수행합니다:

사용할 모드를 묻습니다 (bot 또는 self-chat)
필요한 경우 브리지 의존성을 설치합니다
터미널에 QR 코드를 표시합니다
스캔할 때까지 기다립니다

QR 코드 스캔 방법:

휴대폰에서 WhatsApp을 엽니다
설정 → 연결된 기기로 이동합니다
기기 연결을 탭합니다
터미널의 QR 코드에 카메라를 맞춥니다

팁: QR 코드가 깨져 보이면 터미널 너비를 최소 60열 이상으로 설정하고 유니코드를 지원하는지 확인하세요.

2단계: 두 번째 전화번호 확보 (봇 모드)

봇 모드에서는 WhatsApp에 이미 등록되지 않은 번호가 필요합니다. 선택 옵션은 다음과 같습니다:

옵션	비용	참고 사항
Google Voice	무료	미국만 가능. Google Voice 앱을 통해 SMS로 WhatsApp 인증을 받으세요.
선불 SIM	$5–15 일회성	활성화 후 인증하고, SIM은 서랳에 보관하면 됩니다. 90일마다 한 번씩 통화로 유지하세요.
VoIP 서비스	무료–월 $5	TextNow, TextFree 등. 일부 번호는 차단될 수 있으니 여러 개 시도해 보세요.

3단계: Hermes 설정

~/.hermes/.env 파일에 다음을 추가하세요:

# 필수
WHATSAPP_ENABLED=true
WHATSAPP_MODE=bot                          # "bot" 또는 "self-chat"

# 접근 제어 — 하나만 선택:
WHATSAPP_ALLOWED_USERS=15551234567         # 쉼표로 구분된 번호 목록 (국가 코드 포함, + 제외)
# WHATSAPP_ALLOWED_USERS=*                 # 또는 모두 허용
# WHATSAPP_ALLOW_ALL_USERS=true            # 또는 이 플래그 사용 (*와 동일)

~/.hermes/config.yaml의 선택적 동작 설정:

unauthorized_dm_behavior: pair

whatsapp:
  unauthorized_dm_behavior: ignore

unauthorized_dm_behavior: pair는 전역 기본값입니다 — 인증되지 않은 DM 발신자에게 페어링 코드가 전송됩니다.
whatsapp.unauthorized_dm_behavior: ignore는 인증되지 않은 DM에 대해 WhatsApp이 조용히 넘어가게 합니다 — 개인 번호에는 보통 이 방식이 더 좋습니다.

그런 다음 게이트웨이를 시작하세요:

hermes gateway              # 포그라운드 실행
hermes gateway install      # 사용자 서비스로 설치
sudo hermes gateway install --system   # Linux 전용: 부팅 시 시스템 서비스로 실행

세션 유지

브리지는 세션을 ~/.hermes/platforms/whatsapp/session에 저장합니다. 즉:

세션이 재시작 후에도 유지됩니다 — 매번 QR 코드를 다시 스캔할 필요가 없습니다
세션 데이터에는 암호화 키와 기기 자격 증명이 포함됩니다
이 세션 디렉토리를 공유하거나 커밋하지 마세요 — 계정에 대한 전체 액세스 권한을 부여합니다

재페어링

세션이 끊기면(휴대폰 초기화, WhatsApp 업데이트, 수동 연결 해제 등) 게이트웨이 로그에 연결 오류가 표시됩니다. hermes whatsapp을 다시 실행하여 새 QR 코드를 생성하고 재페어링하세요.

Windows 자가 복구 및 안정성

또한 Windows용 자가 복구 기능도 추가했습니다. 이제 게이트웨이가 일반적인 서비스 오류를 자동으로 감지하고 복구하여 다운타임과 수동 개입을 줄여줍니다. 이는 Hermes를 모든 플랫폼에서 견고하게 만들기 위한 지속적인 노력의 일환입니다.

마무리

이번 업데이트는 Hermes를 더 쉽게 접근하고 더 안정적으로 만드는 데 중점을 두었습니다. WhatsApp을 처음 설정하든 프로덕션 봇을 운영하든, 모든 것을 지원합니다. 언제나처럼 최신 버전을 받아서 사용해 보시고 의견을 알려주세요!

자동화를 즐기세요! 🚀