개인 WeChat에서 직접 키운 OpenClaw를 지휘하려는데 WeChat ClawBot 플러그인과 Gateway 중 무엇을 먼저 설치할지 헷갈리시나요? 2026년 OpenClaw를 이미 돌리거나 곧 올릴 개발자를 위해 Tencent 공식 openclaw-weixin 채널의설치 전 점검, npx @tencent-weixin/openclaw-weixin-cli install과 수동 4단계 대조, 2.0.x / legacy 버전 매트릭스, 다계정 dmScope, WeChat 1:1·파일·키프얼라이브 등프로덕션 주의사항을 압축합니다. 사이트의 Telegram 트러블슈팅, channels probe, 반설치 복구 글과 역할을 나눠 잘못된 단계에서 설정을 바꾸지 않게 합니다.
Tencent WeChat ClawBot(설정 → 플러그인)은 2026년공식 채널 진입점입니다. 스킬 실행·LLM 호출은 PC/서버의 OpenClaw Gateway가 담당합니다. Gateway가 살아 있어도 회선이 끊기면 WeChat 메시지는 안 옵니다.
WeChat 플러그인만, OpenClaw 없음: QR은 성공해도 inbound Agent가 없습니다.
OpenClaw 구버전: 플러그인 2.0.x는 호스트 >=2026.3.22 필요. requires OpenClaw >=2026.3.22로 거부됩니다.
Gateway 비상주: 노트북 슬립, Docker restart 미설정, Linux VPS systemd 미설치 — 「어제 됐는데 오늘 무음」.
ClawBot을 Tencent 자체 봇으로 오해: ClawBot은내 OpenClaw·모델 설정에 연결. 자유도↑ 운영 책임도 본인.
다중 WeChat이 한 세션 통: session.dmScope 없으면 A 답이 B로 갑니다.
WeChat 제품 한도 무시: 공식 채널은1:1만·그룹 불가, 파일은 「들어오기만」 경계(4절).
| 축 | 공식 ClawBot 플러그인 | 기업 WeChat 자체 앱 | Telegram Bot(OpenClaw 내장) |
|---|---|---|---|
| 적합 | 개인 체험, 1:1 자동화 | 팀, 그룹/컴플라이언스 | 해외·개발자 커뮤니티, 그룹 게이팅 성숙 |
| 설치 난이도 | 낮음: openclaw-weixin-cli + QR | 높음: 공인 IP, 콜백 URL, 신뢰 IP | 중간: Bot Token + pairing |
| WeChat 버전 | 권장 8.0.70+ | 플러그인 QR로 기업号 | 해당 없음 |
| 그룹 | 미지원 | 확장 가능 | 지원(mention 정책) |
| 트러블슈팅 글 | 본문 | 기업 WeChat 문서 | 배포 후 삼중 증후군 |
「WeChat에서 보낼 수 있다」≠「채널이 닫혔다」. 플러그인 enabled, Gateway restart, probe 통과 — 셋이 맞아야 프로덕션입니다.
권장 순서: OpenClaw·Node 베이스라인(Node 24 프로덕션 배포) 확인 후 WeChat 플러그인. Gateway 없으면 반설치 복구 선독.
호스트 버전: openclaw --version. <2026.3.22이면 openclaw update 또는 legacy(다음 절).
원클릭(권장): npx -y @tencent-weixin/openclaw-weixin-cli install — 버전 감지, plugins install, QR, Gateway 재시작.
수동(동등 4단계): openclaw plugins install "@tencent-weixin/openclaw-weixin" → enabled true → channels login --channel openclaw-weixin → gateway restart.
WeChat 확인: 8.0.70+, 「나 → 설정 → 플러그인」에 ClawBot. Android 미그레이션 시 CLI QR로 플러그인 갱신(재스캔 필요할 수 있음).
다계정·관측(선택): channels login 재실행으로 계정 추가. 다계정 시 session.dmScope per-account-channel-peer. botAgent는 로그 귀속용.
검수 프로브: channels status --probe + doctor --deep. WeChat 테스트와 logs --follow. 페어링/침묵 겹치면 channels probe 전용 글.
# 2026 Tencent WeChat — 원클릭 + 검수 npx -y @tencent-weixin/openclaw-weixin-cli install openclaw --version openclaw channels status --probe openclaw doctor --deep openclaw logs --follow # 호스트 구버전: legacy 라인 openclaw plugins install @tencent-weixin/openclaw-weixin@legacy
팁: npm이 느리면 registry 미러 후 npx. 플러그인 실패 시 QR 반복 대신 openclaw plugins list에 항목 확인.
주의: Tencent 공식 경로는콘텐츠 심사를 거칩니다. 프로덕션은 서브 계정 바인딩·메인은 관측용 권장.
| 플러그인 라인 | OpenClaw 호스트 | npm dist-tag | 전형 오류 |
|---|---|---|---|
| 2.0.x | >= 2026.3.22 | latest | 호스트 구버전 → OpenClaw 업그레이드 |
| 1.0.x | >= 2026.1.0 < 2026.3.22 | legacy | @legacy 설치, 호스트 억지 업글 금지 |
슬립하는 노트북 Gateway는 뚜껑 닫히면 WeChat 채널이 동시에 끊깁니다. 전용·상시 온라인 macOS 노드가 7×24 WeChat 자동화에 맞습니다. VPS 대여 감각으로 SSH 유지보수·6단계 Runbook을 표준 이미지에 넣을 Mac이 필요하면 NodeMini Mac Mini 클라우드 대여가 실무상 유리합니다. 원격 Mac launchd 상주·iOS CI와 같은 운영 멘탈로 「집 Gateway는 자고, 회사 WeChat은 대기」를 줄입니다.
WeChat ClawBot은채널 플러그인, OpenClaw Gateway는런타임입니다. OpenClaw 먼저, openclaw-weixin-cli로 WeChat 연결. 입문: 크로스 플랫폼 설치 트러블슈팅.
plugins.entries.openclaw-weixin.enabled true 및 gateway restart. 다계정은 session.dmScope per-account-channel-peer. 노드 사양: 대여 요금.
Telegram 글은 409/Webhook/Relay. 본문은Tencent WeChat 공식 플러그인 설치·제품 한도. 연결: 헬프 센터.