​

Zalo Personnel (non officiel)

Avertissement : Il s’agit d’une intégration non officielle et elle peut entraîner la suspension ou le bannissement du compte. Utilisez-la à vos propres risques.

​

Plugin inclus

• Installer via la CLI : openclaw plugins install @openclaw/zalouser
• Ou depuis une extraction des sources : openclaw plugins install ./path/to/local/zalouser-plugin
• Détails : Plugins

​

Configuration rapide (débutant)

1. Assurez-vous que le plugin Zalo Personnel est disponible.
   • Les versions empaquetées actuelles d’OpenClaw l’incluent déjà.
   • Les installations anciennes/personnalisées peuvent l’ajouter manuellement avec les commandes ci-dessus.
2. Connectez-vous (QR, sur la machine Gateway) :
   • openclaw channels login --channel zalouser
   • Scannez le code QR avec l’application mobile Zalo.
3. Activez le canal :

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

4. Redémarrez la Gateway (ou terminez la configuration).
5. L’accès par message privé utilise par défaut l’appairage ; approuvez le code d’appairage lors du premier contact.

​

Ce que c’est

• Fonctionne entièrement dans le processus via zca-js.
• Utilise des écouteurs d’événements natifs pour recevoir les messages entrants.
• Envoie les réponses directement via l’API JS (texte/média/lien).
• Conçu pour les cas d’usage « compte personnel » où l’API Bot Zalo n’est pas disponible.

​

Nommage

​

Trouver des identifiants (répertoire)

openclaw directory self --channel zalouser
openclaw directory peers list --channel zalouser --query "name"
openclaw directory groups list --channel zalouser --query "work"

​

Limites

• Le texte sortant est découpé en blocs d’environ 2000 caractères (limites du client Zalo).
• Le streaming est bloqué par défaut.

​

Contrôle d’accès (messages privés)

• openclaw pairing list zalouser
• openclaw pairing approve zalouser <code>

​

Accès aux groupes (facultatif)

• Par défaut : channels.zalouser.groupPolicy = "open" (groupes autorisés). Utilisez channels.defaults.groupPolicy pour remplacer la valeur par défaut lorsqu’elle n’est pas définie.
• Limitez à une liste d’autorisation avec :
  • channels.zalouser.groupPolicy = "allowlist"
  • channels.zalouser.groups (les clés doivent être des identifiants de groupe stables ; les noms sont résolus en identifiants au démarrage lorsque c’est possible)
  • channels.zalouser.groupAllowFrom (contrôle quels expéditeurs, dans les groupes autorisés, peuvent déclencher le bot)
• Bloquez tous les groupes : channels.zalouser.groupPolicy = "disabled".
• L’assistant de configuration peut demander des listes d’autorisation de groupes.
• Au démarrage, OpenClaw résout les noms de groupe/utilisateur dans les listes d’autorisation en identifiants et journalise la correspondance.
• La correspondance avec la liste d’autorisation de groupes se fait par identifiant uniquement par défaut. Les noms non résolus sont ignorés pour l’authentification, sauf si channels.zalouser.dangerouslyAllowNameMatching: true est activé.
• channels.zalouser.dangerouslyAllowNameMatching: true est un mode de compatibilité de dernier recours qui réactive la correspondance avec des noms de groupe modifiables.
• Si groupAllowFrom n’est pas défini, le runtime revient à allowFrom pour les vérifications d’expéditeur dans les groupes.
• Les vérifications d’expéditeur s’appliquent à la fois aux messages de groupe normaux et aux commandes de contrôle (par exemple /new, /reset).

{
  channels: {
    zalouser: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["1471383327500481391"],
      groups: {
        "123456789": { allow: true },
        "Work Chat": { allow: true },
      },
    },
  },
}

​

Contrôle des mentions dans les groupes

• channels.zalouser.groups.<group>.requireMention contrôle si les réponses dans les groupes nécessitent une mention.
• Ordre de résolution : identifiant/nom exact du groupe -> slug de groupe normalisé -> * -> valeur par défaut (true).
• Cela s’applique à la fois aux groupes de la liste d’autorisation et au mode groupe ouvert.
• Citer un message du bot compte comme une mention implicite pour l’activation dans le groupe.
• Les commandes de contrôle autorisées (par exemple /new) peuvent contourner l’exigence de mention.
• Lorsqu’un message de groupe est ignoré parce qu’une mention est requise, OpenClaw le stocke comme historique de groupe en attente et l’inclut dans le prochain message de groupe traité.
• La limite d’historique de groupe utilise par défaut messages.groupChat.historyLimit (repli : 50). Vous pouvez la remplacer par compte avec channels.zalouser.historyLimit.

{
  channels: {
    zalouser: {
      groupPolicy: "allowlist",
      groups: {
        "*": { allow: true, requireMention: true },
        "Work Chat": { allow: true, requireMention: false },
      },
    },
  },
}

​

Multi-compte

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

​

Saisie, réactions et accusés de réception

• OpenClaw envoie un événement de saisie avant de transmettre une réponse (au mieux).
• L’action de réaction aux messages react est prise en charge pour zalouser dans les actions de canal.
  • Utilisez remove: true pour supprimer un emoji de réaction spécifique d’un message.
  • Sémantique des réactions : Réactions
• Pour les messages entrants qui incluent des métadonnées d’événement, OpenClaw envoie des accusés de réception « livré » et « vu » (au mieux).

​

Dépannage

• openclaw channels status --probe
• Reconnectez-vous : openclaw channels logout --channel zalouser && openclaw channels login --channel zalouser

• Utilisez des identifiants numériques dans allowFrom/groupAllowFrom/groups, ou les noms exacts d’amis/groupes.

• Supprimez toute hypothèse concernant un ancien processus externe zca.
• Le canal fonctionne désormais entièrement dans OpenClaw sans binaires CLI externes.

​

Lié

• Vue d’ensemble des canaux — tous les canaux pris en charge
• Appairage — authentification par message privé et flux d’appairage
• Groupes — comportement du chat de groupe et contrôle des mentions
• Routage des canaux — routage des sessions pour les messages
• Sécurité — modèle d’accès et durcissement