Files
openclaw-skill/openclaw-knowhow-skill/docs/channels/zalo.md
Selig 4c966a3ad2 Initial commit: OpenClaw Skill Collection
6 custom skills (assign-task, dispatch-webhook, daily-briefing,
task-capture, qmd-brain, tts-voice) with technical documentation.
Compatible with Claude Code, OpenClaw, Codex CLI, and OpenCode.
2026-03-13 10:58:30 +08:00

1.5 KiB

Zalo Bot Integration

Overview

Zalo is a Vietnam-focused messaging platform with Bot API support. This documentation describes setting up a Zalo bot channel for direct messaging through OpenClaw's gateway system.

Setup Steps

  1. Install the plugin:
openclaw plugins install @openclaw/zalo
  1. Configure bot token via environment variable (ZALO_BOT_TOKEN) or config file

  2. Restart the gateway to activate the channel

Core Capabilities

The integration supports:

  • Direct messages only (groups "coming soon" per Zalo documentation)
  • Text messages with 2000-character chunking
  • Image handling for inbound/outbound media
  • Deterministic routing ensuring replies return to Zalo

Access Control

By default, unknown senders receive a pairing code that expires after one hour. Approval is managed through CLI commands:

openclaw pairing approve zalo <CODE>

Alternative policies include allowlisting specific user IDs.

Technical Constraints

  • The 2000-character output limit makes streaming blocked by default since it reduces practical utility
  • Media uploads and downloads are capped at 5 MB by default
  • Stickers and unsupported message types are logged but not processed

Deployment Options

The channel supports two modes (mutually exclusive per Zalo API specifications):

Long-Polling (Default)

No additional configuration required.

Webhook Mode

Requires:

  • HTTPS endpoint
  • A secret token between 8-256 characters