Quelle est la difference entre Zalo et Zalo Personal ?

Le canal Zalo utilise l'API officielle de la plateforme Zalo Bot avec un Bot Token : c'est sur, stable, mais limite (pas de discussions de groupe). Zalo Personal utilise l'outil non officiel zca-cli avec un veritable compte personnel : il prend en charge les discussions de groupe et les medias, mais comporte un risque de bannissement du compte puisqu'il utilise une automatisation non officielle.

Mon compte Zalo personnel peut-il etre banni ?

Oui. Cette integration utilise un outil non officiel (zca-cli) pour automatiser un compte personnel. Zalo peut detecter cela comme une automatisation non autorisee et suspendre ou bannir le compte. Utilisez un compte secondaire dedie plutot que votre compte personnel principal.

Zalo Personal prend-il en charge les discussions de groupe ?

Oui. Contrairement a l'integration via la plateforme Zalo Bot, Zalo Personal prend entierement en charge les discussions de groupe. La politique groupPolicy par defaut est 'open' (repond dans tous les groupes). Vous pouvez restreindre a des groupes specifiques avec 'allowlist' ou desactiver les reponses de groupe avec 'disabled'.

Comment trouver les identifiants de groupe pour la liste d'autorisation ?

Utilisez 'openclaw directory groups list --channel zalouser --query "terme de recherche"' pour rechercher des groupes par nom. La commande renverra les identifiants de groupe que vous pouvez utiliser dans la configuration groups. Vous pouvez egalement referencer les groupes par leur nom exact.

Ai-je besoin d'un Bot Token pour Zalo Personal ?

Non. Zalo Personal s'authentifie via le scan d'un QR code : aucun API Token ni Bot Token n'est necessaire. Executez simplement 'openclaw channels login --channel zalouser' et scannez le QR code avec votre application mobile Zalo.

Puis-je utiliser Zalo et Zalo Personal en meme temps ?

Oui. Ce sont des canaux distincts avec des identifiants differents (zalo et zalouser). Vous pouvez activer les deux dans votre configuration. Le canal Zalo utilise un compte bot tandis que Zalo Personal utilise votre compte personnel.

OpenClaw GuideOpenClaw

Commencer

Canal Zalo Personal OpenClaw

Messagerie

Moyen

Connectez OpenClaw a votre compte Zalo personnel a l'aide de l'outil non officiel zca-cli. Contrairement a l'integration via la plateforme Zalo Bot, ce canal permet a votre assistant IA de fonctionner via un veritable compte Zalo personnel, avec prise en charge des discussions de groupe, des medias et des listes d'amis. L'authentification se fait en scannant un QR code, comme pour associer un nouvel appareil.

Info rapide

DifficultéMoyen

CatégorieMessagerie

Fonctionnalités prises en charge3 / 6

Zalo Personal Fonctionnalités prises en charge

Messages texte

Pris en charge

Médias et fichiers

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

Pris en charge

Zalo Personal Prérequis

Un compte Zalo personnel (compte standard, pas un Official Account)
Le binaire zca installe et accessible dans le PATH de votre systeme
OpenClaw Gateway en cours d'execution et configure
L'application mobile Zalo pour scanner le QR code lors de la connexion

Zalo Personal Configuration rapide

Installer le plugin zalouser et zca-cli

Installez le plugin OpenClaw avec 'openclaw plugins install @openclaw/zalouser'. Ensuite, installez l'outil zca-cli et assurez-vous qu'il est dans votre PATH. Verifiez avec 'zca --version'.

Se connecter via QR code

Executez 'openclaw channels login --channel zalouser' pour afficher un QR code dans votre terminal. Ouvrez l'application Zalo sur votre telephone et scannez le QR code pour authentifier la session.

Configurer et commencer a discuter

Ajoutez la configuration du canal zalouser dans ~/.openclaw/openclaw.json avec vos preferences dmPolicy et groupPolicy. Demarrez le Gateway avec 'openclaw start' et envoyez un message a votre compte Zalo pour tester.

Zalo Personal Exemple de configuration

config.json

{
  "channels": {
    "zalouser": {
      "enabled": true,
      "dmPolicy": "pairing",
      "groupPolicy": "open"
    }
  }
}

Zalo Personal Documentation Détaillée

Vue d'ensemble de l'architecture

OpenClaw se connecte a Zalo via l'outil zca-cli, un client en ligne de commande non officiel pour les comptes Zalo personnels. Contrairement a l'integration via la plateforme Zalo Bot (qui utilise des API HTTP), ce canal utilise le binaire zca pour ecouter les messages entrants et envoyer les reponses sortantes. Le Gateway execute 'zca listen' en tant que processus d'arriere-plan pour recevoir les messages en temps reel, et utilise 'zca msg' pour envoyer les reponses. Cette approche fonctionne entierement en local : aucune URL publique, aucun Webhook ni certificat HTTPS n'est necessaire. Puisqu'il s'agit d'un compte personnel, le bot peut participer aux discussions de groupe, acceder aux listes d'amis et envoyer des medias, des fonctionnalites non disponibles via la plateforme Bot officielle.

Il s'agit d'une integration non officielle. Son utilisation peut entrainer la suspension ou le bannissement de votre compte Zalo. Utilisez un compte dedie plutot que votre compte personnel principal.

L'outil zca-cli gere la couche protocolaire. Maintenez-le a jour pour assurer la compatibilite avec le service Zalo.

Ceci est une integration experimentale utilisant un outil non officiel. Zalo peut suspendre ou bannir les comptes utilisant des automatisations tierces. Utilisation a vos propres risques.

Installation de zca-cli

Le binaire zca-cli est un prerequis pour ce canal. Il doit etre installe et accessible dans le PATH de votre systeme avant que le Gateway puisse utiliser le canal Zalo Personal. Apres l'installation, verifiez son bon fonctionnement en executant 'zca --version' dans votre terminal. Si la commande est introuvable, verifiez la configuration de votre PATH ou reinstallez l'outil.

terminal

zca --version

Si zca est installe mais absent du PATH, vous pouvez ajouter son repertoire a votre PATH dans le profil de votre shell (~/.bashrc, ~/.zshrc, etc.).

Authentification par QR Code

L'authentification se fait en scannant un QR code avec votre application mobile Zalo, de maniere similaire a l'association d'un nouvel appareil. Aucun API Token ni Bot Token n'est necessaire. Executez la commande de connexion pour afficher le QR code dans votre terminal. Ouvrez Zalo sur votre telephone, accedez au scanner QR et scannez le code. La session sera etablie et les identifiants stockes localement. Si la connexion ne persiste pas apres un redemarrage, essayez de vous deconnecter puis de vous reconnecter pour actualiser la session.

terminal

# Login
openclaw channels login --channel zalouser

# If login doesn't persist, re-authenticate
openclaw channels logout --channel zalouser
openclaw channels login --channel zalouser

Gardez votre telephone connecte a Internet pendant le scan du QR code. La session est validee via les serveurs de Zalo.

Politiques de messages prives

Les politiques de DM (messages prives) controlent qui peut interagir avec votre assistant IA via des messages prives. OpenClaw prend en charge quatre politiques : • pairing (par defaut) — Les nouveaux contacts recoivent un code d'appairage lors de leur premier message. Approuvez-les via 'openclaw pairing approve zalouser <code>'. Les codes expirent apres 1 heure. • allowlist — Seuls les identifiants ou noms d'utilisateurs listes dans allowFrom peuvent envoyer des messages au bot. Les noms sont resolus en identifiants via 'zca friend find'. • open — Toute personne envoyant un message au compte recoit une reponse. • disabled — La gestion des messages prives est completement desactivee.

openclaw.json

{
  "channels": {
    "zalouser": {
      "dmPolicy": "allowlist",
      "allowFrom": ["123456789", "Friend Name"]
    }
  }
}

La politique 'open' permet a n'importe qui d'interagir avec votre compte personnel. Comme il s'agit d'un veritable compte Zalo visible par vos contacts, utilisez-la avec precaution.

Gestion des discussions de groupe

Contrairement a l'integration via la plateforme Zalo Bot, Zalo Personal prend entierement en charge les discussions de groupe. Par defaut, groupPolicy est defini sur 'open', ce qui signifie que le bot repondra dans toutes les conversations de groupe. Vous pouvez restreindre l'acces aux groupes en utilisant la politique 'allowlist' avec un mapping groups. Les groupes peuvent etre references par leur identifiant numerique ou par leur nom. Definissez groupPolicy sur 'disabled' pour ignorer completement tous les messages de groupe.

openclaw.json

{
  "channels": {
    "zalouser": {
      "groupPolicy": "allowlist",
      "groups": {
        "123456789": { "allow": true },
        "Work Chat": { "allow": true }
      }
    }
  }
}

Utilisez 'openclaw directory groups list --channel zalouser --query "name"' pour trouver les identifiants et noms des groupes.

Les noms de groupe sont sensibles a la casse. Utilisez le nom exact tel qu'il apparait dans votre application Zalo.

Gestion des messages

OpenClaw prend en charge l'envoi de messages texte, d'images, de fichiers et de liens via Zalo Personal. Les messages texte sont automatiquement decoupes a environ 2 000 caracteres pour respecter les limites du client Zalo. Les messages entrants des contacts et des groupes sont recus via le processus 'zca listen' et transmis a l'IA. Les reponses sortantes sont envoyees avec 'zca msg'. Les reponses en streaming sont bloquees par defaut en raison de la contrainte de limite de caracteres.

Les longues reponses de l'IA sont automatiquement decoupees en plusieurs messages a la limite d'environ 2 000 caracteres.

Les capacites d'envoi de medias dependent de la version de zca-cli installee. Maintenez-le a jour pour une compatibilite optimale.

Configuration multi-comptes

OpenClaw prend en charge l'execution simultanee de plusieurs comptes Zalo personnels en les associant a differents profils zca. Chaque compte possede son propre nom de profil, sa politique de DM et ses parametres de groupe. Cela est utile si vous souhaitez executer des assistants IA distincts pour differents usages, par exemple un compte professionnel et un compte personnel.

openclaw.json

{
  "channels": {
    "zalouser": {
      "enabled": true,
      "defaultAccount": "default",
      "accounts": {
        "work": {
          "enabled": true,
          "profile": "work"
        },
        "personal": {
          "enabled": true,
          "profile": "personal"
        }
      }
    }
  }
}

Annuaire et decouverte

Le canal Zalo Personal fournit des commandes d'annuaire pour decouvrir les amis et les groupes de votre compte. Elles sont utiles pour trouver les identifiants d'utilisateurs pour les listes d'autorisation ou les identifiants de groupes pour les politiques de groupe. Vous pouvez consulter votre propre profil, rechercher des amis par nom et rechercher des groupes par nom, le tout depuis la ligne de commande.

terminal

# View your profile
openclaw directory self --channel zalouser

# Search friends
openclaw directory peers list --channel zalouser --query "name"

# Search groups
openclaw directory groups list --channel zalouser --query "work"

Zalo Personal Référence de Configuration

Key	Type	Default	Description
enabled	boolean	false	Activer ou desactiver le canal Zalo Personal
dmPolicy	string	"pairing"	Controle qui peut envoyer des messages prives au bot. Options : pairing, allowlist, open, disabled
allowFrom	string[]	[]	Identifiants ou noms d'utilisateurs autorises a envoyer des messages au bot (lorsque dmPolicy est allowlist)
groupPolicy	string	"open"	Controle le comportement des discussions de groupe. Options : open, allowlist, disabled
groups	object	{}	Mapping des identifiants ou noms de groupes vers des objets de permission (lorsque groupPolicy est allowlist)
defaultAccount	string	"default"	Le nom du profil zca par defaut a utiliser
accounts.<id>.enabled	boolean	true	Activer ou desactiver un compte specifique en mode multi-comptes
accounts.<id>.profile	string	""	Le nom du profil zca pour un compte specifique

enabled

Type: booleanDefault: false

Activer ou desactiver le canal Zalo Personal

dmPolicy

Type: stringDefault: "pairing"

Controle qui peut envoyer des messages prives au bot. Options : pairing, allowlist, open, disabled

allowFrom

Type: string[]Default: []

Identifiants ou noms d'utilisateurs autorises a envoyer des messages au bot (lorsque dmPolicy est allowlist)

groupPolicy

Type: stringDefault: "open"

Controle le comportement des discussions de groupe. Options : open, allowlist, disabled

groups

Type: objectDefault: {}

Mapping des identifiants ou noms de groupes vers des objets de permission (lorsque groupPolicy est allowlist)

defaultAccount

Type: stringDefault: "default"

Le nom du profil zca par defaut a utiliser

accounts.<id>.enabled

Type: booleanDefault: true

Activer ou desactiver un compte specifique en mode multi-comptes

accounts.<id>.profile

Type: stringDefault: ""

Le nom du profil zca pour un compte specifique

Zalo Personal Questions Fréquentes

Zalo Personal Dépannage

Commande zca introuvable

Le binaire zca-cli n'est pas installe ou n'est pas dans le PATH de votre systeme.

Installez zca-cli et assurez-vous qu'il est dans votre PATH. Verifiez avec 'zca --version'. S'il est installe mais introuvable, ajoutez son repertoire d'installation a votre PATH dans ~/.bashrc ou ~/.zshrc.

La connexion par QR code echoue ou la session ne persiste pas

La session Zalo a peut-etre expire ou l'authentification initiale etait incomplete.

Essayez de vous deconnecter puis de vous reconnecter : 'openclaw channels logout --channel zalouser' puis 'openclaw channels login --channel zalouser'. Assurez-vous que votre telephone dispose d'une connexion Internet stable pendant le scan du QR code.

Le bot ne repond pas aux messages de groupe

groupPolicy est peut-etre defini sur 'disabled' ou sur 'allowlist' sans que le groupe soit liste.

Verifiez votre parametre groupPolicy. Si vous utilisez 'allowlist', assurez-vous que l'identifiant ou le nom du groupe est liste dans la configuration groups. Utilisez 'openclaw directory groups list --channel zalouser' pour trouver le bon identifiant de groupe.

Les messages ne sont pas recus

Le processus zca listen n'est peut-etre pas en cours d'execution, ou la session a expire.

Executez 'openclaw channels status --probe' pour diagnostiquer la connexion. Si la session a expire, re-authentifiez-vous via la connexion par QR code. Consultez les logs du Gateway pour les messages d'erreur specifiques.

Le compte a ete suspendu ou banni

Zalo a detecte une automatisation non officielle sur le compte.

C'est un risque connu lie a l'utilisation d'integrations non officielles. Contactez le support Zalo pour tenter de recuperer le compte. Envisagez de passer a l'integration officielle via la plateforme Zalo Bot (canal zalo) qui ne presente aucun risque de bannissement, bien qu'elle ne prenne pas en charge les discussions de groupe.

Voir la documentation complète Retour à tous les canaux