​

Zalo Personal (onofficieel)

Waarschuwing: Dit is een onofficiële integratie en kan leiden tot schorsing/blokkering van het account. Gebruik op eigen risico.

​

Vereiste plugin

• Installeren via CLI: openclaw plugins install @openclaw/zalouser
• Of vanuit een broncheckout: openclaw plugins install ./extensions/zalouser
• Details: Plug-ins

​

Vereiste: zca-cli

• Controleren: zca --version
• Indien ontbrekend, installeer zca-cli (zie extensions/zalouser/README.md of de upstream zca-cli-documentatie).

​

Snelle installatie (beginner)

1. Installeer de plugin (zie hierboven).
2. Inloggen (QR, op de Gateway-machine):
   • openclaw channels login --channel zalouser
   • Scan de QR-code in de terminal met de Zalo-mobiele app.
3. Schakel het kanaal in:

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

4. Herstart de Gateway (of rond de onboarding af).
5. DM-toegang staat standaard op koppelen; keur de koppelingscode goed bij het eerste contact.

​

Wat het is

• Gebruikt zca listen om inkomende berichten te ontvangen.
• Gebruikt zca msg ... om antwoorden te verzenden (tekst/media/link).
• Ontworpen voor use-cases met een “persoonlijk account” waar de Zalo Bot API niet beschikbaar is.

​

Naamgeving

​

ID’s vinden (directory)

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

​

Beperkingen

• Uitgaande tekst wordt opgeknipt in ~2000 tekens (limieten van de Zalo-client).
• Streaming staat standaard uitgeschakeld.

​

Toegangsbeheer (DM’s)

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

​

Groepstoegang (optioneel)

• Standaard: channels.zalouser.groupPolicy = "open" (groepen toegestaan). Gebruik channels.defaults.groupPolicy om de standaard te overschrijven wanneer niet ingesteld.
• Beperk tot een toegestane lijst met:
  • channels.zalouser.groupPolicy = "allowlist"
  • channels.zalouser.groups (sleutels zijn groeps-ID’s of namen)
• Alle groepen blokkeren: channels.zalouser.groupPolicy = "disabled".
• De configuratiewizard kan vragen om groeps-allowlists.
• Bij het opstarten zet OpenClaw groeps-/gebruikersnamen in allowlists om naar ID’s en logt de mapping; niet-opgeloste items blijven zoals ingevoerd.

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

​

Meerdere accounts

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

​

Problemen oplossen

• Installeer zca-cli en zorg dat het zich op PATH bevindt voor het Gateway-proces.

• openclaw channels status --probe
• Opnieuw inloggen: openclaw channels logout --channel zalouser && openclaw channels login --channel zalouser