Przejdź do głównej treści
OpenClaw łączy się z Zalo ClawBot przez wymieniony w katalogu zewnętrzny plugin @zalo-platforms/openclaw-zaloclawbot. Logowanie używa kodu QR Zalo Mini App.

​
Zgodność

Wersja PluginWersja OpenClawnpm dist-tagStatus
0.1.x>=2026.4.10latestAktywny / Beta

​
Wymagania wstępne

  • Node.js >= 22
  • OpenClaw musi być zainstalowany (openclaw CLI dostępne).
  • Konto Zalo na urządzeniu mobilnym do zeskanowania kodu QR logowania.

​
Instalacja z użyciem onboard (zalecane)

Uruchom kreator wdrażania OpenClaw i wybierz Zalo ClawBot z menu kanałów: 
openclaw onboard
Kreator instaluje plugin z oficjalnego katalogu (ze zweryfikowaną integralnością), wyświetla kod QR logowania bezpośrednio w terminalu i kończy konfigurację kanału po zeskanowaniu go aplikacją Zalo. Żadne dodatkowe polecenia nie są potrzebne.

​
Instalacja ręczna

Aby dodać kanał do już wdrożonej bramy Gateway, wykonaj te kroki:

​
1. Zainstaluj plugin

openclaw plugins install "@zalo-platforms/openclaw-zaloclawbot@0.1.4"
Użyj dokładnie przypiętej wersji pokazanej powyżej (odpowiada oficjalnemu wpisowi w katalogu), aby OpenClaw zweryfikował pakiet względem skrótu integralności katalogu podczas instalacji.

​
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ą aplikacji mobilnej Zalo, zaakceptuj Warunki korzystania 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 deweloperskiego Zalo, który wymaga zarejestrowania własnego Zalo Official Account (OA) i wklejenia statycznych poświadczeń deweloperskich, Zalo ClawBot działa jako osobisty asystent powiązany z właścicielem, korzystając ze współdzielonej, oficjalnej infrastruktury:
  1. Bezpieczne wdrażanie: Kod QR prowadzi do bezpiecznej Zalo Mini App, która wiąże nowo utworzonego, prywatnego bota działającego pod współdzielonym oficjalnym OA bezpośrednio z Twoim Zalo User ID.
  2. Prywatność powiązana z właścicielem: Z założenia bot może komunikować się wyłącznie ze swoim właścicielem. Wiadomości od innych użytkowników są odrzucane na poziomie platformy, dzięki czemu połączenie jest prywatne i bezpieczne.
  3. Oficjalna ścieżka API: Plugin używa API Zalo Bot Platform zamiast automatyzacji przeglądarki lub sesji webowej.

​
Pod maską

Plugin Zalo ClawBot komunikuje się z API Zalo przez trwałą pętlę komunikatów long-polling. Aby utrzymać czyste i lekkie środowisko uruchomieniowe:
  • Połączenia long-poll korzystają z punktu końcowego getUpdates.
  • Webhooks są domyślnie wyłączone dla lokalnych uruchomień Gateway na komputerze/terminalu.
  • Wiadomości są przetwarzane po stronie klienta i mapowane bezpośrednio do lokalnego środowiska uruchomieniowego agenta.
Zewnętrzny plugin zarządza poświadczeniami bota w katalogu stanu OpenClaw. Traktuj ten katalog jako poufny i obejmij go takimi samymi zasadami kontroli dostępu oraz kopii zapasowych jak resztę stanu OpenClaw.

​
Rozwiązywanie problemów

  • Limit czasu logowania QR: Token logowania (zbsk) wygasa po 5 minutach ze względów bezpieczeństwa. Jeśli kod QR wygaśnie przed zeskanowaniem, po prostu uruchom ponownie polecenie logowania, aby wygenerować nowy.
  • Gateway nie ładuje się: Upewnij się, że wersja hosta OpenClaw to 2026.4.10 lub nowsza. Starsze wersje nie obsługują rejestru instalacji zewnętrznych pluginów npm.