2026년 텐센트 WeChat ClawBot OpenClaw 설치: 원클릭 install, 버전 호환과 Mac VPS 회피 Runbook(의사결정표와 FAQ)
2026년 텐센트는 개인 WeChat에 공식 ClawBot 플러그인을 그레이 배포하기 시작했습니다. 일상 IM을 OpenClaw Gateway에 연결할 수 있어 기업 WeChat이나 비공식 브리지를 거칠 필요가 없습니다. 그러나 「OpenClaw 본체를 먼저 통과한 뒤 QR 스캔」 순서, openclaw-weixin 2.0.x와 1.0.x 호환 매트릭스, 1:1 채팅만·24시간 상호작용 창 같은 하드 제한 때문에 npm 한 방으로 끝나지 않습니다. 본문은 Mac/Linux에서 Gateway를 이미 통과했고 WeChat이 ClawBot 그레이 대상(iOS 8.0.70+ / Android 8.0.69+)인 개발자를 위해 의사결정표, 그레이 자가 진단, Mac VPS 사전 조건, 7단계 Runbook, 버전·제한 대조표, 계층별 장애 분석, FAQ를 제공해 Apple Silicon Mac 클라우드에서 감사 가능한 7×24 배포를 목표로 합니다.
목차
1. 의사결정표: 개인 WeChat ClawBot vs 기업 WeChat/ Feishu vs Telegram
팀이 이미 기업 WeChat에 워크플로를 구축했다면 기업용 커넥터가 1순위입니다. ClawBot의 가치는 「개인 WeChat 습관 + 공식 플러그인」에 있으며, 개발자 개인 비서나 소규모 비공식 협업에 적합하고 컴플라이언스 중심 그룹 봇 대체재는 아닙니다.
| 관점 | 개인 WeChat ClawBot | 기업 WeChat / Feishu | Telegram / Discord |
|---|---|---|---|
| 진입 습관 | 개인 WeChat 일상 대화 | 기업 협업·승인 | 해외·기술 커뮤니티 |
| 그룹 | 미지원(1:1만) | @bot 지원 | mention 지원 |
| 컴플라이언스 | 콘텐츠는 텐센트 서버 경유 | 기업 도메인·감사 | 자체 Bot API |
| 7×24 상주 | Mac VPS + launchd | 동일 | 동일; 멀티채널 Runbook 참고 |
2. 그레이 자가 진단: ClawBot 진입점과 버전 임계값
배포 전 휴대폰 WeChat에서 설정 → 플러그인 → ClawBot 진입점을 확인하세요. iOS는 8.0.70 이상, Android는 8.0.69부터 그레이 중입니다. 진입점이 없으면 VPS에서 플러그인을 반복 설치해도 해결되지 않습니다. 실험적 Agent가 본업 흐름을 깨지 않도록 서브 계정 연동을 권장합니다. 그레이 통과 후 Mac VPS에서 OpenClaw 본체 스모크를 완료한 뒤 QR을 스캔하세요. Gateway 미준비 상태의 QR은 만료되거나 online 표시만 되고 응답이 없는 경우가 많습니다.
- ClawBot 진입점 없음: 앱 버전 확인. 비그레이 계정은 대기만.
- 진입점 있으나 미연동: VPS 측 Gateway와 Provider 검수 선행.
- 다른 OpenClaw에 이미 연동: WeChat 계정당 하나 제약. 해제 후 새 QR.
3. Mac VPS 사전 조건: Node 22, 18789, 동일 계정 HOME
openclaw-weixin은 Gateway 플러그인이며 독립 Bot 프로세스가 아닙니다. 반설치 상태에서 npx만 실행하면 QR은 나와도 재시작 후 session이 사라지는 전형이 나옵니다. 사전 체크리스트는 다음과 같습니다. 원클릭 배포 가이드와 게이트웨이 Runbook도 함께 보세요.
- 런타임: Node.js 22+.
openclaw --version과openclaw doctor에서 반설치 경고 없음. - Gateway:
lsof -i :18789또는openclaw gateway status로 수신 확인. - LLM Provider: 최소 1개 라우트 사용 가능. 없으면 채널 online이어도 회신 없음.
- 계정 정렬: launchd plist
UserName과 CLI가 동일 macOS 사용자,HOME일치. - 권한 감사: 플러그인 디렉터리 최소 권한. ClawHub 감사 선행.
openclaw gateway status
openclaw --version
echo "USER=$USER HOME=$HOME"
4. 7단계 Runbook: 본체 → CLI install → QR → 검수
권장 순서는 「본체 스모크 → 공식 CLI → QR → 재시작 → 1:1 검수 → launchd 상주 재검증」으로 고정합니다. CLI는 OpenClaw 버전에 맞춰 dist-tag를 자동 선택합니다. CLI 실패 시에만 수동 경로를 사용하세요.
- 본체 스모크: doctor 통과, 18789 수신, 최소 Agent 대화 가능.
- 원클릭 CLI install: 아래 명령. 플러그인 디렉터리와 openclaw.json diff 확인.
- 수동 대안:
openclaw plugins install @tencent-weixin/openclaw-weixin, 이어서openclaw channels login weixin. - QR 연동: 터미널 QR 표시 후 휴대폰 ClawBot에서 스캔. 타임아웃 시 restart 후 재시도.
- Gateway 재시작:
openclaw gateway restart,openclaw gateway status에서 weixin online. - 1:1 검수: ClawBot에 순수 텍스트 전송, Agent 회신과 JSONL
toolCallId확인. - 7×24 재검증: launchctl 재로드 또는 노드 재시작 후 6단계 재실행.
# 수동 대안
openclaw plugins install @tencent-weixin/openclaw-weixin
openclaw channels login weixin
openclaw gateway restart
openclaw gateway status
5. 버전 호환표와 ClawBot 하드 제한
버전 불일치 시 플러그인이 로드 거부하며 로그에 semver 또는 peer dependency 경고가 남습니다. OpenClaw 업그레이드 후 5월 버전 릴리스 트레인 Runbook으로 검수하고 필요 시 CLI install을 재실행하세요.
| openclaw-weixin | OpenClaw 요구 | 비고 |
|---|---|---|
| 2.0.x | ≥ 2026.3.22 | 현행 권장. CLI 기본 dist-tag |
| 1.0.x legacy | 구 OpenClaw | 기존 호환만. 신규는 고정하지 않음 |
| 제한 | 설명 | 운영 제안 |
|---|---|---|
| 1:1만 | 그룹 @bot 미지원 | 그룹은 기업 WeChat 또는 Telegram |
| 텍스트 중심 | 리치 미디어 혼합 없음 | 장문 분할 또는 다른 채널 |
| 24h 창 | 비상호작용 능동 전송은 폐기될 수 있음 | 정기 ping 또는 cron으로 대화 유지 |
| 계정당 하나 | 동일 WeChat을 여러 Gateway에 불가 | 해제 후 새 QR |
| 데이터 경로 | 텐센트 서버 중계 | 민감 자격증명 전송 금지. 작업 디렉터리 최소 권한 |
6. 계층별 장애 분석: QR 없음, 버전 거부, online 무응답
「WeChat 불통」은 계층으로 나눕니다: 프로토콜/QR → 플러그인 버전 → Gateway 18789 → Provider/라우팅 → 1:1 정책. 각 계층에서 JSONL과 openclaw gateway status --deep을 맞추고 재시작만 의존하지 마세요.
| 증상 | 근본 원인 | 복구 |
|---|---|---|
| QR 없음 / 프로토콜 설정 실패 | Gateway 미준비 또는 HOME 분열 | doctor + 동일 사용자 CLI. 게이트웨이 Runbook 참고 |
| 플러그인 로드 거부 | openclaw-weixin과 OpenClaw 불일치 | ≥2026.3.22 업그레이드 또는 CLI 재 install |
| QR 후 끊김 | 로컬 절전 또는 launchd 사용자 불일치 | Mac VPS 상주 + plist UserName 정렬 |
| online 무응답 / 수신만 | Provider 제한 또는 session 라우팅 오류 | 모델 라우트 확인. 멀티채널 시 Runbook 참고 |
7. FAQ
질문: ClawBot은 Telegram 등과 병행할 수 있나요? 가능합니다. 채널별 session 네임스페이스를 분리하고 멀티채널 Runbook으로 최소 대화 검수를 수행하세요.
질문: Mac VPS가 로컬보다 나은 이유는? 노트북 절전으로 장연결 끊김. Mac 클라우드는 launchd 상주, 고정 IP와 HOME으로 7×24에 적합합니다.
질문: 해외 노드 사용 가능한가요? WeChat 계정과 텐센트 도달성에 따릅니다. 프로덕션은 저지연 리전을 권장하고 끊김률을 모니터링하세요.
질문: Android 전면 배포는 언제? 텐센트 공식 공지를 따르세요. 현재 8.0.69 그레이 중. 진입점 없으면 구버전 플러그인 강제 설치는 피하세요.
8. 결론
성공 기준은 OpenClaw 본체 → CLI install → QR → 18789 1:1 재현의 사슬입니다. ClawBot은 개인 WeChat 진입용이며 기업 WeChat 컴플라이언스 그룹 채팅 대체재가 아닙니다. 호환표와 24h 창은 변경 티켓에 명시하세요. WeChat과 다른 IM·Skill을 병행 상주하려면 VPSMAC Apple Silicon Mac 클라우드에서 Gateway, 플러그인 디렉터리, launchd를 한 Runbook으로 묶는 편이 안정적입니다. 게이트웨이 Runbook, 멀티채널 검수, Skill 감사도 참고하세요.