​

Zalo Personal (non ufficiale)

Avviso: Questa è un’integrazione non ufficiale e può comportare la sospensione o il ban dell’account. Usala a tuo rischio.

​

Plugin incluso

• Installa tramite CLI: openclaw plugins install @openclaw/zalouser
• Oppure da un checkout dei sorgenti: openclaw plugins install ./path/to/local/zalouser-plugin
• Dettagli: Plugin

​

Configurazione rapida (principianti)

1. Assicurati che il plugin Zalo Personal sia disponibile.
   • Le attuali release pacchettizzate di OpenClaw lo includono già.
   • Le installazioni meno recenti o personalizzate possono aggiungerlo manualmente con i comandi sopra.
2. Accedi (QR, sulla macchina Gateway):
   • openclaw channels login --channel zalouser
   • Scansiona il codice QR con l’app mobile Zalo.
3. Abilita il canale:

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

4. Riavvia il Gateway (oppure completa la configurazione).
5. L’accesso DM usa pairing come impostazione predefinita; approva il codice di pairing al primo contatto.

​

Che cos’è

• Funziona interamente in-process tramite zca-js.
• Usa listener di eventi nativi per ricevere i messaggi in ingresso.
• Invia le risposte direttamente tramite l’API JS (testo/media/link).
• Progettato per casi d’uso con “account personale” in cui l’API Bot di Zalo non è disponibile.

​

Denominazione

​

Trovare gli ID (directory)

openclaw directory self --channel zalouser
openclaw directory peers list --channel zalouser --query "name"
openclaw directory groups list --channel zalouser --query "work"

​

Limiti

• Il testo in uscita viene suddiviso in blocchi di circa 2000 caratteri (limiti del client Zalo).
• Lo streaming è bloccato per impostazione predefinita.

​

Controllo accessi (DM)

• openclaw pairing list zalouser
• openclaw pairing approve zalouser <code>

​

Accesso ai gruppi (facoltativo)

• Predefinito: channels.zalouser.groupPolicy = "open" (gruppi consentiti). Usa channels.defaults.groupPolicy per sovrascrivere il valore predefinito quando non è impostato.
• Limita a una allowlist con:
  • channels.zalouser.groupPolicy = "allowlist"
  • channels.zalouser.groups (le chiavi dovrebbero essere ID gruppo stabili; i nomi vengono risolti in ID all’avvio quando possibile)
  • channels.zalouser.groupAllowFrom (controlla quali mittenti nei gruppi consentiti possono attivare il bot)
• Blocca tutti i gruppi: channels.zalouser.groupPolicy = "disabled".
• La procedura guidata di configurazione può chiedere allowlist di gruppi.
• All’avvio, OpenClaw risolve i nomi di gruppi/utenti nelle allowlist in ID e registra la mappatura nei log.
• La corrispondenza della allowlist dei gruppi usa solo gli ID per impostazione predefinita. I nomi non risolti vengono ignorati per l’autorizzazione a meno che non sia abilitato channels.zalouser.dangerouslyAllowNameMatching: true.
• channels.zalouser.dangerouslyAllowNameMatching: true è una modalità di compatibilità break-glass che riabilita la corrispondenza con nomi di gruppo mutabili.
• Se groupAllowFrom non è impostato, il runtime usa allowFrom come fallback per i controlli del mittente nel gruppo.
• I controlli del mittente si applicano sia ai normali messaggi di gruppo sia ai comandi di controllo (ad esempio /new, /reset).

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

​

Controllo menzioni nei gruppi

• channels.zalouser.groups.<group>.requireMention controlla se le risposte nel gruppo richiedono una menzione.
• Ordine di risoluzione: ID/nome gruppo esatto -> slug gruppo normalizzato -> * -> predefinito (true).
• Questo si applica sia ai gruppi in allowlist sia alla modalità gruppo aperto.
• Citare un messaggio del bot conta come menzione implicita per l’attivazione nel gruppo.
• I comandi di controllo autorizzati (ad esempio /new) possono bypassare il controllo delle menzioni.
• Quando un messaggio di gruppo viene saltato perché è richiesta una menzione, OpenClaw lo memorizza come cronologia di gruppo in sospeso e lo include nel successivo messaggio di gruppo elaborato.
• Il limite della cronologia di gruppo usa come valore predefinito messages.groupChat.historyLimit (fallback 50). Puoi sovrascriverlo per account con channels.zalouser.historyLimit.

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

​

Multi-account

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

​

Digitazione, reazioni e conferme di consegna

• OpenClaw invia un evento di digitazione prima di inviare una risposta (best-effort).
• L’azione di reazione al messaggio react è supportata per zalouser nelle azioni di canale.
  • Usa remove: true per rimuovere una specifica emoji di reazione da un messaggio.
  • Semantica delle reazioni: Reazioni
• Per i messaggi in ingresso che includono metadati evento, OpenClaw invia conferme di consegna + visualizzazione (best-effort).

​

Risoluzione dei problemi

• openclaw channels status --probe
• Accedi di nuovo: openclaw channels logout --channel zalouser && openclaw channels login --channel zalouser

• Usa ID numerici in allowFrom/groupAllowFrom/groups, oppure nomi esatti di amici/gruppi.

• Rimuovi eventuali vecchie supposizioni su un processo esterno zca.
• Il canale ora funziona interamente in OpenClaw senza binari CLI esterni.

​

Correlati

• Panoramica dei canali — tutti i canali supportati
• Pairing — autenticazione DM e flusso di pairing
• Gruppi — comportamento della chat di gruppo e controllo delle menzioni
• Instradamento dei canali — instradamento della sessione per i messaggi
• Sicurezza — modello di accesso e hardening