@zalo-platforms/openclaw-zaloclawbot Plugin을 통해 Zalo ClawBot에 연결됩니다. 로그인에는 Zalo Mini App QR 코드를 사용하며, 구성의 Plugin ID는 openclaw-zaloclawbot입니다.
호환성
사전 요구 사항
- Node.js >= 22
- OpenClaw 설치됨(
openclawCLI 사용 가능) - 로그인 QR 코드를 스캔할 수 있는 모바일 기기의 Zalo 계정
온보딩으로 설치(권장)
수동 설치
이미 온보딩된 Gateway에 채널을 추가하려면 다음 단계를 따르세요.1. Plugin 설치
2. 구성에서 Plugin 활성화
3. QR 코드 생성 및 로그인
4. Gateway 재시작
작동 방식
자체 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 설치 원장을 지원하지 않습니다.