@tencent-weixin/openclaw-weixin)으로 OpenClaw는 규정 준수 공식 경로를 통해 WeChat 1:1 채팅에 연결할 수 있습니다. 버전 호환 행렬, 클라이언트 단계적 배포, Gateway 호스트 선택을 잘못하면 QR 로그인은 성공하지만 Control UI에는 연결됐는데 실제 대화에서 Agent가 답하지 않거나, OpenClaw 마이너 업그레이드 후 플러그인 ABI가 어긋나 패킷이 조용히 유실되는 증상이 나타납니다. 본문은 openclaw-weixin-cli 일괄 설치, 1.0.x/2.0.x와 OpenClaw 2026.3.x 대조 고정, WeChat 8.0.70+ 요구사항, 7×24 Gateway를 클라우드 Mac에 두는 삼분법 분담을 당직이 그대로 복사할 수 있는 형태로 정리합니다.
WeChat ClawBot 연결에서 흔한 다섯 가지 오독 패턴
2026년 WeChat ClawBot 연결면은 macOS Gateway 호스트, OpenClaw 코어 버전, WeChat 클라이언트 단계 배포 세 축이 겹칩니다. 「QR 성공＝프로덕션 가용」으로 보면 1:1 채팅 전용, 파일은 인바운드만, 24시간 무활동 후 능동 메시지가 플랫폼에서 폐기될 수 있음 같은 제품 경계를 놓칩니다. 더 은밀한 것은 플러그인 버전 표류입니다. 1.0.x는 >=2026.3.0 이면서 <2026.3.22, 2.0.x는 >=2026.3.22용입니다. 경계를 넘고 gateway restart를 하지 않으면 doctor가 녹색으로 남을 수 있습니다. 변경 티켓에서는 먼저 아래 서명 번호를 붙이고, 플러그인 롤백, 보조 계정 교체, Gateway 클라우드 Mac 이전 중 무엇을 택할지 결정하세요.
비공식 iPad 프로토콜 브리지를 공식 ClawBot과 동등하게 봄: 비공식 브리지는 정지·프로토콜 변경 위험이 크고, 공식 플러그인은 API 경로로 능력 경계(1:1, 파일 방향, 민감어)가 다릅니다. 기존 Runbook을 그대로 쓸 수 없습니다.
WeChat 클라이언트 버전 확인 없이 QR 스캔:iOS는 8.0.70 이상이 전제이고, Android 8.0.69+는 단계 배포 중입니다. 낮은 버전은 로그인 이상이나 메시지 비동기 원인이 됩니다.
OpenClaw 업데이트 후 openclaw-weixin 메이저 버전 미동기화:2026.3.22가 경계입니다. 1.0.x에 머물면 channels가 가짜 연결로 보일 수 있으니 openclaw --version으로 2.0.x에 맞추세요.
단체 채팅이나 기업 시나리오에서 ClawBot 응답 기대:현재는 1:1 채팅만 지원합니다. 그룹 @ 무응답은 제품 제한이며 Gateway 장애가 아닙니다.
프로덕션 Agent를 주 계정에 올리고 키 조각 전송:데이터는 국내 서버를 거치며 민감어가 필터됩니다. 컴플라이언스상 보조 계정을 쓰고 WeChat에서 API Key, 내부망, 고객 정보를 보내지 마세요.
서명을 붙인 뒤 모델 라우팅과 채널 정책을 건드리세요. Gateway를 클라우드에서 한 번도 검수하지 않았다면 OpenClaw 클라우드 Mac 설치와 Lobster 워크플로로 install.sh와 상주를 먼저 확립합니다. 연결됐는데 무응답일 때는 채널 연결됨·무응답으로 프로세스층과 정책층을 나누고, WeChat 쪽 재 QR만으로 Gateway 포트나 pairing 문제를 가리지 마세요.
서드파티 브리지, 공식 ClawBot, 「클라우드 Mac Gateway」삼분법 행렬
2026년 커뮤니티에는 여러 WeChat 연결안이 남아 있지만, 프로덕션 선정에서는 컴플라이언스, 능력 경계, 7×24 도달성을 같은 표에서 비교해야 합니다. 공식 ClawBot은 텐센트 보증과 1:1·내용 심사를 받아들이는 팀에 맞습니다. 서드파티 브리지는 그룹·파일 외송 여지가 있으나 프로토콜·계정 리스크를 동반합니다. 어느 메시지 경로든 Gateway 제어면은 절전하지 않는 클라우드 Mac에 두고 노트북은 QR과 Control UI만 담당하는 것이 2026년 실무 합의입니다.
| 관점 | 서드파티 프로토콜 브리지 | 공식 openclaw-weixin | 클라우드 Mac Gateway + 공식 |
|---|---|---|---|
| 컴플라이언스 | 고위험, 정지 쉬움 | 공식 플러그인, 보조 계정 필수 | 공식과 동일, 호스트 안정 |
| 대화 형태 | 구현마다 다름, 그룹 포함 흔함 | 1:1 채팅만 | 1:1, 7×24 상주 |
| 파일 | 양방향 구현 흔함 | 인바운드만, 외송 불가 | 공식 제한과 동일 |
| 설치 입구 | 프로젝트마다 이질적 | npx @tencent-weixin/openclaw-weixin-cli | 클라우드 Mac에서 CLI + LaunchAgent |
| 버전 결합 | OpenClaw와 약결합 | 1.0.x / 2.0.x 행렬 | Master와 동기 고정 필요 |
| 2026 권장 | 프로덕션 비권장 | 컴플라이언스 1:1 어시스턴트 | 크로스 리전 소규모 팀 |
메시지는 공식 ClawBot, 제어면은 클라우드 Mac loopback. 노트북 절전에 WeChat 7×24를 걸지 마세요.
공식 플러그인을 고르면 어느 클라우드 Mac이 Gateway를 맡는지, 보조 계정 보관 책임, OpenClaw와 openclaw-weixin 고정 버전을 문서화합니다. 실험 기간 로컬 Mac에 임시 Gateway를 띄우는 것은 괜찮지만 클라우드 Mac Master와 같은 채널 자격을 동시에 꽂지 마세요. 이중 소비와 조용한 유실이 발생합니다. Windows 개발기가 Node만 쓴다면 Windows/WSL2와 클라우드 Mac Gateway 분담을 참고하세요.
openclaw-weixin-cli 일괄 설치, 수동 체인, 버전 호환 행렬
권장 입구는 텐센트 CLI 래퍼입니다. OpenClaw가 설치된 호스트에서 호환 버전 @tencent-weixin/openclaw-weixin을 가져와 config를 씁니다. CI나 변경 창에서는 install → enable → channels login → gateway restart 수동 체인도 씁니다. 사전에 OpenClaw >=2026.3.0을 확인하고 1.0.x는 >=2026.3.0 이면서 <2026.3.22, 2.0.x는 >=2026.3.22를 고릅니다. WeChat은 iOS 8.0.70+ 또는 Android 8.0.69+(단계 배포)를 준비하고 보조 계정으로 QR하세요.
npx -y @tencent-weixin/openclaw-weixin-cli@latest install openclaw plugins install "@tencent-weixin/openclaw-weixin" openclaw config enable channels.openclaw-weixin openclaw channels login --channel openclaw-weixin openclaw gateway restart openclaw channels probe --channel openclaw-weixin openclaw doctor
CLI @latest는 현재 OpenClaw 버전에서 호환 플러그인을 해석합니다. 변경 티켓에서 OpenClaw를 특정 2026.3.x에 고정했다면 설치 후 openclaw plugins list 출력을 wiki에 남기세요. QR은 Gateway와 동일 머신이거나 안전한 터널로 Control UI에 닿는 환경에서 합니다. 로그인 후 보조 계정이 Bot에 텍스트를 보내 inbound가 Agent에 들어가고 outbound가 1:1에서 보이는지 확인합니다. probe 실패 시 openclaw gateway status와 openclaw logs 다음 플러그인 메이저 경계 넘김을 의심하세요.
참고:제품 제한——1:1 채팅만; 파일은 수신만 가능하고 외송 불가; 24시간 무활동 후 능동 메시지가 안 올 수 있습니다. 데이터는 국내 서버 경유로 민감어 필터됩니다. 키나 고객 정보를 보내지 마세요.
여섯 단계 Runbook: 버전 고정부터 WeChat 1:1 스모크까지
버전 3종 고정:OpenClaw 버전, openclaw-weixin 1.0.x 또는 2.0.x, WeChat 클라이언트 버전(iOS 8.0.70+ / Android 8.0.69+ 단계 배포)과 보조 계정 소유자를 기록합니다.
클라우드 Mac에 Gateway Master:Lobster 설치 글대로 install.sh, onboard, LaunchAgent. loopback 18789와 gateway status를 확인합니다.
공식 플러그인 설치:우선 npx -y @tencent-weixin/openclaw-weixin-cli@latest install. 변경 창은 수동 plugins install 체인과 출력 아카이브.
channels login QR:Gateway 호스트 또는 안전한 Control UI 도달 하에서 openclaw channels login --channel openclaw-weixin, 보조 계정으로 인가합니다.
restart와 probe:openclaw gateway restart 후 channels probe와 doctor. Windows Node가 있으면 remote가 Master를 가리키고 로컬 Gateway와 경합하지 않는지 확인합니다.
1:1 스모크:보조 계정에서 텍스트와 인바운드 파일(수신만 검증)을 보내 Agent 응답에 외송 파일이 없는지 확인합니다. 노트북을 한 번 절전시켜 채널이 클라우드 Mac만에 의존하는지 검증합니다.
여섯 단계 완료 후 「1:1만」「파일 outbound 불가」「24h 무활동 후 능동 메시지 폐기」를 당직 매뉴얼에 적어 그룹 무응답이나 파일 외송 실패를 Gateway 다운으로 오인하지 않게 합니다. Telegram, Discord 등은 OpenClaw 네이티브 채널 그대로 두고 WeChat ClawBot과 병행할 때 token과 config 절을 분리해 merge 시 키 충돌을 막으세요.
세 가지 당직 임계값과 여섯 리전 클라우드 Mac Gateway 선정
버전 정렬 적색선:OpenClaw가 2026.3.22를 넘은 뒤 24시간 안에 openclaw-weixin이 1.0.x인 채 probe가 간헐 실패하면 ABI 불일치로 보고 2.0.x로 올린 뒤 restart하고 모델 변경으로 넘어갑니다.
클라이언트 단계 배포 하한:iOS 8.0.70 미만, Android가 8.0.69+ 단계 배포에 들어가지 않으면 보조 계정을 프로덕션에 연결하지 않습니다. 티켓에 WeChat 정보 스크린샷과 QR 시각을 첨부합니다.
Gateway 분리 검수:Master 복구 후 10분 안에 channels probe 3회 이상. 호스트 재부팅 후 60초 안에 WeChat 1:1에서 Agent 응답이 오고 개발 노트북 상시 온라인에 의존하지 않음.
주의:임계값은 당직 소통용 기준이며 텐센트나 OpenClaw SLA가 아닙니다. 민감어와 24시간 세션 정책은 WeChat 당기 규칙을 따릅니다.
WeChat ClawBot Gateway를 개인 Mac이나 Windows 노트북에 묶으면 절전, OS 업데이트 재부팅, 네트워크 로밍으로 webhook이 다시 끊깁니다. 저가 Linux VPS만으로는 macOS 툴체인과 일부 채널 플러그인 근접성이 부족합니다. 베어메탈 클라우드 Mac을 Master로 openclaw-weixin과 7×24 상주를 올리고 로컬은 QR·Control UI만 쓰면 컴플라이언스 1:1, loopback 규율, 예측 가능한 교체 창 균형을 맞출 수 있습니다. 안정적인 WeChat Agent를 소비자 하드웨어 상시 온라인에 걸고 싶지 않은 팀에는 MESHLAUNCH Mac Mini 클라우드 대여가 현실적입니다. 목표 리전에서 일 단위 대여로 여섯 단계와 호스트 재부팅을 한 번 통과한 뒤 상태가 굳어지면 월 단위로 잠그는 순서를 권합니다. 용량과 신청은 대여 가격과 고객 센터를 참고하세요.
OpenClaw >=2026.3.0 이면서 <2026.3.22는 1.0.x, >=2026.3.22는 2.0.x입니다. 업데이트 후 gateway restart와 channels probe를 실행하세요. 클라우드 Mac 초설치는 Lobster 설치 가이드, 신청은 가격 페이지입니다.
권장하지 않습니다. 프로덕션 webhook은 클라우드 Mac Master에 두고 Windows는 Node 또는 콘솔만 씁니다. 분리 토폴로지는 Windows/WSL2 분담 Runbook을 참고하세요.
현재 1:1 채팅만, 파일은 인바운드만, 데이터는 국내 서버 경유로 민감어 필터됩니다. 보조 계정을 쓰고 키를 보내지 마세요. 7×24 Gateway 클라우드 Mac 대여는 대여 가격을 참고하세요.