Zalo 채널 설정

OpenClaw와 Zalo를 연결하여 베트남 시장용 AI 봇을 구축하는 방법을 안내합니다.

개요

Zalo는 베트남에서 가장 인기 있는 메시징 앱으로, OpenClaw 플러그인으로 사용할 수 있습니다.

• 베트남 1위 — 베트남 시장 점유율 1위
• Chat API — Zalo 공식 API 지원
• 다국어 지원 — 베트남어, 영어 등
• 풍부한 기능 — 이미지, 스티커, 템플릿
• Zalo Pay — 결제 통합 가능

플러그인 채널: 별도 설치 필요

1단계: Zalo 플러그인 설치

openclaw plugin install @openclaw/channel-zalo

2단계: Zalo Developers 계정 생성

1. Zalo Developers 접속: https://developers.zalo.me/
2. 로그인 (Zalo 계정으로)
3. 앱 등록:
   • 앱 이름: OpenClaw Bot
   • 설명: AI Assistant

3단계: Chat API 활성화

1. 생성된 앱 선택
2. SDK & API → Chat API
3. API Secret Key 생성 및 복사

4단계: Webhook URL 설정

1. Chat API → Webhook
2. Webhook URL: https://your-domain.com/zalo/webhook
3. Verify

5단계: OpenClaw 설정

{
  "channels": {
    "zalo": {
      "enabled": true,
      "appId": "your-app-id",
      "appSecret": "your-app-secret",
      "webhookPath": "/zalo/webhook",
      "dmPolicy": "allowlist",
      "allowFrom": ["user-id"],
      "groupPolicy": "allowlist"
    }
  }
}

환경 변수로 설정:

ZALO_APP_ID=your-app-id
ZALO_APP_SECRET=your-app-secret

6단계: 게이트웨이 시작

openclaw gateway

메시지 기능

지원되는 기능:

• 텍스트 메시지
• 이미지
• 스티커
• 템플릿 메시지

미지원 기능:

• 음성 메시지 (제한적)

트러블슈팅

Webhook 검증 실패

1. Webhook URL 확인
2. OpenClaw 게이트웨이 실행 중인지 확인
3. App Secret 확인

참고:

• Zalo Developers
• 공식 문서: Zalo Channel