Zalo ClawBot

OpenClaw maakt verbinding met Zalo ClawBot via de externe @zalo-platforms/openclaw-zaloclawbot-plugin die in de catalogus staat. 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 het aanmelden te scannen

Installeren met onboard (aanbevolen)

openclaw onboard

Kies Zalo ClawBot in het kanaalmenu. De wizard installeert de plugin vanuit de officiële catalogus (met integriteitsverificatie), geeft de QR-code voor het aanmelden weer in de terminal en voltooit de configuratie van het kanaal zodra je deze met de Zalo-app scant.

Handmatige installatie

Zo voeg je het kanaal toe aan een Gateway waarvoor onboard al is uitgevoerd:

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 je aan

openclaw channels login --channel openclaw-zaloclawbot

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

4. Start de Gateway opnieuw

openclaw gateway restart

Hoe het werkt

Anders dan bij het standaard Zalo-kanaal, waarvoor je jouw eigen Zalo Official Account (OA) moet registreren en statische ontwikkelaarsreferenties moet configureren, is Zalo ClawBot een persoonsgebonden persoonlijke assistent op gedeelde officiële infrastructuur:

1. Onboarding: de QR-code verwijst naar een Zalo Mini App die een nieuw aangemaakte privébot onder een gedeeld officieel OA rechtstreeks aan jouw Zalo-gebruikers-ID koppelt.
2. Persoonsgebonden privacy: de bot communiceert alleen met de eigenaar. Berichten van andere gebruikers worden op platformniveau geweigerd.
3. Officiële API-route: de plugin gebruikt API's van het Zalo Bot Platform en geen automatisering via een browser of websessie.

Onder de motorkap

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

De plugin beheert botreferenties in de OpenClaw-statusmap. Behandel die map als gevoelig en pas er hetzelfde toegangsbeheer- en back-upbeleid op toe als op de rest van de OpenClaw-status.

De runtime van deze plugin bevindt zich volledig in het externe @zalo-platforms/openclaw-zaloclawbot-pakket; de onderstaande gedragsdetails die verder gaan dan installatie en configuratie zijn afkomstig van de beheerders van de plugin en zijn niet geverifieerd aan de hand van de broncode van OpenClaw-core.

Problemen oplossen

• Time-out bij aanmelden via QR-code: het aanmeldingstoken (zbsk) verloopt om veiligheidsredenen na 5 minuten. Als de QR-code verloopt voordat je deze scant, voer je de aanmeldingsopdracht opnieuw uit om een nieuwe te genereren.
• Gateway kan niet worden geladen: controleer of de versie van je OpenClaw-host 2026.4.10 of hoger is. Oudere versies ondersteunen het register voor installaties van 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 koppelingsflow
• Plugins - plugins installeren en beheren