npx -y @tencent-weixin/openclaw-weixin-cli@latest install을 실행한 뒤 QR을 스캔하면 바인딩됩니다. Wechaty 같은 회색 브리지에 의존할 필요가 없습니다. 본문은 공식 플러그인과 커뮤니티方案의 리스크 차이, 위챗 8.0.70·Gateway ready 등 전제, 6단계 따라하기와 세 가지 하드 데이터, 1:1 제한·24시간 규칙·안전 심사, 뚜껑 닫은 노트북이 ClawBot 호스트에 맞지 않는 이유와 KVMNODE 전용 클라우드 Mac + launchd 상주를 정리합니다. OpenClaw 24시간 안정 운영, 클라우드 Mac 설치 체크리스트, 공식 install-daemon, 진단 사다리, launchd token, CLI 정렬과 함께 읽으시기 바랍니다.
2026 위챗 ClawBot과 커뮤니티 브리지: 공식 플러그인이 바꾼 것
OpenClaw는 오랫동안 Telegram, Discord, Slack 등 해외 채널로 모바일과 연결해 왔습니다. 국내 팀이 위챗을 쓰려면 Wechaty, iPad 프로토콜, 각종 비공식 webhook만 있었습니다. 공통 문제는 프로토콜이 언제 무효화될지 불명확하고, 계정 정지·리스크가 불확실하며, 유지 비용이 개인 개발자에게 쏠린다는 점입니다. 2026년 3월 22일 전후 텐센트는 위챗 내 「위챗 ClawBot」 공식 플러그인을 공개하고 npm 스코프 @tencent-weixin/openclaw-weixin-cli를 배포했습니다. 「가동 중인 OpenClaw Gateway에 QR로 바인딩」 흐름이 정식 제품 절차가 되었습니다.
제품 의미에서 ClawBot은 위챗 내장 대형 언어 모델이 아니라, 이미 구성한 OpenClaw Agent(페르소나, MEMORY, Skills, 모델 라우팅)를 위챗 연락처 목록의 대화 창에 연결하는 장치입니다. 메시지는 위챗 클라이언트를 거치고, 추론과 도구 호출은 Gateway 호스트에서 실행됩니다. 텐센트는 콘텐츠 안전 심사를 하지만, 대화를 텐센트 모델에 위탁하는 것은 아닙니다. 장애 시 위챗 채널이 끊긴 것인지 Gateway·모델 API가 끊긴 것인지 구분해야 합니다.
프로토콜 준수: 공식 플러그인은 위챗 플러그인 체계를 따르며 커뮤니티 브리지의 정지·프로토콜 급변을 피합니다.
설치면이 좁음: 터미널 npx 한 줄이 QR을 만들며 중간 계층 서비스를 직접 띄울 필요가 없습니다.
능력은 OpenClaw 상속: 위챗에서 대화하는 상대는 고정 벤더 모델이 아니라 당신의 Agent입니다.
제품 제한이 명확: 현재는 1:1 채팅 중심이며 그룹·기업 시나리오는 기업 위챗 플러그인 등 별 채널이 필요합니다.
운영은 자측: Gateway 오프라인, 18789 unhealthy, launchd token 누락 시 위챗은 전송 불가 또는 지연으로만 보입니다.
클라우드 호스트에서 Gateway를 관측 가능한 상주 서비스로 만들지 않았다면, 먼저 install-daemon 따라하기를 끝낸 뒤 ClawBot을 여세요. 순서를 거꾸로 하면 QR 성공 후 첫 메시지가 「Gateway가 실제로 listen하지 않음」에서 멈추기 쉽습니다.
전제 조건 대조표: 위챗 버전, OpenClaw 준비, 모델 Key
ClawBot 설치 실패의 절반은 위챗 클라이언트 버전 미달, 나머지 절반은 OpenClaw 인스턴스가 truly ready가 아님에서 옵니다. 아래 표는 당직에서 맞출 항목을 모았으며 변경 티켓에 그대로 붙일 수 있습니다.
| 확인 항목 | 요건 | 미충족 시 전형 현상 |
|---|---|---|
| 위챗 버전 | iOS 8.0.70+ / Android 8.0.69+, 설정→플러그인에 ClawBot 표시 | 플러그인 목록에 진입 없음, 또는 QR 화면에서 버전 부족 |
| OpenClaw Gateway | openclaw gateway status --deep ready, 18789 단일 LISTEN | QR 성공 후 답장 없음, 또는 CLI RPC 타임아웃 |
| Node / CLI | install.sh·문서와 일치하는 Node 22, SSH와 launchd에서 which openclaw 일치 | install 스크립트가 Gateway를 못 찾거나 잘못된 인스턴스에 바인딩 |
| 모델 API | openclaw.json에 최소 한 개 유효 upstream Key | 위챗 송수신은 되나 답이 비거나 401, 위챗이 아니라 모델 과금 확인 |
| 네트워크 아웃바운드 | 호스트가 모델 API·npm registry 도달 | npx 패키지 실패 또는 QR 생성 타임아웃 |
터미널에서 Gateway를 healthy로 만든 뒤 위챗 플러그인을 여세요. 순서를 거꾸로 하면 모든 문제가 「위챗 고장」으로 기록됩니다.
KVMNODE 전용 클라우드 Mac에서는 상태 디렉터리가 iCloud·기업 동기화盘에 있지 않은지도 확인하세요. Gateway가 간헐적 DB 쓰기 실패를 내면 ClawBot은 무작위掉線처럼 보입니다. 자격·token은 launchd token과 진단 사다리 L2를 보고, 위챗 재설치를 먼저 하지 마세요.
6단계 따라하기: 위챗 플러그인부터 QR 바인딩·채널 인수
위챗 업그레이드: 나 → 설정 → 위챗 정보에서 버전을 확인하고 요건 충족 후 「플러그인」으로 돌아갑니다.
ClawBot 플러그인 활성화: 설정 → 플러그인 → 「위챗 ClawBot」 → 상세 페이지 설치 안내를 확인합니다.
Gateway 호스트에서 실행: npx -y @tencent-weixin/openclaw-weixin-cli@latest install (OpenClaw와 동일 머신 또는 SSH 세션).
위챗으로 터미널 QR 스캔 후 휴대폰에서 바인딩을 확인합니다. QR 유효 시간이 짧아 만료 시 이전 단계를 다시 실행합니다.
위챗 「위챗 ClawBot」 대화에 테스트 문장 전송 후 Gateway 로그와 openclaw channels probe(channels 프로브 설정 시)를 대조합니다.
Gateway 재시작 후 한 줄 더 전송: launchd 재기동 후에도 채널이 online인지 확인하고 버전·바인딩 시각·첫 메시지 타임스탬프를 변경 티켓에 기록합니다.
export PATH="/opt/homebrew/bin:/usr/local/bin:$PATH" openclaw gateway status --deep npx -y @tencent-weixin/openclaw-weixin-cli@latest install openclaw gateway restart openclaw channels probe 2>/dev/null || true
바인딩 명령은 Gateway가 실제로 돌아가는 호스트에서 실행해야 합니다. OpenClaw가 KVMNODE 싱가포르 노드에 있는데 로컬 노트북 터미널에서 npx를 돌리면 QR이 잘못된 인스턴스를 가리킵니다. 원격 팀은 클라우드 Mac에 SSH한 뒤 install하거나 ssh user@host 'npx ...'로 세션을 명시하세요.
1:1 채팅, 다중 Agent, 기업 위챗: 제품 형태 선택
공식 문서와 커뮤니티 실측은 현행 ClawBot이 1:1 채팅용이며 같은 플러그인을 위챗 그룹에 @로 넣을 수 없다고 합니다. 플러그인 인바운드는 OpenClaw resolveAgentRoute를 거치며 channel + accountId + peer로 라우트를 맞춥니다. 「각 위챗 계정 + 각 채팅 상대」에 독립 세션 컨텍스트가 있지만, 같은 위챗 대화에서 Agent 역할을 자주 바꾸는 것은 권장되지 않습니다. 상태 기계가 어지러워집니다.
| 운용 패턴 | 적용 | 주의 |
|---|---|---|
| 단일 위챗 + 주 Agent 내부 디스패치 | 대부분의 일상 어시스턴트 | 위챗에는 창 하나, 뒤에서 Skills로 업무 분기 |
| 복수 위챗 각각 한 Agent | 콘텐츠·운영 역할 하드 격리 | 플러그인은 다계정 online 지원, 각각 QR 스캔 |
| 기업 위챗 OpenClaw 플러그인 | 조직 봇·문서 협업 | 개인 ClawBot과 병행, 상호 대체 아님 |
기업 시나리오에서 그룹 봇·앱 메시지·문서 API가 필요하면 기업 위챗 쪽 공식 OpenClaw 플러그인(텐센트 문서 별도 유지)을 쓰고 개인 ClawBot을 기업 위챗 대체로 보지 마세요. 개인 위챗은 「언제든 내 Agent에게 묻기」, 기업 위챗은 「팀 플로·승인」용입니다. 두 채널을 같은 Gateway에 올릴 수 있지만 openclaw.json 라우트표에서 peer 규칙 중복을 피하세요.
주의사항, 장애 순서, 클라우드 Mac 상주 선정
QR 만료: 터미널 QR은 몇 분 내 무효입니다. 타임아웃 시 npx를 다시 실행하고 같은 스크린샷을 반복 스캔하지 마세요. 24시간 상호작용 규칙: 장시간 미대화 후 능동 푸시가 버려질 수 있어 「질문·답변」에 맞고 무인 마케팅 일괄 발송에는 맞지 않습니다. 콘텐츠 안전 심사: 위챗은 메시지를合规 검사하며 규칙 위반 시 전송 실패·경고로 나타납니다. OpenClaw에서 프롬프트·도구 출력을 조정하고 플러그인 재바인딩만 반복하지 마세요. Gateway 수면: 노트북 덮개를 닫으면 ClawBot이 끊깁니다. Telegram 채널掉線과 메커니즘은 같지만 위챗은 일일 입구라 체감이 큽니다.
공식 CLI 패키지명: @tencent-weixin/openclaw-weixin-cli. 커뮤니티 npm 가짜 패키지와 구분합니다.
기본 프로브 포트: Gateway는 여전히 18789로 로컬 헬스 체크. 설치 체크리스트와 일치합니다.
위챗 버전 임계: 8.0.70(iOS)/8.0.69(Android)가 2026년 3월 문서의 일반 표기입니다. 업그레이드 후 플러그인을 여세요.
장애 순서 권장: gateway status --deep → 모델 API 프로브 → npx install로 QR 재스캔 → Gateway 로그 확인 → 마지막에 위챗 재설치. channels 401·split brain이면 먼저 CLI·Gateway 정렬을 읽고 위챗에서 해제·재바인딩을 반복하지 마세요.
| 호스트 | ClawBot 체감 | 운영 결론 |
|---|---|---|
| 뚜껑 닫은 노트북 | 수면 즉시断線, QR 성공 후도 오래 못 감 | 개인 시험만 |
| 가정 NAS / 저사양 VPS | 돌아가나 Node·디스크 IO 흔들림 | 자체 모니터링 필요, Apple 생태 밖 |
| KVMNODE 전용 클라우드 Mac | launchd 상주 + 근접 Git·모델 아웃바운드 선택 | 7×24 위챗 입구의 프로덕션 기본 |
같은 클라우드 Mac에서 iOS CI와 다중 Skills를 병행하면 16GB 통합 메모리가 피크 주에 Gateway와 xcodebuild가 메모리를 나눠 써 위챗 답이 느려집니다(채널断가 아님). 이때는 동일 풀 격리 글을 참고해 M4 Pro로 올리거나 풀을 나누고 QR을 반복 스캔하지 마세요. 감사 가능·리전 변경 가능·ClawBot과 Gateway 동기가 필요한 팀에는 KVMNODE Mac mini 클라우드 대여가 실무 표준입니다. 전용 호스트, 육 리전, 일·월 단위 계약으로 18789, launchd, 모델 Key와 같은 Runbook을 공유합니다. SKU는 가격, 절차는 고객 센터, 주문은 주문에서 확인하시기 바랍니다.