Zalo osobiste

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Dołączony Plugin

• Instalacja przez CLI: openclaw plugins install @openclaw/zalouser
• Przypięta wersja: openclaw plugins install @openclaw/zalouser@2026.5.2
• Albo z checkoutu źródłowego: openclaw plugins install ./path/to/local/zalouser-plugin
• Szczegóły: Pluginy

​

Szybka konfiguracja (dla początkujących)

1. Upewnij się, że Plugin Zalo Personal jest dostępny.
   • Obecne pakietowe wydania OpenClaw już go zawierają.
   • 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 (albo dokończ konfigurację).
5. Dostęp do 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/media/link).
• Zaprojektowane dla przypadków użycia „osobistego konta”, gdy Zalo Bot API nie jest dostępne.

​

Nazewnictwo

​

Znajdowanie ID (katalog)

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

​

Ograniczenia

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

​

Kontrola dostępu (DM)

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

​

Dostęp grupowy (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 (kluczami powinny być stabilne ID grup; nazwy są rozwiązywane do ID przy starcie tylko wtedy, gdy włączono channels.zalouser.dangerouslyAllowNameMatching: true)
  • channels.zalouser.groupAllowFrom (kontroluje, którzy nadawcy w dozwolonych grupach mogą wywołać bota; do statycznych grup dostępu nadawców można odwoływać się przez accessGroup:<name>)
• Zablokuj wszystkie grupy: channels.zalouser.groupPolicy = "disabled".
• Kreator konfiguracji może zapytać o listy dozwolonych grup.
• Przy starcie OpenClaw rozwiązuje nazwy grup/użytkowników na listach dozwolonych do ID i loguje mapowanie tylko wtedy, gdy włączono channels.zalouser.dangerouslyAllowNameMatching: true.
• Dopasowywanie listy dozwolonych grup jest domyślnie wyłącznie oparte na ID. Nierozwiązane nazwy są ignorowane na potrzeby uwierzytelniania, chyba że włączono channels.zalouser.dangerouslyAllowNameMatching: true.
• channels.zalouser.dangerouslyAllowNameMatching: true to awaryjny tryb zgodności, który ponownie włącza zmienne rozwiązywanie nazw przy starcie i dopasowywanie nazw grup w runtime.
• Jeśli groupAllowFrom nie jest ustawione, runtime wraca do allowFrom podczas sprawdzania nadawców grupowych.
• 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 },
      },
    },
  },
}

​

Bramkowanie wzmianek w grupie

• channels.zalouser.groups.<group>.requireMention kontroluje, czy odpowiedzi grupowe wymagają wzmianki.
• Kolejność rozwiązywania: dokładne ID/nazwa grupy -> znormalizowany slug grupy -> * -> domyślnie (true).
• Dotyczy to zarówno grup z listy dozwolonych, jak i trybu otwartych grup.
• Zacytowanie wiadomości bota liczy się jako niejawna wzmianka aktywująca grupę.
• Autoryzowane polecenia sterujące (na przykład /new) mogą pominąć bramkowanie wzmiankami.
• Gdy wiadomość grupowa zostanie pominięta, ponieważ wymagana jest wzmianka, 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ść zapasowa 50). Możesz nadpisać go dla konta za pomocą 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ąć z wiadomości konkretną reakcję emoji.
  • Semantyka reakcji: Reakcje
• Dla wiadomości przychodzących zawierających metadane zdarzeń OpenClaw wysyła potwierdzenia dostarczenia i odczytania (best-effort).

​

Rozwiązywanie problemów

• openclaw channels status --probe
• Ponowne logowanie: openclaw channels logout --channel zalouser && openclaw channels login --channel zalouser

• Użyj numerycznych ID w allowFrom/groupAllowFrom i stabilnych ID grup w groups. Jeśli celowo potrzebujesz dokładnych nazw znajomych/grup, włącz channels.zalouser.dangerouslyAllowNameMatching: true.

• 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

• Przegląd kanałów — wszystkie obsługiwane kanały
• Parowanie — uwierzytelnianie DM i przepływ parowania
• Grupy — zachowanie czatu grupowego i bramkowanie wzmianek
• Routing kanałów — routing sesji dla wiadomości
• Bezpieczeństwo — model dostępu i utwardzanie