2026년 텐센트 WeChat ClawBot 공식 OpenClaw 설치:
버전 요건과 8가지 가드레일

국내 팀이 원하는 것은 「또 하나의 Telegram Bot」이 아니라, 하루에 수십 번 여는 앱 안에서 조사·초안·Skill 트리거·짧은 자동화를 처리하는 것입니다. 비공식 브리지는 다음 세 가지 예측 가능한 실패 패턴을 가집니다.

• 계정 리스크: 시뮬레이션 클라이언트와 프로토콜 해킹은 플랫폼 집행 조치를 유발해 비즈니스 연락처에도 영향을 줄 수 있습니다.
• 운영 SLA 부재: 로그인 흐름, CAPTCHA, 상류 API 변경은 심야 스크립트 작업이 되며 벤더 SLA도 없습니다.
• 제품 불일치: Telegram식 멀티 Bot 패턴은 WeChat 라우팅에 그대로 맞지 않으며, 그룹 기능에서 상태 버그가 증폭됩니다.

ClawBot은 텐센트 플러그인 체계를 사용합니다. 설정 → 플러그인에서 발견하고, Gateway 호스트에서 공개 CLI를 실행하며, 휴대폰 QR 스캔으로 인가합니다. 트래픽은 여전히 텐센트 보안 심사를 거치므로 안정성은 향상되지만, 모더레이션, 1:1 채팅 전용, 일부 전달 제한을 제품 규칙으로 받아들여야 합니다. 이는 설치 결함이 아닙니다.

운영 팀은 본격 가동 전 세 가지 책임 경계를 문서화해야 합니다. 테스트 단말 WeChat 업그레이드 담당, Gateway 모델 API 키 로테이션 담당, 파일 시스템에 접근할 수 있는 Skill 설치 승인 담당입니다. 이 분할이 없으면 첫 본격 장애는 「WeChat이 깨졌다」와 「OpenClaw가 깨졌다」의 책임 전가가 되고, 실제 원인은 감사되지 않은 Skill이 워크스페이스 밖에 쓰는 경우가 많습니다.

ClawBot을 범용 IM SDK가 아닌 공식 채널 플러그인으로 취급하십시오. 설치는 빠르지만, 버전 요건·모더레이션·Gateway 배치가 진짜 인수 테스트입니다.

개인 개발자는 ClawBot을 기본으로 선택하십시오. 조직 전체 배포와 감사가 필요하면 WeCom 플러그인으로 이동합니다. 동일 실험 Gateway 프로필에 둘을 혼합하지 마십시오.

ClawBot은 WeChat 내 범용 클라우드 모델이 아니라 본인의 OpenClaw 인스턴스에 바인딩됩니다. 설치 전 다음을 확인하십시오.

• WeChat 클라이언트: iOS에서는 일반적으로 8.0.70+가 필요합니다. Android 요건은 플러그인 페이지를 따르며, 지역에 따라 그레이 릴리스 중일 수 있습니다.
• 단말: 바인딩은 모바일 WeChat을 사용합니다. 데스크톱 WeChat으로는 인가를 완료할 수 없습니다.
• CLI 호스트: Gateway가 동작하는 Mac 셸에서 install을 실행합니다(로컬 또는 CALMVPS 베어메탈 SSH).
• 네트워크: 휴대폰과 CLI 호스트가 QR 핸드셰이크를 완료할 수 있어야 합니다. 모델 API egress와 WeChat 지연은 별도로 평가하십시오.

토폴로지 A: 노트북 Gateway + 로컬 CLI + 휴대폰 QR. 토폴로지 B: 임대 베어메탈 Mac에서 Gateway 24/7 상시, SSH로 CLI 실행, 동일 휴대폰 QR 스캔. 노트북이 자주 슬립하는 팀에는 B가 적합합니다.

npx -y @tencent-weixin/openclaw-weixin-cli@latest install

본격 운영 전 npm에서 패키지명과 README를 확인하십시오. 텐센트가 플래그를 갱신하면 플러그인 상세 페이지에서 명령을 복사하십시오.

1. WeChat 업그레이드: 설정 → 버전 정보에서 플러그인 요건을 충족하고, 필요하면 스토어에서 갱신합니다.
2. 플러그인 열기: 설정 → 플러그인 → WeChat ClawBot → 설치 명령을 복사합니다.
3. Gateway 상태 확인: 상태 점검을 실행합니다. 원격 노드는 먼저 SSH합니다.
4. CLI 실행: npx -y @tencent-weixin/openclaw-weixin-cli@latest install을 붙여넣고 QR이 나올 때까지 기다립니다.
5. 휴대폰 인가: 모바일 WeChat으로 스캔합니다. 공유 벤더 모델이 아니라 이 Gateway 인스턴스에 바인딩됩니다.
6. 채널 검증: 제어 UI에서 WeChat 채널이 온라인인지 확인합니다. 없으면 원클릭 업데이트와 브라우저 하드 리프레시(Cmd+Shift+R), 필요 시 Gateway 재시작 후 재스캔합니다.

인바운드 메시지는 OpenClaw resolveAgentRoute로 channel, accountId, peer 기준 라우팅됩니다. 대부분 개인 사용자에게는 단일 WeChat 계정 + 내부 위임하는 기본 Agent가 동일 스레드에서 Agent를 바꾸는 것보다 안정적입니다.

플레이북 B로 여러 WeChat 계정을 서로 다른 Agent에 매핑할 수 있습니다(예: 「개인 비서」와 「운영 Bot」의 경계). 각 계정은 고유 peer 컨텍스트를 가지며, 한 채팅 안에서 Telegram식 멀티 Bot 탭은 기대하지 마십시오. 바인딩 후 셸 실행·브라우저 Skill을 켜기 전에 무해한 ping(「너는 누구 / 어떤 모델」)으로 라우팅을 확인하십시오.

Gateway를 CALMVPS 베어메탈에 두면 ai.openclaw.gateway launchd를 소유한 사용자와 동일 세션에서 SSH CLI를 실행하십시오. 노트북을 닫아도 WeChat 도달성은 멈추지 않아야 하며, Gateway 상태만 문제가 되어야 합니다.

• 1:1 채팅만: 그룹 @mention은 기대하지 마십시오. 브로드캐스트는 WeCom 등 다른 채널을 사용합니다.
• 콘텐츠 모더레이션: 텐센트는 DeFi, 지갑, crypto 관련 표현 등 민감 도메인을 필터합니다. 빈 응답은 정책 때문일 수 있습니다.
• 예비 계정: OpenClaw가 넓은 시스템 권한을 가지면 보조 WeChat으로 바인딩하십시오.
• 워크스페이스 경계: 쓰기 가능 경로와 system.run 승인을 강화합니다.
• 유휴 세션: 장시간 무통신 후에는 새 사용자 메시지로 채널을 다시 깨워야 할 수 있습니다.
• Android 그레이 릴리스: 플러그인 항목이 없으면 버전 또는 지역 문제이며 「더 열심히 설치」로 해결되지 않습니다.
• 파일 전달: 처리 결과물은 이메일·드라이브 인계가 필요할 수 있습니다.
• 채널 행 누락: Gateway·CLI 버전을 맞추고 UI 갱신 후 로그를 확인합니다.

「무음 실패」를 디버깅할 때는 Gateway 로그와 사용자 발화 원문을 기록하십시오. 모더레이션은 스택 트레이스 없이 빈 본문을 반환하는 경우가 많으며, 동일 프롬프트를 Telegram·Discord에서 시험하면 모델 경로는 정상이고 WeChat 채널만 필터된 것임을 증명할 수 있습니다.

텐센트 개발자 문서에는 공식 ClawBot 공개 타임라인과 스크린샷이 있습니다. 게시 후 링크를 다시 열어 절차 변경 여부를 확인하십시오.

WeChat 공식 ClawBot: 한 줄 명령으로 OpenClaw 연결

• WeChat 플러그인 요건(iOS): 공개 튜토리얼에서는 8.0.70+가 일반적입니다.
• 공식 CLI 패키지: @tencent-weixin/openclaw-weixin-cli를 npx … install로 호출합니다.
• 기본 Gateway 제어 포트: 18789(원격 이중 머신 문서와 동일).
• 원격 사이징: 멀티 채널 + cron + WeChat 진입점이면 M4 24GB부터. 무거운 로컬 모델·Skill 시험은 M4 Pro. 로그 증가 시 CPU보다 먼저 1TB/2TB를 검토합니다.

슬립하는 노트북 Gateway는 24/7 WeChat 도달성과 Token 위생을 해칩니다. 범용 Linux VPS에는 macOS 툴체인과 TCC 관련 node 워크플로가 없습니다. 타임셰어 가상 Mac 팜은 커스텀 launch agent·디스크 IO를 제한해 데모에는 적합하지만 WeChat이 온콜 페이저가 되면 부담이 큽니다.

참고 워크플로: Gateway와 WeChat 채널을 CALMVPS 싱가포르 월간 M4 24GB 노드에 두고, 로컬 MacBook은 화면 캡처·Xcode 사이드 작업용 Remote node로, 빌드 스파이크는 주간 병렬 워커로 흡수해 Gateway Token에 손대지 않습니다. WeChat 세션은 허브에 두고 빌드 스파이크는 워커가 처리합니다.

안정 Gateway, 공식 WeChat 진입점, 재현 가능한 장애 대응이 필요한 팀에는 CALMVPS 다지역 베어메탈 Mac이 보통 더 적합한 호스트입니다. 전용 Apple Silicon, 약 120초 배포, 일·주 병렬 워커로 허브 승급 없이 빌드 스파이크를 흡수할 수 있습니다. 자세한 내용은 CALMVPS 요금 페이지를 참고하십시오.