2026 텐센트 위챗 ClawBot 설치와 주의사항: 공식 CLI 바인딩, 플러그인 활성화, OpenClaw 백엔드 배포 선택

ClawBot은 Tencent WeChat 팀이 OpenClaw용으로 제공하는 공식 플러그인 채널입니다. OpenClaw Gateway가 돌아가는 호스트에서 @tencent-weixin/openclaw-weixin-cli를 실행하면 터미널 QR이 생성되고, 모바일 WeChat 스캔 후 연락처에서 AI 어시스턴트와 1:1 대화합니다. 예전 「웹 프로토콜 / 비공식 봇」 대비 공식 경로의 핵심 가치는 계정 정지 리스크 완화, 역공학 유지보수 비용 절감입니다.

리뷰·개인 시험에서 과소평가되기 쉬운 pain point 다섯 가지입니다.

• 백엔드 오프라인: ClawBot은 「WeChat ↔ Gateway」 구간만 해결합니다. OpenClaw가 가정용 Mac에 있고 야간 절전하면 QR 성공 후에도 「메시지 무응답」으로 보입니다.
• 버전 문턱: iOS 8.0.70+, Android 8.0.69+ 필요. 「설정 → 기능 → 플러그인」에서 ClawBot 수동 활성화. 구버전에는 메뉴 자체가 없습니다.
• 권한·데이터 경로: 대화는 WeChat 국내 인프라를 거칩니다. OpenClaw는 파일시스템·자동화 권한을 가질 수 있어 메인 계정 바인딩 시 규정·프라이버시 리스크가 서브 계정 시험보다 큽니다.
• 기능 경계 오판: 2026 Q2 공개 자료 기준 그룹 채팅 미지원, 파일은 대체로 「들어오기만」, 장시간 미상호 시 AI 능동 푸시 제한. 데모 전 기대치 정렬이 필요합니다.
• 일반 설치 문서와 혼동: ClawBot 바인딩은 Gateway가 healthy한 뒤입니다. Node 22 + onboard를 건너뛰면 바인딩 단계에서 장애 시간이 길어집니다.

기억 구문: 「OpenClaw 7×24 온라인 → WeChat 플러그인 ON → Gateway 호스트에서 weixin-cli」. 순서가 뒤바뀌면 QR·로그가 잘못된 방향을 가리킵니다.

ClawBot은 OpenClaw 배포를 대체하지 않습니다. IM 채널만 추가합니다. 먼저 상시 연결·CLI 실행 가능한 런타임면이 필요합니다.

JEXCLOUD Mac에서 OpenClaw를 돌리는 팀은 weixin-cli를 Gateway 도달 가능한 동일 호스트에서 실행해야 합니다. SSH 점프 전용 로컬에서 QR을 만들면 스캔은 성공해도 메시지가 인스턴스로 라우팅되지 않습니다.

모바일·서버 조건을 동시에 충족한 뒤 바인딩 명령을 실행합니다.

모바일(WeChat ClawBot 플러그인):

1. WeChat을 iOS 8.0.70+ 또는 Android 8.0.69+로 업데이트(앱 내 정보 페이지 기준).
2. 「나」→「설정」→「기능」→「플러그인」에서 ClawBot 활성화.
3. 첫 바인딩은 서브 계정 권장, 업무 메인 계정의 자동화 실험 리스크 회피.

서버(OpenClaw Gateway):

• openclaw doctor 또는 헬스체크로 Gateway가 127.0.0.1:18789(또는 설정 포트) listen 확인.
• Node 런타임이 OpenClaw 요건 충족(Node 22 설치 글 참고).
• npm registry 접근 가능, Tencent 공식 패키지 pull.

OpenClaw Gateway 호스트에서 실행
npx -y @tencent-weixin/openclaw-weixin-cli@latest install
터미널 QR → WeChat 스캔 → 바인딩 확인
QR 만료 시 위 명령 재실행

CLI는 npm @tencent-weixin 스코프에 게시됩니다. Tencent Cloud 개발자 커뮤니티 ClawBot 튜토리얼과 일치합니다. 바인딩 성공 시 WeChat 연락처에 OpenClaw 어시스턴트 세션이 추가됩니다.

1. 백엔드 선택: §2 매트릭스에서 Lighthouse·JEXCLOUD 클라우드 Mac·로컬 Mac 중 택일, OpenClaw 기본 설치·Gateway 상주 완료.
2. 헬스체크: openclaw doctor로 token 누락·포트 점유·launchd 미로드 없음 확인.
3. WeChat 업그레이드·플러그인 ON: 버전 문턱 충족, 플러그인 페이지에서 ClawBot 활성화.
4. 백엔드 SSH: 클라우드 Mac은 콘솔 SSH, 점프 호스트에서 바인딩 CLI 실행 금지.
5. weixin-cli 실행: npx -y @tencent-weixin/openclaw-weixin-cli@latest install, 60초 내 모바일 QR 스캔·확인.
6. 첫 대화 검수: 어시스턴트에 텍스트 「ping」 전송, 수 초 내 모델 응답. 실패 시 Gateway 로그·인스턴스 가동, QR 만료 재바인딩 순 점검.

바인딩 후 WeChat에서 OpenClaw 다중 턴 컨텍스트, ClawHub Skills, 일부 배포의 /model 전환을 사용할 수 있습니다. 구체는 인스턴스 설정에 따릅니다.

• WeChat 클라이언트 버전: iOS ≥ 8.0.70, Android ≥ 8.0.69(2026년 3월 전후 공개 요건, 업그레이드 후 WeChat 재시작).
• 공식 바인딩 명령: npx -y @tencent-weixin/openclaw-weixin-cli@latest install, 스코프 @tencent-weixin, Gateway 동일 호스트 필수.
• 상호작용 시효: 커뮤니티 문서 기준 사용자·어시스턴트 약 24시간 무상호 시 AI 능동 푸시가 WeChat 측에서 폐기될 수 있음. 운영 알림은 「사용자 선발화」 또는 유실 수용 설계.
• 세션 형태: 공개 자료는 1:1만, 그룹 미지원. 기업 다자 협업은 WeCom 등 다른 IM.
• 파일·미디어: 이미지/파일/음성 수신 가능하나 결과 파일 WeChat 회송 불가(「들어오기만」). 산출물은 메일·클라우드·내부 시스템.
• 계정 관계: 「WeChat 1개 ↔ OpenClaw 1」 설명 다수. 단일 인스턴스가 여러 WeChat 바인딩 가능, 확장 시 세션 격리를 설정층에서 구분.

보안 주의(팀 규정 필수): 메인 계정에서 미감사 Skill 시험 금지. OpenClaw 워크스페이스 최소 권한. 국내 전송은 사내 규정 평가. Docker 격리 시에도 Gateway·weixin-cli 네트워크 도달 유지.

ClawBot을 절전하는 가정용 Mac에 두면 WeChat에는 「어시스턴트 추가됨」으로 보이나 야간 메시지는 조용히 실패합니다. 오버셀·SLA 없는 VPS는 macOS 채널·Apple 자동화 경로가 없습니다. 7×24 Gateway, QR 후 장기 안정 응답, Xcode·로컬 스크립트 연동이 필요한 팀은 JEXCLOUD 다중 리전 베어메탈 클라우드 Mac에서 OpenClaw 설치 후 weixin-cli를 실행하는 편이 「로컬 노트북 + 임시 터널」보다 수고가 적은 경우가 많습니다. 전용 Apple Silicon, 프로젝트별 M4 Pro·스토리지 업그레이드. 플랜은 JEXCLOUD 요금 페이지.