Zalo ClawBot

OpenClaw maakt verbinding met Zalo ClawBot via de in de catalogus vermelde externe @zalo-platforms/openclaw-zaloclawbot Plugin. Inloggen gebruikt een Zalo Mini App-QR- code.

Compatibiliteit

Vereisten

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

Installeren met onboard (aanbevolen)

Voer de OpenClaw-onboardingwizard uit en kies Zalo ClawBot uit het kanaalmenu:

openclaw onboard

De wizard installeert de Plugin vanuit de officiële catalogus (met integriteitscontrole), toont de inlog-QR direct in de terminal en rondt het kanaal af zodra je deze met de Zalo-app scant. Er zijn geen extra opdrachten nodig.

Handmatige installatie

Volg deze stappen om het kanaal toe te voegen aan een Gateway die al is geonboard:

1. Installeer de Plugin

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

Gebruik de exacte vastgezette versie die hierboven wordt weergegeven (deze komt overeen met de officiële catalogusvermelding), zodat OpenClaw het pakket tijdens de installatie verifieert aan de hand van de integriteitshash van 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 log in

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. Herstart de Gateway

openclaw gateway restart

Hoe het werkt

In tegenstelling tot het standaard ontwikkelaarskanaal van Zalo, waarvoor je je eigen Zalo Official Account (OA) moet registreren en statische ontwikkelaarsreferenties moet plakken, werkt Zalo ClawBot als een eigenaarsgebonden persoonlijke assistent via gedeelde, officiële infrastructuur:

1. Veilige onboarding: De QR-code verwijst naar een veilige Zalo Mini App die een nieuw ingerichte, private bot onder een gedeelde officiële OA rechtstreeks aan je Zalo User ID koppelt.
2. Eigenaarsgebonden privacy: Het ontwerp beperkt de bot tot communicatie alleen met de eigenaar. Berichten van andere gebruikers worden op platformniveau geweigerd, waardoor de verbinding privé en veilig blijft.
3. Officieel API-pad: De Plugin gebruikt Zalo Bot Platform-API’s in plaats van browser- of websessieautomatisering.

Onder de motorkap

De Zalo ClawBot-Plugin communiceert met Zalo-API’s via een persistente long-polling-berichtlus. Om een schone en lichte runtime te behouden:

• Long-poll-verbindingen gebruiken het getUpdates-endpoint.
• Webhooks zijn standaard uitgeschakeld voor lokale desktop-/terminal-Gateway-runs.
• Berichten worden client-side verwerkt en rechtstreeks toegewezen aan je lokale agentruntime.

De externe Plugin beheert botreferenties onder de OpenClaw-statusmap. Behandel die map als gevoelig en neem deze op in hetzelfde toegangscontrole- en back-upbeleid als de rest van je OpenClaw-status.

Probleemoplossing

• Time-out bij QR-login: Het logintoken (zbsk) verloopt om veiligheidsredenen na 5 minuten. Als de QR-code verloopt voordat je deze scant, voer je simpelweg de loginopdracht opnieuw uit om een nieuwe te genereren.
• Gateway kan niet laden: Zorg ervoor dat je OpenClaw-hostversie 2026.4.10 of hoger is. Oudere versies ondersteunen het installatieregister voor externe npm-Plugins niet.