로컬 또는 클라우드에서 OpenClaw Gateway가 이미 동작 중이고, 에이전트를 WeChat 1:1(텐센트 공식 ClawBot / openclaw-weixin 채널)에 연결하려면 본 글이 다음을 정리합니다. ① @tencent-weixin/openclaw-weixin-cli 원클릭 설치와 수동 설치 두 경로；② 호스트 OpenClaw와 플러그인 2.0.x / legacy 호환 매트릭스 대조；③ Public Beta의 1:1·파일·24시간 능동 메시지·컴플라이언스·작업 디렉터리 권한 등 경계와 증상별 트리아지. 3플랫폼 설치 입문과 보완하며, 본 글은 WeChat 채널에 집중합니다.
tools.profile이며 WeChat 채널 자체가 아닙니다. 도구 미실행 트리아지 런북을 참고하십시오.텐센트는 GitHub에서 openclaw-weixin 플러그인을 유지하고 npm으로 @tencent-weixin/openclaw-weixin-cli를 배포합니다(2026년 5월에도 갱신 중). 설치기는 openclaw --version을 읽어 호환 매트릭스에 따라 latest(2.0.x) 또는 legacy(1.0.x) dist-tag를 고른 뒤 openclaw plugins install과 QR 로그인까지 진행합니다. 버전을 손으로 맞추는 것보다 재현 가능한 운영에 가깝습니다.
실무에서 WeChat을 「채팅 UI 하나 더」로만 보고 Gateway 전원 정책·백업을 티켓에 쓰지 않는 팀이 많습니다. 야간 QR만 성공해도 아침에는 채널만 빨간 채로 남고, 플러그인 재설치를 반복해 변경 이력이 지저분해지는 패턴이 있습니다. 본 글의 여섯 모듈은 그 시행착오를 절차·표·지표로 바꾸기 위한 것입니다.
| 사이트 기존 장문 | 본 글이 다룸 | 본 글이 반복하지 않음 |
|---|---|---|
| 3플랫폼 설치 입문 | WeChat 채널 플러그인 + QR | Windows/macOS/Linux 최초 OpenClaw 설치 |
| 업그레이드 호위 backup/probe | 업그레이드 후 플러그인 재정렬 | gateway probe / ACP 전체 사다리 |
| tools.profile 트리아지 | WeChat 대화 가능·도구 불가 시 분기 | allowlist 전문 글 |
| SSH 포워딩 상시 Gateway | 7×24 WeChat은 상시 전원 호스트 | LocalForward 단계 명령 |
CLI 실행 전 다음을 순서대로 확인하는 것을 권장합니다.
openclaw gateway status 정상. 원격 배치 시 권위 Gateway 프로세스가 하나뿐인지.openclaw update 예정 시 선행 backup create(업그레이드 호위 글).프로덕션 WeChat 사용 팀은 변경 티켓에 「QR 수행자」「계정 유형(메인/전용 보조)」「작업 디렉터리 상한」을 적어 두면 사후 감사가 수월합니다. 개인 실험과 프로덕션 SLA는 같은 명령열이라도 수락 기준이 다릅니다.
| 플러그인 dist-tag | openclaw-weixin 주버전 | 호스트 OpenClaw 권장 |
|---|---|---|
| latest | 2.0.x | ≥ 2026.3.22 |
| legacy | 1.0.x | ≥ 2026.1.0 < 2026.3.22 |
openclaw CLI가 설치된 머신에서 실행합니다(Gateway 동일 호스트 또는 SSH 원격 Mac).
openclaw --version openclaw gateway status npx -y @tencent-weixin/openclaw-weixin-cli@latest install # 일반 흐름: 호스트 감지 → latest/legacy 선택 → plugins install → QR → gateway restart 안내 openclaw gateway restart openclaw channels status --probe
QR 성공 후 파일 전송 또는 전용 보조 계정에 탐침 메시지를 보내 Gateway 로그에 인바운드 이벤트가 있는지 확인하십시오. Control UI에 WeChat 채널이 없으면 콘솔 갱신과 브라우저 강력 새로고침(Windows: Ctrl+F5, macOS: Cmd+Shift+R)이 커뮤니티에서 자주 통합니다.
npx 마법사로 QR을 띄울 수 없을 때(TTY 없음, SSH만) 다음 네 단계로 전환합니다.
openclaw plugins install "@tencent-weixin/openclaw-weixin" openclaw config set plugins.entries.openclaw-weixin.enabled true # QR을 표시할 수 있는 세션에서: openclaw channels login --channel openclaw-weixin openclaw gateway restart
다중 WeChat 계정: channels login마다 계정 행이 추가됩니다. 병행 시 openclaw config set session.dmScope per-account-channel-peer로 세션 엇갈림을 방지하십시오.
다음 제한은 텐센트 Public Beta 설명과 커뮤니티 실측 요약입니다. 팀 런북에 사전 기록하십시오.
AGENTS.md·도구 정책으로 쓰기 경로를 제한하고 WeChat 유발 도구 체인에 $HOME 전체를 노출하지 마십시오.계정 안전: ClawBot에는 전용 보조 계정을 강력 권장합니다. 메인·결제·업무 그룹과 분리하고, 프로덕션 시크릿을 WeChat에서 접근 가능한 프롬프트에 넣지 마십시오.
openclaw --version, 플러그인 버전, Gateway 형태(로컬/Docker/원격 Mac) 기록.openclaw backup create. QR·페어링 손실 시 복귀점.openclaw-weixin-cli install, 실패 시 수동 plugins install.tools.profile이 팀 정책의 coding/full인지 확인.변경 티켓 정량 예: 채널 가용률(상시 Gateway 전제 7일 인바운드 성공률 ≥99% 목표), 플러그인 불일치 횟수(OpenClaw 갱신 후 호환 설치기 미실행=0), 메인 계정 연결 비율(0 목표).
WeChat은 입구일 뿐이며 안정 호스트가 기반입니다. 개인 노트북 QR만 성공하고 덮개를 닫으면 SLA를 감사할 수 없습니다. 7×24 1:1·티켓화 변경·명확한 디렉터리 경계가 필요하면 MACCOME 6리전 전용 원격 Mac(M4/M4 Pro)에 OpenClaw+openclaw-weixin을 고정하는 편이 절전 노트북 QR/probe 다툼보다 총비용에 유리한 경우가 많습니다. 공개 요금은다리전 노드 가이드, 연결은고객 센터·대여 가격을 참고하십시오.
| 증상 | 우선 의심 | 첫 조치 |
|---|---|---|
| 콘솔에 WeChat 채널 없음 | UI 캐시 / 플러그인 비활성 | 갱신+강력 새로고침; plugins.entries.openclaw-weixin.enabled |
| QR 미표시·만료 | TTY / 시계 드리프트 | channels login --channel openclaw-weixin 재시도; NTP |
| 수신만·회신 없음 | Gateway 유사 정지 / 모델 라우팅 | gateway status+doctor; 노트북 절전 제외 |
| 대화 가능·도구 불가 | tools.profile |
tools.profile 전문으로. WeChat 플러그인 재설치 남발 금지 |
| 업그레이드 후 채널 소실 | 호스트·플러그인 불일치 | openclaw-weixin-cli install 재실행 또는 legacy/latest 고정 |
자주 묻는 질문
OpenClaw 업그레이드 후 WeChat 채널이 사라지면?
플러그인 2.0.x/legacy 매트릭스를 대조한 뒤 npx -y @tencent-weixin/openclaw-weixin-cli@latest install을 실행하십시오. 업그레이드 전 backup create 권장. 상시 노드 계획은대여 가격을 참고하십시오.
ClawBot을 WeChat 그룹에 연결할 수 있습니까?
현재 Public Beta는 주로 1:1이며 그룹 시나리오는 지원되지 않습니다. 자동화는 파일 전송 또는 전용 보조 계정 DM을 사용하십시오.