Vai al contenuto principale
OpenClaw si connette a Zalo ClawBot tramite il Plugin esterno @zalo-platforms/openclaw-zaloclawbot elencato nel catalogo. L’accesso usa un codice QR di Zalo Mini App.

​
Compatibilità

Versione PluginVersione OpenClawnpm dist-tagStato
0.1.x>=2026.4.10latestAttivo / Beta

​
Prerequisiti

  • Node.js >= 22
  • OpenClaw deve essere installato (CLI openclaw disponibile).
  • Un account Zalo su un dispositivo mobile per scansionare il codice QR di accesso.

​
Installazione con onboard (consigliata)

Esegui la procedura guidata di configurazione iniziale di OpenClaw e scegli Zalo ClawBot dal menu dei canali: 
openclaw onboard
La procedura guidata installa il Plugin dal catalogo ufficiale (con integrità verificata), visualizza il QR di accesso direttamente nel terminale e completa il canale dopo che lo hai scansionato con l’app Zalo. Non sono necessari comandi aggiuntivi.

​
Installazione manuale

Per aggiungere il canale a un Gateway già configurato, segui questi passaggi:

​
1. Installa il Plugin

openclaw plugins install "@zalo-platforms/openclaw-zaloclawbot@0.1.4"
Usa la versione esatta fissata mostrata sopra (corrisponde alla voce del catalogo ufficiale), così OpenClaw verifica il pacchetto rispetto all’hash di integrità del catalogo durante l’installazione.

​
2. Abilita il Plugin nella configurazione

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

​
3. Genera il codice QR ed effettua l’accesso

openclaw channels login --channel openclaw-zaloclawbot
Scansiona il codice QR mostrato nel terminale usando l’app mobile Zalo, accetta i Termini di utilizzo dentro la Zalo Mini App e autorizza la sessione.

​
4. Riavvia il Gateway

openclaw gateway restart

​
Come funziona

A differenza del canale Zalo standard per sviluppatori, che richiede di registrare un tuo Zalo Official Account (OA) e incollare credenziali sviluppatore statiche, Zalo ClawBot opera come assistente personale vincolato al proprietario usando un’infrastruttura ufficiale condivisa:
  1. Configurazione sicura: Il codice QR rimanda a una Zalo Mini App sicura che associa un bot privato appena predisposto, sotto un OA ufficiale condiviso, direttamente al tuo Zalo User ID.
  2. Privacy vincolata al proprietario: Per progettazione, il bot è limitato a comunicare solo con il suo proprietario. I messaggi provenienti da altri utenti vengono scartati a livello di piattaforma, rendendo la connessione privata e sicura.
  3. Percorso API ufficiale: Il Plugin usa le API di Zalo Bot Platform invece di automazioni del browser o della sessione web.

​
Dietro le quinte

Il Plugin Zalo ClawBot comunica con le API Zalo tramite un ciclo persistente di messaggi in long-polling. Per mantenere un runtime pulito e leggero:
  • Le connessioni long-poll usano l’endpoint getUpdates.
  • I Webhook sono disabilitati per impostazione predefinita per le esecuzioni locali del Gateway desktop/terminale.
  • I messaggi vengono elaborati lato client e mappati direttamente al runtime del tuo agente locale.
Il Plugin esterno gestisce le credenziali del bot nella directory di stato di OpenClaw. Tratta tale directory come sensibile e includila nella stessa policy di controllo degli accessi e backup del resto dello stato di OpenClaw.

​
Risoluzione dei problemi

  • Timeout dell’accesso QR: Il token di accesso (zbsk) scade dopo 5 minuti per motivi di sicurezza. Se il codice QR scade prima che tu lo scansioni, riesegui semplicemente il comando di accesso per generarne uno nuovo.
  • Il Gateway non si carica: Assicurati che la versione host di OpenClaw sia 2026.4.10 o superiore. Le versioni precedenti non supportano il registro di installazione dei Plugin npm esterni.