> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

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

| Wersja Plugin | Wersja OpenClaw | npm dist-tag | Status         |
| ------------- | --------------- | ------------ | -------------- |
| 0.1.x         | >=2026.4.10     | `latest`     | Aktywny / Beta |

## Wymagania wstępne

* Node.js **>= 22**
* [OpenClaw](https://docs.openclaw.ai/install) 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:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw config set plugins.entries.openclaw-zaloclawbot.enabled true
```

### 3. Wygeneruj kod QR i zaloguj się

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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.