Mac에서 OpenClaw는 이미 동작하는데 Telegram이나 브라우저에서만 대화한다면, 빠진 것은 WeChat이라는 일상 진입점입니다. 2026년 3월부터 Tencent WeChat 팀은 공식 WeChat ClawBot 플러그인을 공개했습니다. 「설정 → 플러그인」에서 켠 뒤 Gateway가 돌아가는 머신에서 npx 한 줄을 실행하고 QR을 스캔하면 본인의 OpenClaw(페르소나, 메모리, Skills, Agent 라우팅)를 WeChat 1:1 채팅에 연결할 수 있습니다. 본문은 기본 설치를 마치고 프로덕션 투입을 검토하는 독자를 대상으로 합니다. 공식 플러그인과 Wechaty 등 비공식 경로의 위험을 대조하고, 의사결정 매트릭스, 8단계 실습 절차, 기능 경계와 컴플라이언스 주의, 변경 리뷰에 넣을 하드 파라미터 3개 이상을 정리합니다. 명령과 버전 요건은 Tencent 개발자 커뮤니티와 npm 패키지 설명을 따르며, 릴리스 후 링크를 다시 열어 확인하십시오. 가격은 요금 페이지, 주문은 주문 페이지, 원격 접속은 고객 센터를 참고하십시오.
[ SECTION_01 ] // PAIN_MAP WeChat 연결에서 가장 흔한 실패 패턴
- 그레이 프로토콜 고집: Wechaty, iPad 프로토콜 등 비공식 방안은 프로토콜 변경이나 리스크 관리 강화 시 전체 링크가 한 번에 끊길 수 있으며, 계정 정지 불확실성도 남습니다. 공식 플러그인 체계와는 위험 수준이 다릅니다.
- WeChat 클라이언트 버전 미달: 플러그인 진입점은 비교적 새 클라이언트에 의존합니다. iOS 8.0.70, Android 8.0.69 이상이 기준이며, 구버전에서는 「플러그인」 목록에 ClawBot이 보이지 않습니다.
- Gateway 미준비 상태에서 QR 스캔: 터미널에서
npx는 성공했는데 OpenClaw Gateway가 LISTEN하지 않거나 데몬이 기동하지 않으면, QR 만료 후 「붙었다가 바로 끊김」처럼 보입니다. - 메인 계정을 실험대로 사용: 메시지는 국내 인프라를 거치며 콘텐츠 심사 대상이 될 수 있습니다. 일상 주 WeChat 계정에 ClawBot을 바인딩하면 개인 소셜과 자동화 실험이 같은 ID에 묶입니다.
- 그룹 채팅과 양방향 파일을 과대 기대: 현재 제품 형태는 1:1 어시스턴트에 가깝습니다. 파일 기능과 약 24시간 무대화 시 끊김 규칙을 읽지 않고 배포하면 첫 주에 걸립니다.
- 노트북 절전으로 「WeChat AI 무응답」: Gateway가 덮개를 닫는 Mac 위에 있으면 사용자는 ClawBot 장애로 오인하지만, 실제로는 호스트 오프라인이며 플러그인 자체 결함이 아닙니다.
[ SECTION_02 ] // ROUTE_MATRIX 개인 WeChat ClawBot, WeCom, 해외 채널 선택
아래 매트릭스는 기획 단계에서 경로를 고르고 「설치 후 그룹 미지원」 같은 재작업을 피하기 위한 것입니다.
| 경로 | 공식성 | 전형적 용도 | 주요 제한 |
|---|---|---|---|
| WeChat ClawBot 플러그인 | Tencent WeChat 공식 | 개인 계정, 일상 1:1 | 1:1 중심. 파일은 수신 위주. 장기 무대화 시 재바인딩 필요할 수 있음 |
| WeCom OpenClaw 플러그인 | Tencent WeCom 공식 | 팀 봇, 문서 연동 | 관리 콘솔 설정 필요. 개인 WeChat과 제품 형태가 다름 |
| 커뮤니티 Wechaty 등 | 비공식 프로토콜 | 과거 실험, 특수 통합 | 프로토콜과 계정 위험 통제 불가. 프로덕션 기본값 비권장 |
| Telegram / Discord | 각 플랫폼 공식 Bot API | 해외 협업, 다중 Bot 병행 | 중국 본토 일상 IM 커버는 WeChat에 미치지 못함 |
WeChat 진입점이 필요한 팀에게 ClawBot의 의미는 「채팅 창 하나 더」가 아니라, 설정된 OpenClaw 실행면을 가장 자주 쓰는 IM에 올리는 것입니다. 전제는 Gateway 측이 안정적이고 감사 가능해야 하며, 개인 노트북 절전 전략에 맡기면 안 됩니다.
[ SECTION_03 ] // INSTALL_RUNBOOK OpenClaw에서 WeChat 대화 창까지: 권장 8단계
다음은 Tencent 개발자 커뮤니티 공개 튜토리얼과 npm 설치 절차를 통합한 것입니다. 업스트림에서 패키지명이나 흐름이 바뀌면 공식 문서를 따르십시오.
https://developer.cloud.tencent.com/article/2648517
https://openclawlaunch.com/zh/wechat-clawbot
- OpenClaw 상시 기동 확인: 대상 Mac에서
openclaw onboard --install-daemon또는 동등한 데몬 설치를 완료하고openclaw doctor로 Gateway 포트와 PATH를 정리합니다. 사이트 내 첫 실행과 Gateway 체크리스트를 참고하십시오. - WeChat 클라이언트 업데이트: 「나 → 설정 → WeChat 정보」에서 버전을 확인합니다. iOS 8.0.70 이상, Android 8.0.69 이상을 기준으로 합니다.
- 플러그인 진입점 활성화: 「설정 → 플러그인」에서 「WeChat ClawBot」을 켭니다. 진입점이 없으면 버전과 지역 그레이 배포를 의심합니다.
- Gateway 호스트에서 설치 명령 실행: OpenClaw와 동일한 사용자 환경에서 아래 명령을 실행합니다(Node와 npm 접근 필요).
- 터미널 QR 바인딩: 명령 출력 QR을 플러그인이 켜진 WeChat으로 스캔하고 단말에서 승인합니다.
- WeChat 측 세션 검증: WeChat에서 「WeChat ClawBot」 대화를 열고 생존 확인 메시지를 보내, 응답이 설정 모델과 페르소나에서 왔는지 확인합니다(WeChat 내장 AI가 아님).
- Gateway 재시작 및 라우팅 재확인: 바인딩 후 Gateway 재시작 또는
openclaw gateway restart에 해당하는 작업을 수행하고, 플러그인 프로세스와 OpenClaw 라우팅층resolveAgentRoute가 기대대로인지 확인합니다(단일 WeChat ID 다중 컨텍스트, 다중 ID 다중 Agent 등). - 운영 대장 기록: 바인딩 WeChat ID(서브 계정 권장), 시각, npm 버전, 로그 디렉터리 디스크 기준선을 남겨 24시간 끊김이나 심사 알림 시 빠르게 원인을 좁힙니다.
$ npx -y @tencent-weixin/openclaw-weixin-cli@latest install[ SECTION_04 ] // LIMITS_AND_OPS 기능 경계, 멀티 Agent, 프로덕션 운영 주의
기능 경계(최신 공식 설명을 따름): 개인 WeChat ClawBot은 1:1이 중심이며 텍스트, 이미지, 음성, 파일의 사용 가능한 부분집합을 지원하지만, 그룹 채팅은 기본 제품 능력으로 가정되지 않습니다. 일부 문서는 파일은 수신만이라고 합니다. 약 24시간 대화가 없으면 연결이 끊겨 재 QR이 필요할 수 있습니다. Telegram 다중 Bot 병행 감각을 그대로 WeChat에 적용하지 마십시오.
멀티 Agent 권장 두 패턴: 패턴 A — 단일 WeChat ID, 주 Agent가 내부에서 하위 Agent를 분배(사용자에게는 하나의 대화 창, WeChat 습관에 가장 가까움). 패턴 B — 여러 WeChat ID를 서로 다른 Agent에 할당(경계가 분명해 콘텐츠와 운영 역할 분리에 유리). 같은 대화에서 Agent 식별자를 자주 수동 전환하면 세션 상태가 어지러워 비권장입니다.
- 서브 계정 바인딩: 예비 WeChat ID로 자동화 실험을 받아 메인 계정의 소셜과 심사 위험을 낮춥니다.
- 키와 자격 증명: 모델 API Key와 워크스페이스 경로는 Gateway 호스트에 둡니다. 채팅에 프로덕션 키를 붙이지 마십시오.
- 콘텐츠 심사: 트래픽은 Tencent 국내 인프라를 통하므로 팀 컴플라이언스에 맞게 민감 명령과 외부 전송 데이터를 제한합니다.
- 디스크와 로그: 채널 플러그인과 Gateway 로그는 빠르게 커집니다. 원격 Mac에서는 로테이션 정책을 미리 정합니다. 디스크와 데몬 계획을 참고하십시오.
- WeCom: 팀 용도는 WeCom 공식 OpenClaw 플러그인을 별도 프로젝트로 병행 평가하고 개인 ClawBot과 섞지 마십시오.
[ SECTION_05 ] // HARD_FACTS 인용 가능 수치와 전형 오류 대조
- WeChat 버전 요건: 공개 튜토리얼은 iOS 8.0.70+, Android 8.0.69+에서 플러그인 목록에 ClawBot이 나타난다고 합니다.(출처: Tencent Cloud 개발자 커뮤니티 글 2648517. 릴리스 후 재확인)
- 공식 설치 명령:
npx -y @tencent-weixin/openclaw-weixin-cli@latest install. WeChat 팀이 유지하는 CLI 패키지입니다.(출처: 위와 OpenClaw Launch WeChat 연결 페이지) - 공개 타임라인: WeChat ClawBot 공식 플러그인은 2026년 3월 전후 공개되었으며 정규 플러그인 체계이지 제3자 Hook이 아닙니다.(출처: 커뮤니티 공개 보도. Tencent 공지를 따름)
- Gateway 포트 관례: OpenClaw 디버그와 상시 운영은 18789 루프백 포트 주변을 씁니다. ClawBot 플러그인은 가동 중 Gateway 위의 채널 진입점으로 마운트됩니다.(출처: openclaw/openclaw README)
| 표면 증상 | 우선 의심 | 최소 검증 |
|---|---|---|
| 플러그인 목록에 ClawBot 없음 | WeChat 버전 낮음, 그레이 미배포 | 클라이언트 업데이트. iOS/Android 버전 확인 |
| QR 후 응답 없음 | Gateway 미기동, npm 실패 | 로컬 lsof -nP -iTCP:18789 -sTCP:LISTEN. Gateway 로그 확인 |
| 다음 날 갑자기 무응답 | 24h 무통신 정책, 호스트 절전 | 재 QR. Gateway를 7×24 원격 Mac으로 이전 |
| 그룹 멘션 무반응 | 제품이 그룹 진입점 미지원 | 1:1로 전환 또는 WeCom 플러그인 경로 검토 |
[ SECTION_06 ] // PLATFORM_CLOSE ClawBot을 7×24 원격 Mac에서 돌리는 이유
ClawBot이 푸는 것은 진입점이며, 안정성은 Gateway 호스트에 달려 있습니다. 개인 Mac은 덮개를 닫으면 끊기고, 가정용 회선 NAT와 절전 설정 때문에 WeChat 쪽에서는 「AI가 사라짐」처럼 보입니다. 가상 VPS는 상시 온라인이어도 macOS 네이티브 툴체인, 디스크 IO, OpenClaw Node 능력과의 맞춤은 베어메탈 Mac mini에 뒤처지는 경우가 많습니다. Gateway와 openclaw-weixin-cli를 전용 Apple Silicon에 두고 로그 로테이션과 서브 계정 바인딩을 함께 쓰면, 공식 플러그인 위험을 「제품 규칙」 수준에 가두고 「노트북 정전」 수준 사고는 피할 수 있습니다.
6개 리전에서 지연과 임대 기간을 고르거나 M4에서 M4 Pro로 올려 멀티 Agent와 무거운 Skills를 실을 때는 NOVAKVM 요금 페이지에서 구간을 비교하고 주문 페이지에서 시험 머신을 두 스프린트 분 확보하는 것이 현실적입니다. WeChat 진입점과 iOS CI, OpenClaw 자동화를 같은 운영 경계에 두는 스튜디오에게 NOVAKVM Mac Mini 클라우드 베어메탈 임대는 가정 PC 타협이나 불안정 프로토콜보다 프로덕션형 ClawBot을 맡기기 쉬운 선택입니다. 원격 연결 세부는 고객 센터, 채널과 리버스 프록시 심화는 OpenClaw 채널과 Gateway 트러블슈팅을 참고하십시오.