​

Zalo Personal (nieoficjalne)

Ostrzeżenie: To jest nieoficjalna integracja i może skutkować zawieszeniem/zbanowaniem konta. Używasz jej na własne ryzyko.

​

Plugin dołączony do pakietu

• Instalacja przez CLI: openclaw plugins install @openclaw/zalouser
• Albo z checkoutu źródeł: openclaw plugins install ./path/to/local/zalouser-plugin
• Szczegóły: Plugins

​

Szybka konfiguracja (dla początkujących)

1. Upewnij się, że plugin Zalo Personal jest dostępny.
   • Aktualne spakowane wydania OpenClaw już go zawierają.
   • W starszych/niestandardowych instalacjach można dodać go ręcznie za pomocą powyższych poleceń.
2. Zaloguj się (QR, na maszynie Gateway):
   • openclaw channels login --channel zalouser
   • Zeskanuj kod QR aplikacją mobilną Zalo.
3. Włącz kanał:

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

4. Uruchom ponownie Gateway (lub dokończ konfigurację).
5. Dostęp do wiadomości prywatnych domyślnie używa parowania; zatwierdź kod parowania przy pierwszym kontakcie.

​

Czym to jest

• Działa całkowicie w procesie przez zca-js.
• Używa natywnych listenerów zdarzeń do odbierania wiadomości przychodzących.
• Wysyła odpowiedzi bezpośrednio przez API JS (tekst/multimedia/link).
• Zaprojektowane do przypadków użycia „osobistego konta”, gdzie Zalo Bot API nie jest dostępne.

​

Nazewnictwo

​

Znajdowanie identyfikatorów (katalog)

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

​

Limity

• Tekst wychodzący jest dzielony na fragmenty po około 2000 znaków (limity klienta Zalo).
• Streaming jest domyślnie blokowany.

​

Kontrola dostępu (wiadomości prywatne)

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

​

Dostęp do grup (opcjonalnie)

• Domyślnie: channels.zalouser.groupPolicy = "open" (grupy dozwolone). Użyj channels.defaults.groupPolicy, aby nadpisać wartość domyślną, gdy nie jest ustawiona.
• Ogranicz do listy dozwolonych za pomocą:
  • channels.zalouser.groupPolicy = "allowlist"
  • channels.zalouser.groups (klucze powinny być stabilnymi identyfikatorami grup; nazwy są rozwiązywane do identyfikatorów przy starcie, gdy to możliwe)
  • channels.zalouser.groupAllowFrom (kontroluje, którzy nadawcy w dozwolonych grupach mogą wyzwalać bota)
• Zablokuj wszystkie grupy: channels.zalouser.groupPolicy = "disabled".
• Kreator konfiguracji może pytać o listy dozwolonych grup.
• Przy starcie OpenClaw rozwiązuje nazwy grup/użytkowników w listach dozwolonych do identyfikatorów i zapisuje mapowanie w logach.
• Dopasowanie listy dozwolonych grup domyślnie opiera się tylko na identyfikatorach. Nierozwiązane nazwy są ignorowane przy autoryzacji, chyba że włączone jest channels.zalouser.dangerouslyAllowNameMatching: true.
• channels.zalouser.dangerouslyAllowNameMatching: true to awaryjny tryb zgodności, który ponownie włącza dopasowywanie zmiennych nazw grup.
• Jeśli groupAllowFrom nie jest ustawione, runtime używa allowFrom jako fallbacku dla sprawdzania nadawców grupowych.
• Sprawdzanie nadawców dotyczy zarówno zwykłych wiadomości grupowych, jak i poleceń kontrolnych (na przykład /new, /reset).

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

​

Bramka wzmianki w grupach

• channels.zalouser.groups.<group>.requireMention kontroluje, czy odpowiedzi w grupach wymagają wzmianki.
• Kolejność rozwiązywania: dokładny identyfikator/nazwa grupy -> znormalizowany slug grupy -> * -> wartość domyślna (true).
• Dotyczy to zarówno grup z listy dozwolonych, jak i trybu otwartych grup.
• Autoryzowane polecenia kontrolne (na przykład /new) mogą omijać bramkę wzmianki.
• Gdy wiadomość grupowa jest pomijana, ponieważ wymagana jest wzmianka, OpenClaw zapisuje ją jako oczekującą historię grupy i dołącza ją do następnej przetworzonej wiadomości grupowej.
• Limit historii grupy domyślnie wynosi messages.groupChat.historyLimit (fallback 50). Można go nadpisać per konto przez channels.zalouser.historyLimit.

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

​

Wiele kont

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

​

Pisanie, reakcje i potwierdzenia dostarczenia

• OpenClaw wysyła zdarzenie pisania przed wysłaniem odpowiedzi (best-effort).
• Akcja reakcji na wiadomość react jest obsługiwana dla zalouser w akcjach kanału.
  • Użyj remove: true, aby usunąć określoną reakcję emoji z wiadomości.
  • Semantyka reakcji: Reactions
• Dla wiadomości przychodzących zawierających metadane zdarzeń OpenClaw wysyła potwierdzenia dostarczenia i odczytu (best-effort).

​

Rozwiązywanie problemów

• openclaw channels status --probe
• Zaloguj się ponownie: openclaw channels logout --channel zalouser && openclaw channels login --channel zalouser

• Używaj numerycznych identyfikatorów w allowFrom/groupAllowFrom/groups albo dokładnych nazw znajomych/grup.

• Usuń wszelkie stare założenia dotyczące zewnętrznego procesu zca.
• Kanał działa teraz w pełni wewnątrz OpenClaw bez zewnętrznych binarnych CLI.

​

Powiązane

• Channels Overview — wszystkie obsługiwane kanały
• Pairing — uwierzytelnianie wiadomości prywatnych i przepływ parowania
• Groups — zachowanie czatów grupowych i bramkowanie wzmianką
• Channel Routing — routing sesji dla wiadomości
• Security — model dostępu i utwardzanie