WeChat — 모두의 앱 속 AI | Easy Understand Hermes Agent

이건 여러분의 위챗에 초고속 두뇌 비서를 붙이는 거라고 생각하면 돼요. 단, 그 비서는 클라우드에 살고 있고, 서버를 하나도 직접 만들 필요가 없다는 게 핵심이에요.

이게 다 뭐 하는 거야?

Hermes Agent는 오픈소스 AI 에이전트 프레임워크예요. 쉽게 말하면, 여러분이 즐겨 쓰는 메신저 앱을 AI 도구에 연결해서 질문에 답하고, 작업을 자동화하고, 심지어 일정 관리까지 시킬 수 있게 해줘요.

이 가이드에서는 위챗에 초점을 맞출게요. 전 세계 수십억 명이 매일 쓰는 개인 메신저죠. Hermes를 사용하면 간단한 QR 코드 로그인만으로 위챗에서 AI 봇과 대화할 수 있어요. 복잡한 웹훅도, 공인 IP 주소도, 서버 설정도 필요 없어요.

시작하기 전에 필요한 것

개인 위챗 계정 (휴대폰에 있는 그거)
컴퓨터에 설치된 Python
터미널 (Windows는 명령 프롬프트, Mac/Linux는 터미널)

이게 전부예요. 유료 API 키도, 클라우드 호스팅도 필요 없어요.

1단계: 필요한 패키지 설치하기

터미널을 열고 다음을 실행하세요:

pip install aiohttp cryptography

만약 Hermes를 “messaging” 옵션과 함께 설치했다면, 이것도 실행할 수 있어요:

cd ~/.hermes/hermes-agent && uv pip install -e ".[messaging]"

이건 터미널에 QR 코드를 예쁘게 표시하기 위한 추가 도구를 설치하는 거예요.

2단계: 설정 마법사 실행하기

위챗을 연결하는 가장 쉬운 방법은 내장된 마법사를 사용하는 거예요:

hermes gateway setup

물어보면 Weixin을 선택하세요. 마법사가 다음을 수행할 거예요:

위챗의 iLink Bot API에 QR 코드를 요청
터미널에 해당 QR 코드 표시 (또는 URL 제공)
휴대폰의 위챗 앱으로 스캔할 때까지 대기
로그인 자격 증명을 자동으로 저장

휴대폰에서 로그인을 확인하면 다음과 같은 메시지가 보일 거예요:

WeChat connected successfully, account_id=your-account-id

계정 ID는 자동으로 저장돼요.

3단계: 환경 변수 설정하기

이제 Hermes에 어떤 계정을 사용할지 알려줘야 해요. ~/.hermes/.env 파일을 열고 다음을 추가하세요:

WEIXIN_ACCOUNT_ID = your-account-id

또한 누가 봇과 대화할 수 있는지도 제어할 수 있어요:

WEIXIN_DM_POLICY = open
WEIXIN_ALLOWED_USERS = user_id_1,user_id_2

open은 누구나 봇에게 메시지를 보낼 수 있다는 뜻이에요
allowed_users는 특정 사람들로 제한할 수 있게 해줘요

잠깐, 현실 점검! (중요!)

이 어댑터는 여러분의 개인 위챗 계정에 직접 연결되는 게 아니라 iLink 봇 신원에 연결돼요. 즉:

봇은 개인 계정과 분리된 별도의 신원이에요
1:1 메시지와 소규모 그룹 채팅에서 안정적으로 작동해요
대량 발송이나 스팸용으로 설계된 게 아니에요

그러니까 봇을 확성기처럼 생각하지 말고, 든든한 동료처럼 대하세요.

첫 대화 시작하기

모든 설정이 끝났다면, 게이트웨이를 시작하세요:

hermes gateway start

그런 다음 휴대폰에서 위챗을 열고 봇 연락처를 찾아 “안녕”이라고 간단한 메시지를 보내보세요. 몇 초 안에 AI 비서로부터 답장을 받을 수 있을 거예요.

거기서부터 뉴스 요약, 이메일 초안 작성, 심지어 알림 설정까지 요청할 수 있어요. 위챗을 벗어날 필요 없이요.

요약 및 실용적인 팁

이제 여러분은 무료 오픈소스 도구를 통해 위챗 안에 살아있는 개인 AI 비서를 갖게 됐어요. 전체 설정은 10분도 채 걸리지 않고, 클라우드 인프라가 전혀 필요 없어요.

실용적인 팁: 실제 연락처를 초대하기 전에 소규모 친구 그룹이나 테스트 채팅부터 시작하세요. 이렇게 하면 봇의 동작 방식을 익히고, 권한 설정을 조정하고, 초반에 발생할 수 있는 어색한 실수를 피할 수 있어요. 자신감이 생기면, 문을 활짝 열고 위챗이 말하게 하세요.