Canal Zalo OpenClaw
Connectez OpenClaw à Zalo via la Zalo Bot Platform. Cette intégration permet à votre assistant IA d'envoyer et de recevoir des messages sur l'application de messagerie la plus populaire du Vietnam. Configurez un Bot Token, définissez votre politique de DM, et commencez à discuter — avec prise en charge du long-polling et du webhook.
Zalo Fonctionnalités prises en charge
Messages texte
Pris en charge
Médias et fichiers
Non pris en charge
Réactions
Non pris en charge
Fils de discussion
Non pris en charge
Messages vocaux
Non pris en charge
Discussion de groupe
Non pris en charge
Zalo Prérequis
- Un compte Zalo avec accès à la Zalo Bot Platform (bot.zaloplatforms.com)
- Un Bot Token obtenu depuis le tableau de bord de la Zalo Bot Platform
- OpenClaw Gateway en cours d'exécution et configuré
- Pour le mode webhook : un point de terminaison HTTPS accessible publiquement
Zalo Configuration rapide
Créer un Bot Zalo et obtenir votre Token
Rendez-vous sur bot.zaloplatforms.com, connectez-vous avec votre compte Zalo et créez un nouveau bot. Copiez le Bot Token (format : 12345689:abc-xyz) depuis le tableau de bord.
Ajouter la configuration du canal Zalo
Ajoutez la configuration du canal Zalo dans ~/.openclaw/openclaw.json. Définissez le botToken, la dmPolicy (pairing, allowlist, open ou disabled), et configurez éventuellement les paramètres webhook.
Démarrer le Gateway et tester
Démarrez le Gateway avec 'openclaw start'. Le bot se connectera par défaut en mode long-polling. Envoyez un message à votre bot sur Zalo pour vérifier que la connexion fonctionne.
Zalo Exemple de configuration
{
"channels": {
"zalo": {
"enabled": true,
"botToken": "12345689:abc-xyz",
"dmPolicy": "pairing"
}
}
}Zalo Documentation Détaillée
Aperçu de l'architecture
Création de votre Bot Zalo
{
"channels": {
"zalo": {
"enabled": true,
"botToken": "12345689:abc-xyz"
}
}
}Politiques de DM
{
"channels": {
"zalo": {
"dmPolicy": "allowlist",
"allowFrom": ["123456789", "987654321"]
}
}
}Configuration Webhook
{
"channels": {
"zalo": {
"botToken": "12345689:abc-xyz",
"webhookUrl": "https://your-server.com/zalo/webhook",
"webhookSecret": "your-secret-string-8-to-256-chars",
"webhookPath": "/zalo/webhook"
}
}
}Traitement des messages
Configuration multi-comptes
{
"channels": {
"zalo": {
"accounts": {
"support-bot": {
"botToken": "token-for-support-bot",
"dmPolicy": "open"
},
"team-bot": {
"botToken": "token-for-team-bot",
"dmPolicy": "allowlist",
"allowFrom": ["111222333"]
}
}
}
}
}Envoi de messages sortants
openclaw message send --channel zalo --target 123456789Configuration du proxy
{
"channels": {
"zalo": {
"proxy": "http://proxy.example.com:8080"
}
}
}Zalo Référence de Configuration
| Key | Type | Default | Description |
|---|---|---|---|
| enabled | boolean | false | Activer ou désactiver le canal Zalo |
| botToken | string | "" | Bot Token de la Zalo Bot Platform (bot.zaloplatforms.com) |
| tokenFile | string | "" | Lire le Bot Token depuis un chemin de fichier au lieu de la configuration en ligne |
| dmPolicy | string | "pairing" | Contrôle qui peut envoyer des DM au bot. Options : pairing, allowlist, open, disabled |
| allowFrom | string[] | [] | Identifiants utilisateur Zalo numériques autorisés à communiquer avec le bot (lorsque dmPolicy est allowlist) |
| mediaMaxMb | number | 5 | Taille maximale des fichiers multimédia entrants en mégaoctets |
| webhookUrl | string | "" | URL HTTPS pour le mode webhook. Lorsque défini, le long-polling est désactivé |
| webhookSecret | string | "" | Chaîne secrète (8-256 caractères) pour la vérification webhook via l'en-tête X-Bot-Api-Secret-Token |
| webhookPath | string | "" | Chemin webhook personnalisé sur le serveur HTTP du Gateway |
| proxy | string | "" | URL du proxy pour les requêtes API sortantes vers Zalo |
| accounts.<id>.botToken | string | "" | Bot Token pour un compte spécifique en mode multi-comptes |
| accounts.<id>.dmPolicy | string | "pairing" | Politique de DM personnalisée pour un compte spécifique |
| accounts.<id>.webhookUrl | string | "" | URL webhook personnalisée pour un compte spécifique |
Activer ou désactiver le canal Zalo
Bot Token de la Zalo Bot Platform (bot.zaloplatforms.com)
Lire le Bot Token depuis un chemin de fichier au lieu de la configuration en ligne
Contrôle qui peut envoyer des DM au bot. Options : pairing, allowlist, open, disabled
Identifiants utilisateur Zalo numériques autorisés à communiquer avec le bot (lorsque dmPolicy est allowlist)
Taille maximale des fichiers multimédia entrants en mégaoctets
URL HTTPS pour le mode webhook. Lorsque défini, le long-polling est désactivé
Chaîne secrète (8-256 caractères) pour la vérification webhook via l'en-tête X-Bot-Api-Secret-Token
Chemin webhook personnalisé sur le serveur HTTP du Gateway
URL du proxy pour les requêtes API sortantes vers Zalo
Bot Token pour un compte spécifique en mode multi-comptes
Politique de DM personnalisée pour un compte spécifique
URL webhook personnalisée pour un compte spécifique
Zalo Questions Fréquentes
Zalo Dépannage
Le Bot Token peut être invalide, expiré, ou le Gateway n'est pas en cours d'exécution. En mode webhook, le point de terminaison HTTPS peut être inaccessible.
Le long-polling a une latence inhérente par rapport au mode webhook. L'instabilité du réseau peut également provoquer le regroupement des messages.
La dmPolicy n'est peut-être pas définie sur 'pairing', ou le bot n'est pas correctement connecté à Zalo.
Le fichier image peut dépasser la limite mediaMaxMb, ou l'API Zalo peut être temporairement indisponible.
Le webhookSecret dans votre configuration ne correspond pas à ce que Zalo attend, ou le point de terminaison ne renvoie pas la bonne réponse.