Zalo ClawBot

OpenClaw verbindet sich über das im Katalog aufgeführte externe Plugin @zalo-platforms/openclaw-zaloclawbot mit Zalo ClawBot. Die Anmeldung erfolgt über einen QR-Code einer Zalo Mini App; die Plugin-ID in der Konfiguration lautet openclaw-zaloclawbot.

Kompatibilität

Voraussetzungen

• Node.js >= 22
• OpenClaw installiert (openclaw CLI verfügbar)
• Ein Zalo-Konto auf einem Mobilgerät zum Scannen des Anmelde-QR-Codes

Installation mit Onboarding (empfohlen)

openclaw onboard

Wählen Sie Zalo ClawBot im Kanalmenü aus. Der Assistent installiert das Plugin aus dem offiziellen Katalog (integritätsgeprüft), zeigt den Anmelde-QR-Code im Terminal an und schließt die Kanaleinrichtung ab, sobald Sie ihn mit der Zalo-App scannen.

Manuelle Installation

So fügen Sie den Kanal einem bereits eingerichteten Gateway hinzu:

1. Plugin installieren

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

Verwenden Sie exakt die festgelegte Version, damit OpenClaw das Paket während der Installation anhand des Integritäts-Hashes im Katalog überprüft.

2. Plugin in der Konfiguration aktivieren

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

3. QR-Code erzeugen und anmelden

openclaw channels login --channel openclaw-zaloclawbot

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

4. Gateway neu starten

openclaw gateway restart

Funktionsweise

Im Gegensatz zum standardmäßigen Zalo-Kanal, für den Sie Ihr eigenes Zalo Official Account (OA) registrieren und statische Entwickler-Anmeldedaten konfigurieren müssen, ist Zalo ClawBot ein inhabergebundener persönlicher Assistent auf gemeinsam genutzter offizieller Infrastruktur:

1. Onboarding: Der QR-Code führt zu einer Zalo Mini App, die einen neu bereitgestellten privaten Bot unter einem gemeinsam genutzten offiziellen OA direkt mit Ihrer Zalo-Benutzer-ID verknüpft.
2. Inhabergebundener Datenschutz: Der Bot kommuniziert ausschließlich mit seinem Inhaber. Nachrichten anderer Benutzer werden auf Plattformebene verworfen.
3. Offizieller API-Pfad: Das Plugin verwendet APIs der Zalo Bot Platform und keine Browser- oder Websitzungsautomatisierung.

Technische Funktionsweise

Das Plugin kommuniziert über eine persistente Long-Polling-Schleife (getUpdates) mit Zalo. Webhooks sind bei lokalen Gateway-Ausführungen auf dem Desktop oder im Terminal standardmäßig deaktiviert. Nachrichten werden clientseitig verarbeitet und Ihrer lokalen Agent-Laufzeit zugeordnet.

Das Plugin verwaltet Bot-Anmeldedaten im OpenClaw-Zustandsverzeichnis. Behandeln Sie dieses Verzeichnis als vertraulich und beziehen Sie es in dieselben Richtlinien für Zugriffskontrolle und Sicherungen ein wie den übrigen OpenClaw-Zustand.

Die Laufzeit dieses Plugins befindet sich vollständig im externen Paket @zalo-platforms/openclaw-zaloclawbot; die nachfolgenden Verhaltensdetails, die über Installation und Konfiguration hinausgehen, entsprechen den Angaben der Plugin-Betreuer und wurden nicht anhand des OpenClaw-Core-Quellcodes überprüft.

Fehlerbehebung

• Zeitüberschreitung bei der QR-Anmeldung: Das Anmelde-Token (zbsk) läuft aus Sicherheitsgründen nach 5 Minuten ab. Wenn der QR-Code abläuft, bevor Sie ihn scannen, führen Sie den Anmeldebefehl erneut aus, um einen neuen zu erzeugen.
• Gateway kann nicht geladen werden: Vergewissern Sie sich, dass die Version Ihres OpenClaw-Hosts 2026.4.10 oder höher ist. Ältere Versionen unterstützen das Installationsverzeichnis für externe npm-Plugins nicht, das für diese ID erforderlich ist.

Verwandte Themen

• Kanalübersicht - alle unterstützten Kanäle
• Zalo - der gebündelte Kanal für Zalo Bot Creator / Marketplace
• Kopplung - DM-Authentifizierung und Kopplungsablauf
• Plugins - Plugins installieren und verwalten