Zalo ClawBot

OpenClaw maakt verbinding met Zalo ClawBot via de in de catalogus vermelde externe Plugin @zalo-platforms/openclaw-zaloclawbot. Voor het aanmelden wordt een QR-code van een Zalo Mini App gebruikt; de Plugin-id in de configuratie is openclaw-zaloclawbot.

Compatibiliteit

Vereisten

• Node.js >= 22
• OpenClaw geïnstalleerd (openclaw-CLI beschikbaar)
• Een Zalo-account op een mobiel apparaat om de QR-code voor aanmelding te scannen

Installeren via onboarding (aanbevolen)

openclaw onboard

Kies Zalo ClawBot in het kanalenmenu. De wizard installeert de Plugin vanuit de officiële catalogus (met integriteitscontrole), toont de QR-code voor aanmelding in de terminal en voltooit de configuratie van het kanaal zodra u deze met de Zalo-app scant.

Handmatige installatie

Zo voegt u het kanaal toe aan een Gateway waarvoor de onboarding al is voltooid:

1. Installeer de Plugin

openclaw plugins install "@zalo-platforms/openclaw-zaloclawbot@0.1.4"

Gebruik exact de vastgezette versie, zodat OpenClaw het pakket tijdens de installatie kan verifiëren aan de hand van de integriteitshash in de catalogus.

2. Schakel de Plugin in de configuratie in

openclaw config set plugins.entries.openclaw-zaloclawbot.enabled true

3. Genereer een QR-code en meld u aan

openclaw channels login --channel openclaw-zaloclawbot

Scan de in de terminal weergegeven QR-code met de mobiele Zalo-app, accepteer de Terms of Use in de Zalo Mini App en autoriseer de sessie.

4. Start de Gateway opnieuw

openclaw gateway restart

Werking

In tegenstelling tot het standaard Zalo-kanaal, waarvoor u uw eigen Zalo Official Account (OA) moet registreren en statische ontwikkelaarsreferenties moet configureren, is Zalo ClawBot een aan de eigenaar gebonden persoonlijke assistent op gedeelde officiële infrastructuur:

1. Onboarding: de QR-code verwijst naar een Zalo Mini App die een nieuw ingerichte privébot onder een gedeeld officieel OA rechtstreeks aan uw Zalo-gebruikers-id koppelt.
2. Aan de eigenaar gebonden privacy: de bot communiceert uitsluitend met de eigenaar. Berichten van andere gebruikers worden op platformniveau genegeerd.
3. Officiële API-route: de Plugin gebruikt API's van het Zalo Bot Platform, geen automatisering van browsers of websessies.

Onder de motorkap

De Plugin communiceert met Zalo via een permanente long-pollinglus (getUpdates). Webhooks zijn standaard uitgeschakeld wanneer de Gateway lokaal vanaf een desktop of terminal wordt uitgevoerd. Berichten worden aan de clientzijde verwerkt en aan de runtime van uw lokale agent gekoppeld.

De Plugin beheert botreferenties in de OpenClaw-statusmap. Behandel die map als gevoelig en pas daarop hetzelfde beleid voor toegangsbeheer en back-ups toe als op de rest van de OpenClaw-status.

De runtime van deze Plugin bevindt zich volledig in het externe pakket @zalo-platforms/openclaw-zaloclawbot; de onderstaande details over het gedrag, afgezien van installatie en configuratie, zijn zoals gerapporteerd door de beheerders van de Plugin en zijn niet geverifieerd aan de hand van de broncode van de OpenClaw-kern.

Probleemoplossing

• Time-out bij aanmelden via QR-code: het aanmeldingstoken (zbsk) verloopt om veiligheidsredenen na 5 minuten. Als de QR-code verloopt voordat u deze scant, voert u de aanmeldopdracht opnieuw uit om een nieuwe te genereren.
• Gateway kan niet worden geladen: controleer of de versie van uw OpenClaw-host 2026.4.10 of hoger is. Oudere versies ondersteunen het installatieregister voor externe npm-Plugins dat voor deze id vereist is niet.

Gerelateerd

• Overzicht van kanalen - alle ondersteunde kanalen
• Zalo - het gebundelde kanaal voor Zalo Bot Creator / Marketplace
• Koppelen - DM-authenticatie en koppelingsprocedure
• Plugins - Plugins installeren en beheren