OpenClaw sur Zalo

Zalo, l’application de messagerie centrée sur le Vietnam, est livrée comme extension intégrée dans les versions actuelles d’OpenClaw, marquée expérimentale, avec les messages directs et les discussions de groupe implémentés pour les bots Zalo Bot Creator et Marketplace. La page est explicite sur son périmètre : les bots de compte officiel sont une surface de produit différente qu’elle ne couvre pas. Voici la configuration, la circulation des messages, les limites, le contrôle d’accès des messages directs et des groupes, le contrat de webhook, et la liste de dépannage.

Configuration

• Créez un jeton de bot sur la plateforme de bots Zalo ; il a un identifiant numérique et un secret, et pour les bots du Marketplace, le jeton d’exécution utilisable peut apparaître dans le message de bienvenue du bot.
• Définissez le jeton comme variable d’environnement pour le compte par défaut ou dans la configuration sous une entrée de comptes, les clés plates de premier niveau étant un raccourci hérité à compte unique ; puis lancez la sonde, démarrez la passerelle si elle est arrêtée, et approuvez le code d’appairage au premier contact.
• Les builds plus anciens ou les installations personnalisées qui excluent Zalo installent le paquet depuis npm, épinglé seulement pour les installations reproductibles.
• Plusieurs comptes sont d’autres entrées sous la carte des comptes, chacune avec son propre jeton et son nom, et une clé de compte par défaut choisit le compte par défaut.

Le routage de retour vers Zalo est déterministe. Le modèle ne choisit jamais les canaux.

Comment cela fonctionne et les limites

Les messages entrants sont normalisés dans l’enveloppe de canal partagée avec des espaces réservés pour les médias, les réponses reviennent toujours dans la même discussion, la citation en réponse est fixée à off, et les groupes exigent une mention pour déclencher le bot, ce qui n’est pas configurable par canal. Le transport est l’interrogation longue par défaut sans URL publique requise, ou le mode webhook avec une URL et un secret. Le tableau des limites : le texte sortant est découpé à 2 000 caractères, la limite de l’API Zalo ; les médias entrants et sortants sont plafonnés à cinq mégaoctets par défaut ; un corps de requête webhook est plafonné à un mégaoctet avec un délai de lecture de trente secondes ; la limite de débit du webhook est de 120 requêtes par minute par chemin et adresse IP cliente, puis HTTP 429 ; et les marqueurs de relecture gardent jusqu’à 20 000 événements terminés par compte pendant trente jours, indexés par identifiant de message.

Contrôle d’accès

• Les messages directs sont en appairage par défaut, avec des codes qui expirent après une heure ; les autres politiques sont liste d’autorisation, ouvert, qui exige l’entrée générique, et désactivé, et la liste d’autorisation prend des identifiants d’utilisateurs Zalo numériques puisqu’il n’y a pas de recherche par nom.
• Les groupes sont filtrés par mention plus politique de groupe, ouvert, liste d’autorisation ou désactivé, avec une liste d’autorisation de groupe qui retombe sur celle des messages directs ; une politique de groupe absente se résout en ouvert quand le canal est configuré et échoue de façon fermée en liste d’autorisation quand le bloc du canal manque entièrement.
• Une réserve rapportée sur le terrain : sur certaines configurations de bots du Marketplace, le bot ne pouvait pas du tout être ajouté à un groupe, une contrainte côté plateforme à vérifier dans les réglages de la plateforme du bot plutôt qu’une politique d’OpenClaw.

L’appairage dans OpenClaw explique le code d’approbation qu’envoie le réglage par défaut des messages directs, et Hooks et webhooks dans OpenClaw le contrat de webhook à acceptation durable que ce canal partage avec les autres.

Le contrat de webhook et les types de messages

Le mode webhook exige une URL HTTPS et un secret de 8 à 256 caractères ; Zalo envoie les événements avec un en-tête de jeton secret comparé en temps constant, la passerelle sert le chemin configuré, les requêtes doivent porter un type de contenu JSON, et OpenClaw ne renvoie 200 qu’après avoir stocké durablement l’événement brut, 500 en cas d’échec de stockage, avec l’en-tête d’acceptation durable qu’un proxy inverse peut exiger. Interrogation et webhook s’excluent mutuellement selon la documentation de Zalo elle-même. Le texte et les médias sont pris en charge ; les réactions, les fils, les sondages et les commandes natives ne le sont pas, et l’extension déclare la capacité de streaming par blocs sans les réglages de sortie que certains autres canaux régionaux possèdent. Quand le bot ne répond pas, vérifiez le jeton avec la sonde, l’approbation de l’expéditeur, et les journaux ; quand le webhook ne reçoit rien, vérifiez le HTTPS, la longueur du secret, l’accessibilité du chemin, que l’interrogation ne tourne pas aussi, et reculez après une rafale de 429. OpenClaw sur Telegram est le jumeau le plus proche par la forme, un jeton de bot et un choix entre interrogation et webhook.

Sur Diali

Zalo ne fait pas partie des canaux que Diali connecte aujourd’hui : ceux que nous faisons tourner sont WhatsApp, Telegram, Discord, Slack, Mattermost, Matrix, SMS et la voix, et une instance autogérée est là où vit cette extension pour l’instant. Connecter votre premier canal en cinq minutes montre notre flux de connexion, OpenClaw hébergé sur Diali est l’assistant et La sécurité chez Diali décrit la frontière.

• Intégré, expérimental, messages directs et groupes filtrés par mention.
• Interrogation longue par défaut ; sinon un webhook HTTPS avec un 200 durable.
• Bots Bot Creator et Marketplace seulement, pas les comptes officiels.