기준일: 2026-07-26
공식 기준: WeChat
WeChat 문서는 OpenClaw 공식 문서(channels/wechat)를 한국어로 정리한 가이드입니다. WeChat channel setup through the external openclaw-weixin plugin 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치된 CLI 버전과 공식 원문을 확인하세요.
핵심 요약
WeChat channel setup through the external openclaw-weixin plugin
한국어 가이드 범위: channels/wechat 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.
문서 구성
공식 문서의 주요 섹션은 다음과 같습니다.
- Naming
- 동작 방식
- 설치
- Login
- 접근 제어
- Compatibility
- Sidecar process
- 트러블슈팅
- Related docs
상세 내용
본문
OpenClaw connects to WeChat through Tencent's external @tencent-weixin/openclaw-weixin channel plugin.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
Naming
Use openclaw-weixin in CLI commands and config paths.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
주요 항목:
- WeChat is the user-facing name in these docs.
- Weixin is the name used by Tencent's package and by the plugin id.
openclaw-weixinis the OpenClaw channel id (weixinandwechatwork as aliases).@tencent-weixin/openclaw-weixinis the npm package.
동작 방식
The WeChat code does not live in the OpenClaw core repo. OpenClaw provides the generic channel plugin contract, and the external plugin provides the WeChat-specific runtime:
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
설치
npx -y @tencent-weixin/openclaw-weixin-cli install
openclaw plugins install "@tencent-weixin/openclaw-weixin"
openclaw config set plugins.entries.openclaw-weixin.enabled true
openclaw gateway restart
Login
Run QR login on the same machine that runs the Gateway:
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
openclaw channels login --channel openclaw-weixin
openclaw config set session.dmScope per-account-channel-peer
접근 제어
Direct messages use the normal OpenClaw pairing and allowlist model for channel plugins.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
openclaw pairing list openclaw-weixin
openclaw pairing approve openclaw-weixin <CODE>
Compatibility
The plugin checks the host OpenClaw version at startup.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
| Plugin line | OpenClaw version | npm tag |
|---|---|---|
2.x |
>=2026.5.12 (current 2.4.6; early 2.x accepted >=2026.3.22) |
latest |
1.x |
>=2026.1.0 <2026.3.22 |
legacy |
openclaw plugins install @tencent-weixin/openclaw-weixin@legacy
Sidecar process
The WeChat plugin can run helper work beside the Gateway while it monitors the Tencent iLink API. In issue #68451, that helper path exposed a bug in OpenClaw's generic stale-Gateway cleanup: a child process could try to clean up the parent Gateway process, causing restart loops under process managers such as systemd.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
트러블슈팅
If the channel shows as installed but does not connect, confirm that the plugin is enabled and restart:
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
openclaw plugins list
openclaw channels status --probe
openclaw --version
openclaw config set plugins.entries.openclaw-weixin.enabled true
openclaw gateway restart
npm view @tencent-weixin/openclaw-weixin version
openclaw plugins install "@tencent-weixin/openclaw-weixin" --force
openclaw gateway restart
openclaw config set plugins.entries.openclaw-weixin.enabled false
openclaw gateway restart
Related docs
주요 항목:
- Channel overview: Chat Channels
- Pairing: Pairing
- Channel routing: Channel Routing
- Plugin architecture: Plugin Architecture
- Channel plugin SDK: Channel Plugin SDK
- External package: @tencent-weixin/openclaw-weixin
실습 체크리스트
- 공식 문서와 로컬 버전을 대조합니다:
https://docs.openclaw.ai/channels/wechat - 관련 CLI는
openclaw --help및 하위 명령--help로 옵션을 확인합니다. - 설정 변경 시
openclaw config/openclaw doctor로 유효성을 검사합니다. - Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.
자주 쓰는 명령·설정 예시
npx -y @tencent-weixin/openclaw-weixin-cli install
openclaw plugins install "@tencent-weixin/openclaw-weixin"
openclaw config set plugins.entries.openclaw-weixin.enabled true
openclaw gateway restart
openclaw channels login --channel openclaw-weixin
openclaw config set session.dmScope per-account-channel-peer
openclaw pairing list openclaw-weixin
openclaw pairing approve openclaw-weixin <CODE>
관련 링크
- 공식 원문: channels/wechat
- OpenClaw 문서 홈
이 가이드는 공식 문서를 한국어 학습용으로 재구성한 것입니다. 옵션 기본값·플래그 이름은 설치 버전에 따라 달라질 수 있습니다.