Zalo ClawBot

OpenClaw łączy się z Zalo ClawBot za pośrednictwem zewnętrznego pluginu @zalo-platforms/openclaw-zaloclawbot wymienionego w katalogu. Logowanie odbywa się za pomocą kodu QR Zalo Mini App; identyfikator pluginu w konfiguracji to openclaw-zaloclawbot.

Zgodność

Wymagania wstępne

• Node.js >= 22
• Zainstalowany OpenClaw (dostępny CLI openclaw)
• Konto Zalo na urządzeniu mobilnym do zeskanowania kodu QR logowania

Instalacja za pomocą onboardingu (zalecana)

openclaw onboard

Wybierz Zalo ClawBot z menu kanałów. Kreator instaluje plugin z oficjalnego katalogu (po zweryfikowaniu integralności), wyświetla kod QR logowania w terminalu i kończy konfigurację kanału po zeskanowaniu go w aplikacji Zalo.

Instalacja ręczna

Aby dodać kanał do już skonfigurowanego Gateway:

1. Zainstaluj plugin

openclaw plugins install "@zalo-platforms/openclaw-zaloclawbot@0.1.4"

Użyj dokładnie tej przypiętej wersji, aby podczas instalacji OpenClaw zweryfikował pakiet względem skrótu integralności z katalogu.

2. Włącz plugin w konfiguracji

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

3. Wygeneruj kod QR i zaloguj się

openclaw channels login --channel openclaw-zaloclawbot

Zeskanuj kod QR wyświetlony w terminalu za pomocą mobilnej aplikacji Zalo, zaakceptuj warunki użytkowania w Zalo Mini App i autoryzuj sesję.

4. Uruchom ponownie Gateway

openclaw gateway restart

Jak to działa

W przeciwieństwie do standardowego kanału Zalo, który wymaga zarejestrowania własnego oficjalnego konta Zalo (OA) i skonfigurowania statycznych danych uwierzytelniających dewelopera, Zalo ClawBot jest osobistym asystentem powiązanym z właścicielem, działającym we współdzielonej oficjalnej infrastrukturze:

1. Onboarding: kod QR prowadzi do Zalo Mini App, która wiąże nowo utworzonego prywatnego bota działającego w ramach współdzielonego oficjalnego OA bezpośrednio z identyfikatorem użytkownika Zalo.
2. Prywatność dzięki powiązaniu z właścicielem: bot komunikuje się wyłącznie ze swoim właścicielem. Wiadomości od innych użytkowników są odrzucane na poziomie platformy.
3. Oficjalna ścieżka API: plugin korzysta z interfejsów API Zalo Bot Platform, a nie z automatyzacji przeglądarki ani sesji internetowej.

Szczegóły techniczne

Plugin komunikuje się z Zalo za pośrednictwem trwałej pętli długiego odpytywania (getUpdates). Webhooki są domyślnie wyłączone w przypadku lokalnych uruchomień Gateway na komputerze lub w terminalu. Wiadomości są przetwarzane po stronie klienta i odwzorowywane na lokalne środowisko wykonawcze agenta.

Plugin zarządza danymi uwierzytelniającymi bota w katalogu stanu OpenClaw. Traktuj ten katalog jako poufny i obejmij go taką samą polityką kontroli dostępu oraz tworzenia kopii zapasowych jak pozostałe dane stanu OpenClaw.

Kod wykonawczy tego pluginu znajduje się w całości w zewnętrznym pakiecie @zalo-platforms/openclaw-zaloclawbot; opisane poniżej szczegóły zachowania wykraczające poza instalację i konfigurację pochodzą od opiekunów pluginu i nie zostały zweryfikowane względem kodu źródłowego rdzenia OpenClaw.

Rozwiązywanie problemów

• Przekroczenie limitu czasu logowania kodem QR: ze względów bezpieczeństwa token logowania (zbsk) wygasa po 5 minutach. Jeśli kod QR wygaśnie przed jego zeskanowaniem, ponownie uruchom polecenie logowania, aby wygenerować nowy.
• Gateway nie może się załadować: upewnij się, że wersja OpenClaw na hoście to 2026.4.10 lub nowsza. Starsze wersje nie obsługują rejestru instalacji zewnętrznych pluginów npm wymaganego przez ten identyfikator.

Powiązane materiały

• Przegląd kanałów — wszystkie obsługiwane kanały
• Zalo — dołączony kanał Zalo Bot Creator / Marketplace
• Parowanie — uwierzytelnianie w wiadomościach prywatnych i przebieg parowania
• Pluginy — instalowanie pluginów i zarządzanie nimi