> ## 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 verbindet sich über das im Katalog gelistete externe
`@zalo-platforms/openclaw-zaloclawbot`-Plugin mit Zalo ClawBot. Die Anmeldung verwendet einen QR-Code einer Zalo Mini App.

## Kompatibilität

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

## Voraussetzungen

* Node.js **>= 22**
* [OpenClaw](https://docs.openclaw.ai/install) muss installiert sein (`openclaw`-CLI verfügbar).
* Ein Zalo-Konto auf einem Mobilgerät, um den Anmelde-QR-Code zu scannen.

## Installation mit Onboarding (empfohlen)

Führen Sie den OpenClaw-Onboarding-Assistenten aus und wählen Sie **Zalo ClawBot** im Kanalmenü aus:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard
```

Der Assistent installiert das Plugin aus dem offiziellen Katalog (integritätsgeprüft), rendert den Anmelde-QR-Code direkt im Terminal und schließt den Kanal ab, sobald Sie ihn mit der Zalo-App scannen. Es sind keine zusätzlichen Befehle erforderlich.

## Manuelle Installation

Um den Kanal einem bereits eingerichteten Gateway hinzuzufügen, gehen Sie wie folgt vor:

### 1. Plugin installieren

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install "@zalo-platforms/openclaw-zaloclawbot@0.1.4"
```

Verwenden Sie die oben gezeigte exakt festgelegte Version (sie entspricht dem offiziellen Katalogeintrag), damit OpenClaw das Paket während der Installation anhand des Katalog-Integritäts-Hashes verifiziert.

### 2. Plugin in der Konfiguration aktivieren

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

### 3. QR-Code generieren und anmelden

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw channels login --channel openclaw-zaloclawbot
```

Scannen Sie den im Terminal gerenderten QR-Code mit der mobilen Zalo-App, akzeptieren Sie die Nutzungsbedingungen in der Zalo Mini App und autorisieren Sie die Sitzung.

### 4. Gateway neu starten

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw gateway restart
```

***

## Funktionsweise

Im Gegensatz zum standardmäßigen Zalo-Entwicklerkanal, bei dem Sie Ihr eigenes Zalo Official Account (OA) registrieren und statische Entwickler-Anmeldedaten einfügen müssen, arbeitet Zalo ClawBot als **an den Besitzer gebundener persönlicher Assistent** mit gemeinsam genutzter offizieller Infrastruktur:

1. **Sicheres Onboarding:** Der QR-Code verweist auf eine sichere Zalo Mini App, die einen neu bereitgestellten privaten Bot unter einem gemeinsam genutzten offiziellen OA direkt an Ihre Zalo User ID bindet.
2. **An den Besitzer gebundene Privatsphäre:** Der Bot ist absichtlich darauf beschränkt, *nur* mit seinem Besitzer zu kommunizieren. Nachrichten anderer Benutzer werden auf Plattformebene verworfen, wodurch die Verbindung privat und sicher bleibt.
3. **Offizieller API-Pfad:** Das Plugin verwendet Zalo Bot Platform APIs statt
   Browser- oder Web-Sitzungsautomatisierung.

## Unter der Haube

Das Zalo ClawBot-Plugin kommuniziert über eine persistente Long-Polling-Nachrichtenschleife mit Zalo-APIs. Für eine saubere und schlanke Runtime gilt:

* Long-Poll-Verbindungen verwenden den `getUpdates`-Endpunkt.
* Webhooks sind für lokale Desktop-/Terminal-Gateway-Ausführungen standardmäßig deaktiviert.
* Nachrichten werden clientseitig verarbeitet und direkt Ihrer lokalen Agent-Runtime zugeordnet.

Das externe Plugin verwaltet Bot-Anmeldedaten im OpenClaw-Zustandsverzeichnis.
Behandeln Sie dieses Verzeichnis als sensibel und beziehen Sie es in dieselbe Zugriffssteuerungs- und
Backup-Richtlinie ein wie den restlichen OpenClaw-Zustand.

***

## Fehlerbehebung

* **Zeitüberschreitung bei QR-Anmeldung:** Das Anmeldetoken (`zbsk`) läuft aus Sicherheitsgründen nach 5 Minuten ab. Wenn der QR-Code abläuft, bevor Sie ihn scannen, führen Sie einfach den Anmeldebefehl erneut aus, um einen neuen zu generieren.
* **Gateway kann nicht geladen werden:** Stellen Sie sicher, dass Ihre OpenClaw-Hostversion `2026.4.10` oder höher ist. Ältere Versionen unterstützen das Installations-Ledger für externe npm-Plugins nicht.