​

Zalo Personal (nieoficjalne)

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

​

Bundled plugin

• Zainstaluj przez CLI: openclaw plugins install @openclaw/zalouser
• Albo z checkoutu kodu źródłowego: 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.
   • Jest już dołączony do aktualnych spakowanych wydań OpenClaw.
   • Starsze/niestandardowe instalacje mogą 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 przez DM 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 dla przypadków użycia „osobistego konta”, w których API bota Zalo nie jest dostępne.

​

Nazewnictwo

​

Znajdowanie identyfikatorów (directory)

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

​

Ograniczenia

• Wychodzący tekst jest dzielony na fragmenty po około 2000 znaków (ograniczenia klienta Zalo).
• Streamowanie jest domyślnie zablokowane.

​

Kontrola dostępu (DM)

• 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 podczas uruchamiania, gdy to możliwe)
  • channels.zalouser.groupAllowFrom (kontroluje, którzy nadawcy w dozwolonych grupach mogą wywołać bota)
• Zablokuj wszystkie grupy: channels.zalouser.groupPolicy = "disabled".
• Kreator konfiguracji może pytać o listy dozwolonych grup.
• Przy uruchamianiu OpenClaw rozwiązuje nazwy grup/użytkowników z list dozwolonych do identyfikatorów i zapisuje mapowanie w logach.
• Dopasowywanie listy dozwolonych grup domyślnie odbywa się tylko po identyfikatorze. Nierozwiązane nazwy są ignorowane przy autoryzacji, chyba że włączono channels.zalouser.dangerouslyAllowNameMatching: true.
• channels.zalouser.dangerouslyAllowNameMatching: true to awaryjny tryb zgodności, który ponownie włącza dopasowywanie po zmiennej nazwie grupy.
• Jeśli groupAllowFrom nie jest ustawione, środowisko wykonawcze używa allowFrom jako ustawienia zastępczego do sprawdzania nadawców w grupach.
• Sprawdzanie nadawców dotyczy zarówno zwykłych wiadomości grupowych, jak i poleceń sterujących (na przykład /new, /reset).

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

​

Ograniczanie odpowiedzi w grupie do wzmianek

• channels.zalouser.groups.<group>.requireMention kontroluje, czy odpowiedzi w grupie 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 otwartego trybu grupowego.
• Cytowanie wiadomości bota liczy się jako niejawna wzmianka do aktywacji w grupie.
• Autoryzowane polecenia sterujące (na przykład /new) mogą omijać wymóg wzmianki.
• Gdy wiadomość grupowa jest pomijana, ponieważ wzmianka jest wymagana, OpenClaw zapisuje ją jako oczekującą historię grupy i dołącza ją do następnej przetwarzanej wiadomości grupowej.
• Limit historii grupowej domyślnie wynosi messages.groupChat.historyLimit (wartość zastępcza 50). Możesz go nadpisać dla konta 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ąć konkretną emoji reakcji z wiadomości.
  • Semantyka reakcji: Reactions
• Dla wiadomości przychodzących zawierających metadane zdarzeń OpenClaw wysyła potwierdzenia dostarczenia + 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żyj 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 w OpenClaw, bez zewnętrznych binarnych plików CLI.

​

Powiązane

• Channels Overview — wszystkie obsługiwane kanały
• Pairing — uwierzytelnianie DM i przepływ parowania
• Groups — zachowanie czatu grupowego i ograniczanie do wzmianek
• Channel Routing — routowanie sesji dla wiadomości
• Security — model dostępu i utwardzanie