Zalo ClawBot
기준일: 2026-07-26
공식 기준: Zalo ClawBot
Zalo ClawBot 문서는 OpenClaw 공식 문서(channels/zaloclawbot)를 한국어로 정리한 가이드입니다. Zalo ClawBot channel setup through the external openclaw-zaloclawbot plugin 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치된 CLI 버전과 공식 원문을 확인하세요.
핵심 요약
Zalo ClawBot channel setup through the external openclaw-zaloclawbot plugin
한국어 가이드 범위: channels/zaloclawbot 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.
문서 구성
공식 문서의 주요 섹션은 다음과 같습니다.
- Compatibility
- 사전 요구사항
- Install with onboard (recommended)
- Manual installation
- 1. Install the plugin
- 2. Enable the plugin in config
- 3. Generate a QR code and log in
- 4. Restart the gateway
- 동작 방식
- Under the hood
- 트러블슈팅
- 관련 문서
상세 내용
본문
OpenClaw connects to Zalo ClawBot through the catalog-listed external @zalo-platforms/openclaw-zaloclawbot plugin. Login uses a Zalo Mini App QR code; the plugin id in config is openclaw-zaloclawbot.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
Compatibility
| Plugin Version | OpenClaw Version | npm dist-tag | Status |
|---|---|---|---|
| 0.1.4 | >=2026.4.10 | latest |
Active / Beta |
사전 요구사항
주요 항목:
- Node.js >= 22
- OpenClaw installed (
openclawCLI available) - A Zalo account on a mobile device to scan the login QR code
Install with onboard (recommended)
Pick Zalo ClawBot from the channel menu. The wizard installs the plugin from the official catalog (integrity-verified), renders the login QR in the terminal, and finishes the channel once you scan it with the Zalo app.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
openclaw onboard
Manual installation
To add the channel to an already-onboarded gateway:
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
1. Install the plugin
Use the exact pinned version so OpenClaw verifies the package against the catalog integrity hash during install.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
openclaw plugins install "@zalo-platforms/openclaw-zaloclawbot@0.1.4"
2. Enable the plugin in config
openclaw config set plugins.entries.openclaw-zaloclawbot.enabled true
3. Generate a QR code and log in
Scan the terminal-rendered QR code with the Zalo mobile app, accept the Terms of Use inside the Zalo Mini App, and authorize the session.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
openclaw channels login --channel openclaw-zaloclawbot
4. Restart the gateway
openclaw gateway restart
동작 방식
Unlike the standard Zalo channel, which requires registering your own Zalo Official Account (OA) and configuring static developer credentials, Zalo ClawBot is an owner-bound personal assistant on shared official infrastructure:
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
Under the hood
The plugin communicates with Zalo via a persistent long-polling loop (getUpdates). Webhooks are disabled by default for local desktop/terminal gateway runs. Messages are processed client-side and mapped to your local agent runtime.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
트러블슈팅
주요 항목:
- QR login timeout: the login token (
zbsk) expires after 5 minutes for security. If the QR code expires before you scan it, rerun the login command to generate a new one. - Gateway fails to load: confirm your OpenClaw host version is
2026.4.10or higher. Older versions do not support the external npm-plugin installation ledger this ID requires.
관련 문서
주요 항목:
- Channels Overview - all supported channels
- Zalo - the bundled Zalo Bot Creator / Marketplace channel
- Pairing - DM authentication and pairing flow
- Plugins - installing and managing plugins
실습 체크리스트
- 공식 문서와 로컬 버전을 대조합니다:
https://docs.openclaw.ai/channels/zaloclawbot - 관련 CLI는
openclaw --help및 하위 명령--help로 옵션을 확인합니다. - 설정 변경 시
openclaw config/openclaw doctor로 유효성을 검사합니다. - Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.
자주 쓰는 명령·설정 예시
openclaw onboard
openclaw plugins install "@zalo-platforms/openclaw-zaloclawbot@0.1.4"
openclaw config set plugins.entries.openclaw-zaloclawbot.enabled true
openclaw channels login --channel openclaw-zaloclawbot
openclaw gateway restart
관련 링크
이 가이드는 공식 문서를 한국어 학습용으로 재구성한 것입니다. 옵션 기본값·플래그 이름은 설치 버전에 따라 달라질 수 있습니다.