Zalo persoonlijk

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Gebundelde plugin

• Installeren via CLI: openclaw plugins install @openclaw/zalouser
• Of vanuit een source-checkout: openclaw plugins install ./path/to/local/zalouser-plugin
• Details: Plugins

​

Snelle configuratie (beginner)

1. Zorg dat de Zalo Personal-plugin beschikbaar is.
   • Huidige verpakte OpenClaw-releases bundelen deze al.
   • Oudere/aangepaste installaties kunnen deze handmatig toevoegen met de bovenstaande commando’s.
2. Log in (QR, op de Gateway-machine):
   • openclaw channels login --channel zalouser
   • Scan de QR-code met de mobiele Zalo-app.
3. Schakel het kanaal in:

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

4. Herstart de Gateway (of rond de configuratie af).
5. DM-toegang gebruikt standaard koppelen; keur de koppelcode goed bij het eerste contact.

​

Wat het is

• Draait volledig in-process via zca-js.
• Gebruikt native event listeners om inkomende berichten te ontvangen.
• Verstuurt antwoorden rechtstreeks via de JS API (tekst/media/link).
• Ontworpen voor gebruikssituaties met een “persoonlijk account” waarin 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"

​

Limieten

• Uitgaande tekst wordt opgesplitst in stukken van ongeveer 2000 tekens (Zalo-clientlimieten).
• Streaming is standaard geblokkeerd.

​

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 deze niet is ingesteld.
• Beperk tot een allowlist met:
  • channels.zalouser.groupPolicy = "allowlist"
  • channels.zalouser.groups (sleutels moeten stabiele groeps-ID’s zijn; namen worden bij het opstarten waar mogelijk naar ID’s omgezet)
  • channels.zalouser.groupAllowFrom (bepaalt welke afzenders in toegestane groepen de bot kunnen activeren)
• Alle groepen blokkeren: channels.zalouser.groupPolicy = "disabled".
• De configuratiewizard kan om allowlists voor groepen vragen.
• Bij het opstarten zet OpenClaw groeps-/gebruikersnamen in allowlists om naar ID’s en logt de mapping.
• Matching van groeps-allowlists is standaard alleen op ID. Niet-opgeloste namen worden genegeerd voor auth, tenzij channels.zalouser.dangerouslyAllowNameMatching: true is ingeschakeld.
• channels.zalouser.dangerouslyAllowNameMatching: true is een break-glass-compatibiliteitsmodus die matching op veranderlijke groepsnamen opnieuw inschakelt.
• Als groupAllowFrom niet is ingesteld, valt runtime terug op allowFrom voor controles van groepsafzenders.
• Afzendercontroles zijn van toepassing op zowel normale groepsberichten als controlecommando’s (bijvoorbeeld /new, /reset).

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

​

Groepsvermeldingsgating

• channels.zalouser.groups.<group>.requireMention bepaalt of groepsantwoorden een vermelding vereisen.
• Volgorde van resolving: exacte groeps-id/naam -> genormaliseerde groeps-slug -> * -> standaard (true).
• Dit geldt zowel voor groepen op de allowlist als voor open groepsmodus.
• Het citeren van een botbericht telt als een impliciete vermelding voor groepsactivatie.
• Geautoriseerde controlecommando’s (bijvoorbeeld /new) kunnen vermeldingsgating omzeilen.
• Wanneer een groepsbericht wordt overgeslagen omdat een vermelding vereist is, slaat OpenClaw het op als wachtende groepsgeschiedenis en neemt het mee in het volgende verwerkte groepsbericht.
• De limiet voor groepsgeschiedenis is standaard messages.groupChat.historyLimit (fallback 50). Je kunt dit per account overschrijven met channels.zalouser.historyLimit.

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

​

Meerdere accounts

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

​

Typen, reacties en afleverbevestigingen

• OpenClaw verstuurt een typing-event voordat een antwoord wordt verzonden (best-effort).
• Berichtreactieactie react wordt ondersteund voor zalouser in kanaalacties.
  • Gebruik remove: true om een specifieke reactie-emoji van een bericht te verwijderen.
  • Reactiesemantiek: Reacties
• Voor inkomende berichten die eventmetadata bevatten, verstuurt OpenClaw delivered- en seen-bevestigingen (best-effort).

​

Problemen oplossen

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

• Gebruik numerieke ID’s in allowFrom/groupAllowFrom/groups, of exacte vriend-/groepsnamen.

• Verwijder aannames over oude externe zca-processen.
• Het kanaal draait nu volledig in OpenClaw zonder externe CLI-binaries.

​

Gerelateerd

• Kanalenoverzicht — alle ondersteunde kanalen
• Koppelen — DM-authenticatie en koppelingsflow
• Groepen — gedrag van groepschats en vermeldingsgating
• Kanaalroutering — sessieroutering voor berichten
• Beveiliging — toegangsmodel en hardening