Selig
4c966a3ad2
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.
58 lines
1.5 KiB
Markdown
58 lines
1.5 KiB
Markdown
# 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:**
|
|
|
|
```bash
|
|
openclaw plugins install @openclaw/zalo
|
|
```
|
|
|
|
2. **Configure bot token** via environment variable (`ZALO_BOT_TOKEN`) or config file
|
|
|
|
3. **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:
|
|
|
|
```bash
|
|
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
|