Zalo (Bot API)

상태: 실험적. 직접 메시지만 지원; Zalo 문서에 따라 그룹은 곧 제공될 예정입니다.

플러그인 필요

Zalo는 플러그인으로 제공되며 코어 설치에 포함되어 있지 않습니다.

Zalo 플러그인 설치:
- 소스 체크아웃에서: openclaw plugins install ./extensions/zalo
- npm에서 (게시된 경우): openclaw plugins install @openclaw/zalo
- 또는 온보딩에서 Zalo를 선택하고 설치 프롬프트를 확인
토큰 설정:
- Env: ZALO_BOT_TOKEN=...
- 또는 config: channels.zalo.botToken: "...".
Gateway를 재시작합니다 (또는 온보딩 완료).
DM 접근은 기본적으로 페어링입니다; 첫 연락 시 페어링 코드를 승인하세요.

최소 구성:

{
  channels: {
    zalo: {
      enabled: true,
      botToken: "12345689:abc-xyz",
      dmPolicy: "pairing"
    }
  }
}

Zalo는 베트남 중심의 메시징 앱입니다; Bot API를 통해 Gateway가 1:1 대화용 봇을 실행할 수 있습니다. Zalo로의 결정론적 라우팅을 원하는 지원 또는 알림에 적합합니다.

예시:

{
  channels: {
    zalo: {
      enabled: true,
      botToken: "12345689:abc-xyz",
      dmPolicy: "pairing"
    }
  }
}

Env 옵션: ZALO_BOT_TOKEN=... (기본 계정만 작동).

다중 계정 지원: 계정별 토큰 및 선택적 name과 함께 channels.zalo.accounts를 사용하세요.

기본값: channels.zalo.dmPolicy = "pairing". 알 수 없는 발신자는 페어링 코드를 받습니다; 승인될 때까지 메시지가 무시됩니다 (코드는 1시간 후 만료).
다음을 통해 승인:
- openclaw pairing list zalo
- openclaw pairing approve zalo <CODE>
페어링은 기본 토큰 교환입니다. 자세한 내용: Pairing
channels.zalo.allowFrom은 숫자 사용자 ID를 허용합니다 (사용자 이름 조회 불가).

기본값: long-polling (공개 URL 불필요).
Webhook 모드: channels.zalo.webhookUrl 및 channels.zalo.webhookSecret을 설정하세요.
- webhook secret은 8-256자여야 합니다.
- Webhook URL은 HTTPS를 사용해야 합니다.
- Zalo는 확인을 위해 X-Bot-Api-Secret-Token 헤더와 함께 이벤트를 전송합니다.
- Gateway HTTP는 channels.zalo.webhookPath에서 webhook 요청을 처리합니다 (기본값은 webhook URL 경로).

참고: getUpdates (polling)와 webhook은 Zalo API 문서에 따라 상호 배타적입니다.

봇이 응답하지 않음:

Webhook이 이벤트를 수신하지 않음:

전체 구성: Configuration

Provider 옵션:

channels.zalo.enabled: 채널 시작 활성화/비활성화.
channels.zalo.botToken: Zalo Bot Platform의 봇 토큰.
channels.zalo.tokenFile: 파일 경로에서 토큰 읽기.
channels.zalo.dmPolicy: pairing | allowlist | open | disabled (기본값: pairing).
channels.zalo.allowFrom: DM allowlist (사용자 ID). open은 "*"가 필요합니다. 마법사는 숫자 ID를 요청합니다.
channels.zalo.mediaMaxMb: 인바운드/아웃바운드 미디어 제한 (MB, 기본값 5).
channels.zalo.webhookUrl: webhook 모드 활성화 (HTTPS 필요).
channels.zalo.webhookSecret: webhook secret (8-256자).
channels.zalo.webhookPath: Gateway HTTP 서버의 webhook 경로.
channels.zalo.proxy: API 요청용 프록시 URL.

다중 계정 옵션: