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.
1.5 KiB
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
- Install the plugin:
openclaw plugins install @openclaw/zalo
-
Configure bot token via environment variable (
ZALO_BOT_TOKEN) or config file -
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