2026 WeChat ClawBot 공식 플러그인 완전 가이드:
@tencent-weixin/openclaw-weixin-cli로 OpenClaw 연결, 버전 요건과 1:1/심사/권한 함정 (일일 macOS 격리 검증)
OpenClaw Gateway는 이미 떠 있는데 개인 WeChat에 어시스턴트를 붙이고 싶고, 서드파티 브리지나 비공식 프로토콜은 피하고 싶다면 Tencent가 2026년에 낸 ClawBot 공식 플러그인이 QR 바인딩의 정식 경로입니다. 반면 1:1 전용·콘텐츠 심사·서브계정 운영·Gateway 상시 도달을 무시하면 «연결은 됐는데 답이 없다»를 모델 장애로 오판하기 쉽습니다. 본문은 개발자·자체 호스팅 운영을 위해 세 가지 통증, ClawBot vs 다른 IM 매트릭스, 7단계, 분류표, 지표 3개, 1~3일 일일 macOS 일정을 제공합니다. 연결: 설치·배포 가이드, Telegram/Discord 채널 페어링, Microsoft Teams 연동, SSH/VNC FAQ.
목차
01. 세 가지 통증: ClawBot을 «또 다른 Telegram»으로 보기, 메인 계정 바인딩, Gateway 간헐 오프라인
1) 멘탈 모델 불일치: ClawBot은 openclaw.json에 Bot Token만 넣으면 끝나는 채널이 아닙니다. WeChat 클라이언트 공식 플러그인과 호스트의 @tencent-weixin/openclaw-weixin-cli가 만드는 일회용 QR로 계정 단위 바인딩이 이뤄집니다. Telegram/Discord Allowlist·페어링 감각으로 WeChat 설정을 바꾸면 밤새 «모델 라우팅»을 의심하게 됩니다. 합격 신호는 QR 성공 + Gateway 프로세스 지속 도달 + 연락처에 어시스턴트 대화 출현입니다.
2) 메인 WeChat ID와 컴플라이언스: 메시지는 Tencent 인프라를 거치며 콘텐츠 안전 정책 대상이 됩니다. 금융·암호화폐 등은 필터되기 쉽습니다. 일상 메인 계정으로 ClawBot을 묶으면 정책·그레이아웃 변경 시 실제 소셜 그래프에 영향이 갑니다. Runbook 기본값은 검증 전용 서브계정이며, OpenClaw 작업 디렉터리·Skills·파일 도구를 최소 권한 샌드박스에 둡니다(다중 플랫폼 설치 가이드의 격리 원칙과 동형).
3) «Gateway는 살아 있는데 WeChat은 묵음»: ClawBot은 OpenClaw가 도는 호스트(또는 터널 뒤 동등 엔드포인트)가 장시간 도달 가능해야 합니다. 노트북 슬립, 가정용 NAT 드리프트, Docker restart 미설정은 «가끔 답하지만 밤에는 반드시 끊김»으로 보입니다. Teams Dev Tunnel + webhook 3978과 달리 WeChat에는 «공인 URL을 하나 더» 넣는 두 번째 기회가 없고, 바인딩 세션과 Gateway 하트비트가 동수명임을 Runbook에 적으십시오.
02. ClawBot vs Telegram/Discord: 공식 채널 결정 매트릭스
30초 안에 ClawBot인지 성숙한 IM 채널인지 가르는 표입니다.
| 관점 | WeChat ClawBot(공식) | Telegram / Discord | 일일 macOS 증거 |
|---|---|---|---|
| 연결 방식 | WeChat «설정→기능→플러그인» + CLI QR | Bot Token / OAuth + channels.* |
QR 전후 터미널 stdout(마스킹) |
| 대화 형태 | 1:1만(2026 공개 설명 기준 그룹 미지원) | 그룹·Topic·Allowlist | 테스트 서브계정에서 프로브 3통 |
| 파일 | 흔히 수신만·송신 불가로 설명 | 채널 플러그인·권한 의존 | 수용에서 «WeChat PDF 회송»에 의존하지 않음 |
| 계정 리스크 | 공식 경로·심사·그레이 정책 변경 가능 | 플랫폼 ToS + 자체 Allowlist | Runbook에 «비메인 ID»·보존 정책 |
| 클라이언트 버전 | iOS ≥ 8.0.70, Android ≥ 8.0.69(그레이는 Tencent 기준) | WeChat 무관 | 바인딩 전 «WeChat 정보» 화면 저장 |
그룹 @봇·아웃바운드 파일·테넌트 횡단 기업 IM이 필수면 Teams나 Telegram/Discord를 우선하고 ClawBot을 만능 채널로 쓰지 마십시오.
03. 7단계: Gateway 준비 → WeChat 플러그인 → CLI QR → 첫 메시지 → doctor → 권한 축소 → 증거
- OpenClaw 기준선: 설치 가이드로 Gateway를 띄우고
openclaw --version, 로드된openclaw.json,gateway status,doctor를 기록합니다. Node는 22.19+ 또는 문서 권장 24.x를 권장합니다. - WeChat에서 ClawBot 활성화: 버전 요건 충족 후 «나»→«설정»→«기능»→«플러그인»→ ClawBot ON. 목록이 없으면 버전 확인·재시작을 먼저 하고 미확인 상태에서 QR을 반복하지 않습니다.
- 공식 CLI를 Gateway 호스트에서 실행: 동일 머신(또는 SSH)에서 install을 실행하고 수 분 내 WeChat «스캔»으로 확정합니다.
- 바인딩·첫 수용: 연락처에 어시스턴트가 보이면 짧은 프로브를 보내 Gateway 로그 inbound/outbound를 시각 대조합니다.
- doctor·모델 인증: 무응답 시 Gateway 생존·API Key·WeChat 필터 순으로 분기하고, 곧바로 채널 라우트를 바꾸지 않습니다.
- 권한·디렉터리: Agent 작업 공간을 전용 경로로 제한하고 불필요한
file_write·고위험 Skills를 끕니다. ClawHub 스킬은 격리 환경에서 먼저 시험합니다. - 증거·삭제: CLI 출력·로그·버전 화면을 마스킹 저장하고, 일일 호스트에서는 바인딩 해제·데모 키 삭제까지 합니다.
# Gateway 호스트에서 실행 (Tencent 공식 npm 스코프)
npx -y @tencent-weixin/openclaw-weixin-cli@latest install
openclaw gateway status
openclaw doctor 2>&1 | tee /tmp/clawbot-doctor.txt
# WeChat: 어시스턴트에 프로브 전송 후 Gateway 로그 대조QR 만료: npx를 재실행하고 스크린샷 재사용을 피합니다. 스캔 후에도 연락처 없음: CLI와 Gateway가 동일 도달 호스트인지, 방화벽 아웃바운드를 확인합니다. 디스크 여유 15 GB 미만이면 병행 설치가 불안정해집니다. 대역폭은 FAQ를 참고하십시오.
04. 분류표: 증상 → 우선 조치 → 흔한 오조작
| 증상 | 우선 조치 | 흔한 오조작 |
|---|---|---|
| 플러그인 목록에 ClawBot 없음 | WeChat 업데이트·그레이/지역 설명·재시작 | 구버전에서 비공식 OpenClaw 브리지 시도 |
| 스캔 실패·만료 | npx … install 재실행·단말 시각 동기화 |
앨범의 오래된 QR 반복 시도 |
| 수신은 있는데 답이 비거나 극단적으로 짧음 | 심사·민감어·모델 전환·Gateway OOM | 즉시 메인 WeChat 재설치 |
| 야간에 반드시 끊김 | 슬립·systemd/launchd·공인 도달성 | WeChat만 재시작하고 Gateway 방치 |
| 그룹에서 @하고 싶음 | Telegram/Discord/Teams로 전환(ClawBot 비지원) | 비공식 그룹 bot 브리지(BAN 위험) |
05. 지표 3개·오해와 1~3일 일일 macOS 일정
- 지표 1: Tencent는 npm 스코프
@tencent-weixin으로openclaw-weixin-cli를 배포합니다. 커뮤니티 문서는 ClawBot 공개를 2026년 3월 전후에 두는 경우가 많아 «공식 경로» 감사 근거가 됩니다(비공식 리버스 엔지니어링 아님). - 지표 2: 공개 요건은 iOS WeChat ≥ 8.0.70, Android ≥ 8.0.69(그레이는 Tencent 기준). 미만이면 플러그인 항목 자체가 보이지 않을 수 있습니다.
- 지표 3: M4 일일 대여에서 OpenClaw 기준이 있으면 «CLI QR + 첫 양방향 + doctor 저장»이 팀 샘플에서 2~4시간 단일 세션에 들어가는 경우가 많습니다. 메인 Mac 슬립 후 재바인딩보다 야간 당직을 줄입니다.
오해 A: 기업 WeChat 그룹 bot과 동일. 오해 B: 메인 ID + Agent에 전체 디스크 권한. 오해 C: Gateway 상시 미설정인데 «프로덕션 완료» 선언.
1일차: 격리 호스트에서 OpenClaw 설치·doctor, 저녁 WeChat 플러그인·QR·로그 저장. 2일차: 20라운드 대화·파일 단방향·심사 샘플(프로덕션 데이터 금지). 3일차: 프로덕션 전환 Runbook, 바인딩 해제, 키 삭제, Telegram/Teams를 그룹 보조로 남길지 결정.
06. 가정용 PC/클라우드 vs 일일 Mac: QR과 Control UI 증거선
Gateway를 슬립하는 가정용 Mac이나 GUI 없는 저가 VPS에 두면 스마트폰으로 QR을 읽으면서 다른 머신 로그를 쫓는 숨은 비용이 커집니다. 짧은 네이티브 macOS 대여면 npx @tencent-weixin/..., gateway status, Control UI, Keychain 읽기 전용 키를 한 증거선에 맞추고 프로덕션 이전을 결정할 수 있습니다.
상시 클라우드 + systemd는 7×24 확정 후에 맞습니다. 1~3일 안에 «WeChat을 개인 진입 채널로 쓸 가치»를 보려면 일일 Mac이 메인 ID와 개발 트리를 덜 오염시킵니다. 요금 가이드와 SSH/VNC FAQ를 확인하십시오.