Regional platforms
Zalo ClawBot
OpenClaw은 카탈로그에 등록된 외부 @zalo-platforms/openclaw-zaloclawbot Plugin을 통해 Zalo ClawBot에 연결됩니다. 로그인에는 Zalo Mini App QR 코드를 사용하며, 구성의 Plugin ID는 openclaw-zaloclawbot입니다.
호환성
| Plugin 버전 | OpenClaw 버전 | npm 배포 태그 | 상태 |
|---|---|---|---|
| 0.1.4 | >=2026.4.10 | latest |
활성 / 베타 |
사전 요구 사항
- Node.js >= 22
- OpenClaw 설치됨(
openclawCLI 사용 가능) - 로그인 QR 코드를 스캔할 수 있는 모바일 기기의 Zalo 계정
온보딩으로 설치(권장)
openclaw onboard채널 메뉴에서 Zalo ClawBot을 선택합니다. 마법사가 공식 카탈로그에서 Plugin을 설치하고(무결성 검증), 터미널에 로그인 QR 코드를 표시한 다음, Zalo 앱으로 이를 스캔하면 채널 설정을 완료합니다.
수동 설치
이미 온보딩된 Gateway에 채널을 추가하려면 다음 단계를 따르세요.
1. Plugin 설치
openclaw plugins install "@zalo-platforms/openclaw-zaloclawbot@0.1.4"설치 중 OpenClaw이 카탈로그 무결성 해시를 기준으로 패키지를 검증할 수 있도록 정확히 고정된 버전을 사용하세요.
2. 구성에서 Plugin 활성화
openclaw config set plugins.entries.openclaw-zaloclawbot.enabled true3. QR 코드 생성 및 로그인
openclaw channels login --channel openclaw-zaloclawbotZalo 모바일 앱으로 터미널에 표시된 QR 코드를 스캔하고, Zalo Mini App 내부의 이용 약관에 동의한 다음 세션을 승인합니다.
4. Gateway 재시작
openclaw gateway restart작동 방식
자체 Zalo 공식 계정(OA)을 등록하고 정적 개발자 자격 증명을 구성해야 하는 표준 Zalo 채널과 달리, Zalo ClawBot은 공유 공식 인프라에서 작동하는 소유자 전용 개인 비서입니다.
- 온보딩: QR 코드는 새로 프로비저닝된 비공개 봇을 공유 공식 OA 아래에서 사용자의 Zalo 사용자 ID에 직접 연결하는 Zalo Mini App으로 이어집니다.
- 소유자 전용 개인정보 보호: 봇은 소유자와만 통신합니다. 다른 사용자의 메시지는 플랫폼 수준에서 폐기됩니다.
- 공식 API 경로: Plugin은 브라우저나 웹 세션 자동화가 아닌 Zalo Bot Platform API를 사용합니다.
내부 작동 방식
Plugin은 지속적인 롱 폴링 루프(getUpdates)를 통해 Zalo와 통신합니다. 로컬 데스크톱/터미널 Gateway 실행에서는 Webhook이 기본적으로 비활성화됩니다. 메시지는 클라이언트 측에서 처리되어 로컬 에이전트 런타임에 매핑됩니다.
Plugin은 OpenClaw 상태 디렉터리에서 봇 자격 증명을 관리합니다. 해당 디렉터리를 민감한 정보로 취급하고 나머지 OpenClaw 상태와 동일한 접근 제어 및 백업 정책을 적용하세요.
이 Plugin의 런타임은 전적으로 외부 @zalo-platforms/openclaw-zaloclawbot 패키지에 있습니다. 아래의 설치/구성 이외 동작 세부 정보는 Plugin 유지관리자가 보고한 내용이며 OpenClaw 핵심 소스를 기준으로 검증되지 않았습니다.
문제 해결
- QR 로그인 시간 초과: 보안을 위해 로그인 토큰(
zbsk)은 5분 후 만료됩니다. 스캔하기 전에 QR 코드가 만료되면 로그인 명령을 다시 실행하여 새 코드를 생성하세요. - Gateway 로드 실패: OpenClaw 호스트 버전이
2026.4.10이상인지 확인하세요. 이전 버전은 이 ID에 필요한 외부 npm Plugin 설치 원장을 지원하지 않습니다.
