HermesClaw – 여러 WeChat 연동 LLM 봇을 하나의 계정으로 실행

기능 설명

HermesClaw는 단일 WeChat 계정으로 세 가지 다른 AI 에이전트와 동시에 통신할 수 있는 경량 Python 프록시입니다.

Hermes Agent (Nous Research)
OpenClaw ("랍스터" 어시스턴트)
OpenCode (코드 특화 LLM, 예: MiniMax M2.5 Free)

WeChat은 계정당 iLink 연결을 하나만 허용하므로 일반적으로 Hermes Agent또는 OpenClaw 중 하나만 실행할 수 있습니다. HermesClaw는 유일한 iLink 폴러가 되어 수신된 각 메시지를 적절한 로컬 프록시(OpenCode용 ACP 브리지 포함)로 전달합니다. 간단한 슬래시 명령으로 활성 봇을 전환하거나 두/세 봇이 함께 응답하도록 할 수 있습니다.

사용 가치

장점 결합 – 일반 채팅은 Hermes에 맡기고 특정 질문은 OpenClaw가 답변하거나 코드 관련 작업은 OpenCode가 처리하도록 할 수 있습니다.
음성-코드 변환 – WeChat 음성 메시지를 보내면 HermesClaw가 전사를 OpenCode로 전달하여 코드 생성 또는 편집이 가능합니다.
원클릭 전환 – /hermes, /openclaw, /opencode, /both, /three로 라우팅을 즉시 변경할 수 있습니다.
원래 에이전트 코드 변경 불필요 – 프록시는 원시 iLink 메시지만 전달하며 각 에이전트는 자체 미디어 복호화, 포맷팅, LLM 호출을 수행합니다.

작동 방식(개요)

 iLink API  ←→  HermesClaw (유일한 폴러)
   │               │          │          │
   │               ├─ Proxy A (19999) → OpenClaw gateway
   │               ├─ Proxy B (19998) → Hermes gateway
   │               └─ ACP bridge      → OpenCode subprocess
   │
   └─ 원시 iLink 메시지(텍스트, 음성 전사, 이미지/비디오 URL 등)

HermesClaw는 메시지를 수신하고 명령 접두사를 확인한 후 선택된 프록시로 페이로드를 전달합니다. 여러 에이전트가 활성 상태일 때 응답에는 작은 태그([Hermes Agent], [OpenClaw], [OpenCode])가 붙어 WeChat으로 다시 전송됩니다.

시작하기

필요한 에이전트 설치 – 최소 하나:
- OpenClaw + clawbot (openclaw-weixin 패키지)
- WeChat 게이트웨이가 있는 Hermes Agent
원라이너 설치 프로그램 실행:
```
curl -fsSL https://raw.githubusercontent.com/AaronWong1999/hermesclaw/main/install.sh | bash
```
- 존재하는 게이트웨이 감지
- 설정 파일에서 iLink 토큰 추출
- 각 게이트웨이를 로컬 프록시 포트로 패치
- Python 종속성 설치 (requests, python-dotenv)
- systemd 서비스(macOS에서는 launchd) 설정으로 HermesClaw 상시 실행
게이트웨이 재시작 후 WeChat에서 /whoami를 보내 경로를 확인합니다.
(선택) OpenCode 추가 – npm install -g opencode-ai; 설치 프로그램이 자동 감지하여 /opencode와 /three를 활성화합니다.

WeChat에서 사용할 명령어

명령어	효과
`/hermes`	Hermes Agent로만 라우팅
`/openclaw`	OpenClaw로만 라우팅
`/opencode`	OpenCode로만 라우팅
`/both`	Hermes + OpenClaw로 전송. 응답은 봇 이름이 접두사로 붙음
`/three`	세 에이전트 모두에 동시 전송
`/whoami`	활성 라우트와 각 프록시 상태 표시
기타 텍스트	현재 활성 에이전트로 전달

설치 세부 사항

Python 프록시 – hermesclaw.py (약 870줄)는 두 개의 HTTP 프록시와 ACP 브리지를 구현.
설치 스크립트 – install.sh는 환경을 자동 감지하고 설정 파일을 패치하며 systemd 유닛(macOS에서는 launchd plist)을 생성하고 -y 또는 HERMESCLAW_YES=1로 비대화식 실행 가능.
테스트 – 117개의 pytest 케이스가 라우팅, 미디어 처리, ACP 복구, 설치 프로그램 엣지 케이스를 다룸.
제거 – 스크립트 제거로 원래 게이트웨이 설정을 복원하고 백그라운드 서비스를 비활성화.

만든 사람

Aaron Wong (@AaronWong1999), Hermes Agent 및 OpenClaw 커뮤니티의 기여 포함. 프로젝트는 MIT 라이선스입니다.

HermesClaw는 AI 모델 자체를 수정하지 않습니다. 단순히 여러 기존 WeChat 연동 LLM 봇을 하나의 계정으로 실행할 수 있게 해줍니다.

AaronWong1999/hermesclaw