위챗 공식 ClawBot OpenClaw 설치 가이드 표지

2026년 위챗 공식 ClawBot과 OpenClaw: 원클릭 설치, 버전 요건 및 운영 회피 의사결정 매트릭스

2026년 Tencent는 OpenClaw용 위챗 공식 플러그인(@tencent-weixin/openclaw-weixin-cli)을 공개하여 ClawBot이 정식 채널로 스마트폰 대화를 처리할 수 있게 되었습니다. Wechaty 같은 비공식 프로토콜 대신 도입하려는 분들을 위해, 플러그인 메뉴가 보이지 않음·QR 실패·게이트웨이는 떠 있으나 무응답 같은 증상을 네 단계로 나누고, 다섯 단계 설치·운영 회피 매트릭스·7×24에 원격 Mac이 맞는 이유를 정리합니다.

1. 먼저 층을 가른다: 네 가지 실패 양상

재설치 전에 아래 중 어디에 해당하는지 확인하세요. 그레이 미개방을 게이트웨이 장애로 오인하지 않는 것이 중요합니다.

  • L0 플러그인 항목 없음: WeChat 8.0.70 미만, 계정 그레이 미포함, OpenClaw 호스트가 플러그인 2.0.x가 요구하는 2026.3.22보다 낮은 경우가 많습니다.
  • L1 QR·페어링 실패: 단말과 게이트웨이의 시간대·프록시 불일치, 콜백 포트 차단 등이 흔합니다.
  • L2 게이트웨이 미기동·updating 반복: CLI 설치 후 openclaw gateway restart 누락, launchd와 수동 프로세스 충돌.
  • L3 연결만 되고 무응답: 모델 자격 증명 비어 있음, channels --probe 비녹색, session.dmScope 오설정으로 세션 엇갈림.

2. 공식 ClawBot과 Wechaty·WeCom Webhook의 경계

공식 경로에서는 메시지가 Tencent를 경유하지만, 실행 가능한 능력은 로컬 OpenClaw 설정(모델·Skills·plugins.fs)에 달려 있습니다. WeCom 자체 앱 Webhook과는 별개이며 PC版 위챗 상시 접속도 전제하지 않습니다. Wechaty 대비 컴플라이언스와 업데이트 경로가 분명한 대신, 그레이 범위·콘텐츠 필터·「스마트폰 상시 온라인」 제약을 받아들여야 합니다.

3. 설치 전 체크리스트

  1. WeChat 클라이언트: iOS·Android ≥ 8.0.70(Android는 8.0.69+에서 빠른 업데이트 권장).
  2. OpenClaw 호스트: v2026.3.22 이상 권장, openclaw doctor로 extensions와 CLI 버전 정렬.
  3. 상시 온라인: 노트북 절전은 운영에 부적합합니다. 로그가 남는 호스트가 필요합니다.
  4. 최소 권한 워크스페이스: shell·fs 플러그인을 열기 전 workspaceAccess를 먼저 조입니다.

4. 다섯 단계: 명령 복사부터 대화 검증까지

  1. 스마트폰 위챗 → 나 → 설정 → 플러그인에서 공식 설치 명령 복사.
  2. 게이트웨이 호스트에서 npx -y @tencent-weixin/openclaw-weixin-cli@latest install 실행.
  3. QR·계정 연동(본운영 전 서브 계정으로 시험 권장).
  4. openclaw gateway restart 후 gateway status가 ready일 때까지 대기.
  5. openclaw channels status --probe 뒤 위챗에서 테스트 전송, agent.jsonl 타임스탬프 대조.
openclaw gateway restart
openclaw channels status --probe
openclaw doctor

5. 운영 회피 의사결정 매트릭스

리스크·현상 권장 비권장
그레이 미개방 공식 개방까지 Telegram·Slack으로 자동화 검증 Wechaty로 돌아가 장기 안정 기대
해외 회선·프록시 게이트웨이와 단말 출구 정책 일치 다단 프록시로 QR 콜백 타임아웃
복수 위챗 계정 session.dmScope: per-account-channel-peer로 라우팅 분리 기본 session 공유로 컨텍스트 뒤섞임
Docker 격리 자격 증명 volume 고정·재시작 정책 설계 컨테이너 재생성마다 pairing 상태 소실

6. 원격 Mac·SFTP 워크스페이스와의 연결

위챗 채널은 게이트웨이 장시간 연결을 전제로 합니다. 한편 Skills·프롬프트는 SFTP·rsync로 동일 Mac에 동기화되는 경우가 많습니다. 원격 Mac에 OpenClaw를 올리면 launchd 상주·통일 로그 경로·CI 산출물 디렉터리 화이트리스트를 한 번에 맞출 수 있습니다. 장애 시 status → gateway status --deep → doctor → logs 공식 사다리를 따르고, 사이트 내 gateway restart·pairing·운영 보안 글과 함께 읽는 것이 효율적입니다.

7. 결론: 정식 채널과 안정 호스트의 두 축

공식 ClawBot이 푸는 문제는 「위챗을 합법적으로 붙일 수 있는가」이지, 모델 비용·디렉터리 권한·24/7 운영 설계를 대신하지 않습니다. npx 한 줄은 절반일 뿐이며, 나머지 절반은 버전 요건·재시작 검증·세션 격리입니다.

위챗 어시스턴트와 Xcode·CI 산출물을 한 노드에서 돌리려면 SFTPMAC 원격 Mac 임대가 현실적인 선택입니다. Apple Silicon 통합 메모리는 멀티 에이전트에 유리하고, macOS 권한 모델은 allowedPaths 축소에 맞으며, 백본망은 채널 콜백 지연을 낮춥니다. ClawBot을 「덮개를 닫으면 끊기는 실험」이 아니라 끊김 없는 개인 비서로 운영할 수 있습니다.