Zalo ClawBot

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ść

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.