OpenClaw Zalo Personal Kanal
Messaging
Mittel
Verbinden Sie OpenClaw mit Ihrem persoenlichen Zalo-Konto ueber das inoffizielle Tool zca-cli. Im Gegensatz zur Integration ueber die Zalo Bot Platform ermoeglicht dieser Kanal Ihrem KI-Assistenten, ueber ein echtes persoenliches Zalo-Konto zu arbeiten -- mit Unterstuetzung fuer Gruppenchats, Medien und Freundeslisten. Die Authentifizierung erfolgt durch Scannen eines QR Codes, aehnlich wie beim Verknuepfen eines neuen Geraets.
Kurzinfo
SchwierigkeitsgradMittel
KategorieMessaging
Unterstützte Funktionen3 / 6
Zalo Personal Unterstützte Funktionen
Textnachrichten
Unterstützt
Medien & Dateien
Unterstützt
Reaktionen
Nicht unterstützt
Threads
Nicht unterstützt
Sprachnachrichten
Nicht unterstützt
Gruppenchat
Unterstützt
Zalo Personal Voraussetzungen
- Ein persoenliches Zalo-Konto (Standardkonto, kein Official Account)
- Die zca-Binaerdatei installiert und im System-PATH verfuegbar
- OpenClaw Gateway gestartet und konfiguriert
- Zalo-App auf dem Smartphone zum Scannen des QR Codes bei der Anmeldung
Zalo Personal Schnelleinrichtung
1
Das zalouser-Plugin und zca-cli installieren
Installieren Sie das OpenClaw-Plugin mit 'openclaw plugins install @openclaw/zalouser'. Installieren Sie anschliessend das Tool zca-cli und stellen Sie sicher, dass es in Ihrem PATH verfuegbar ist. Ueberpruefen Sie dies mit 'zca --version'.
2
Anmeldung per QR Code
Fuehren Sie 'openclaw channels login --channel zalouser' aus, um einen QR Code in Ihrem Terminal anzuzeigen. Oeffnen Sie die Zalo-App auf Ihrem Smartphone und scannen Sie den QR Code, um die Sitzung zu authentifizieren.
3
Konfigurieren und loschatten
Fuegen Sie die Konfiguration des zalouser-Kanals in ~/.openclaw/openclaw.json mit Ihren bevorzugten Einstellungen fuer dmPolicy und groupPolicy hinzu. Starten Sie das Gateway mit 'openclaw start' und senden Sie eine Nachricht an Ihr Zalo-Konto, um die Verbindung zu testen.
Zalo Personal Konfigurationsbeispiel
config.json
{
"channels": {
"zalouser": {
"enabled": true,
"dmPolicy": "pairing",
"groupPolicy": "open"
}
}
}Zalo Personal Detaillierte Dokumentation
Architekturueberblick
OpenClaw verbindet sich ueber das Tool zca-cli mit Zalo -- einem inoffiziellen Kommandozeilen-Client fuer persoenliche Zalo-Konten. Im Gegensatz zur Integration ueber die Zalo Bot Platform (die HTTP-APIs verwendet) nutzt dieser Kanal die zca-Binaerdatei, um eingehende Nachrichten zu empfangen und ausgehende Antworten zu senden.
Das Gateway fuehrt 'zca listen' als Hintergrundprozess aus, um Nachrichten in Echtzeit zu empfangen, und verwendet 'zca msg' zum Senden von Antworten. Dieser Ansatz funktioniert vollstaendig lokal -- keine oeffentliche URL, kein Webhook und kein HTTPS-Zertifikat erforderlich.
Da ein persoenliches Konto verwendet wird, kann der Bot an Gruppenchats teilnehmen, auf Freundeslisten zugreifen und Medien senden -- Funktionen, die ueber die offizielle Bot Platform nicht verfuegbar sind.
Dies ist eine inoffizielle Integration. Die Nutzung kann zur Sperrung oder zum Ausschluss Ihres Zalo-Kontos fuehren. Verwenden Sie ein dediziertes Konto anstelle Ihres persoenlichen Hauptkontos.
Das Tool zca-cli uebernimmt die Protokollschicht. Halten Sie es aktuell, um die Kompatibilitaet mit dem Zalo-Dienst aufrechtzuerhalten.
Dies ist eine experimentelle Integration mit einem inoffiziellen Tool. Zalo kann Konten, die Automatisierung durch Drittanbieter verwenden, sperren oder ausschliessen. Nutzung auf eigene Gefahr.
Installation von zca-cli
Die zca-cli-Binaerdatei ist eine Voraussetzung fuer diesen Kanal. Sie muss installiert und im System-PATH erreichbar sein, bevor das Gateway den Kanal Zalo Personal nutzen kann.
Ueberpruefen Sie nach der Installation die Funktionsfaehigkeit, indem Sie 'zca --version' in Ihrem Terminal ausfuehren. Wenn der Befehl nicht gefunden wird, ueberpruefen Sie Ihre PATH-Konfiguration oder installieren Sie das Tool erneut.
terminal
zca --versionWenn zca installiert, aber nicht im PATH ist, koennen Sie das Verzeichnis in Ihrem Shell-Profil (~/.bashrc, ~/.zshrc usw.) zum PATH hinzufuegen.
QR-Code-Authentifizierung
Die Authentifizierung erfolgt durch Scannen eines QR Codes mit Ihrer Zalo-App -- aehnlich wie beim Verknuepfen eines neuen Geraets. Es werden keine API Tokens oder Bot Tokens benoetigt.
Fuehren Sie den Anmeldebefehl aus, um den QR Code in Ihrem Terminal anzuzeigen. Oeffnen Sie Zalo auf Ihrem Smartphone, navigieren Sie zum QR-Scanner und scannen Sie den Code. Die Sitzung wird aufgebaut und die Anmeldedaten lokal gespeichert.
Wenn die Anmeldung nach einem Neustart nicht bestehen bleibt, versuchen Sie, sich ab- und wieder anzumelden, um die Sitzung zu erneuern.
terminal
# Login
openclaw channels login --channel zalouser
# If login doesn't persist, re-authenticate
openclaw channels logout --channel zalouser
openclaw channels login --channel zalouserStellen Sie sicher, dass Ihr Smartphone waehrend des QR-Scans mit dem Internet verbunden ist. Die Sitzung wird ueber die Zalo-Server validiert.
DM-Richtlinien
DM-Richtlinien (Direktnachrichten) steuern, wer ueber private Nachrichten mit Ihrem KI-Assistenten interagieren kann. OpenClaw unterstuetzt vier Richtlinien:
• pairing (Standard) — Neue Kontakte erhalten beim ersten Nachrichtenversand einen Pairing-Code. Genehmigen Sie diese ueber 'openclaw pairing approve zalouser <code>'. Codes verfallen nach 1 Stunde.
• allowlist — Nur Benutzer-IDs oder Namen, die in allowFrom aufgefuehrt sind, koennen dem Bot Nachrichten senden. Namen werden ueber 'zca friend find' in IDs aufgeloest.
• open — Jeder, der dem Konto eine Nachricht sendet, erhaelt eine Antwort.
• disabled — Die Verarbeitung von Direktnachrichten ist vollstaendig deaktiviert.
openclaw.json
{
"channels": {
"zalouser": {
"dmPolicy": "allowlist",
"allowFrom": ["123456789", "Friend Name"]
}
}
}Die Richtlinie 'open' ermoeglicht es jedem, mit Ihrem persoenlichen Konto zu interagieren. Da es sich um ein echtes Zalo-Konto handelt, das fuer Ihre Kontakte sichtbar ist, verwenden Sie diese Option mit Vorsicht.
Gruppenchat-Verwaltung
Im Gegensatz zur Integration ueber die Zalo Bot Platform unterstuetzt Zalo Personal Gruppenchats vollstaendig. Standardmaessig ist groupPolicy auf 'open' gesetzt, was bedeutet, dass der Bot in allen Gruppenkonversationen antwortet.
Sie koennen den Gruppenzugriff mit der Richtlinie 'allowlist' und einem groups-Mapping einschraenken. Gruppen koennen ueber ihre numerische ID oder ihren Namen referenziert werden.
Setzen Sie groupPolicy auf 'disabled', um alle Gruppennachrichten vollstaendig zu ignorieren.
openclaw.json
{
"channels": {
"zalouser": {
"groupPolicy": "allowlist",
"groups": {
"123456789": { "allow": true },
"Work Chat": { "allow": true }
}
}
}
}Verwenden Sie 'openclaw directory groups list --channel zalouser --query "name"', um Gruppen-IDs und -namen zu finden.
Gruppennamen sind gross-/kleinschreibungsabhaengig. Verwenden Sie den exakten Namen, wie er in Ihrer Zalo-App angezeigt wird.
Nachrichtenverarbeitung
OpenClaw unterstuetzt das Senden von Textnachrichten, Bildern, Dateien und Links ueber Zalo Personal. Textnachrichten werden automatisch bei etwa 2.000 Zeichen aufgeteilt, um die Client-Limits von Zalo einzuhalten.
Eingehende Nachrichten von Kontakten und Gruppen werden ueber den Prozess 'zca listen' empfangen und an die KI weitergeleitet. Ausgehende Antworten werden mit 'zca msg' gesendet.
Streaming-Antworten sind aufgrund der Zeichenlimit-Beschraenkung standardmaessig deaktiviert.
Lange KI-Antworten werden automatisch an der Grenze von ca. 2.000 Zeichen in mehrere Nachrichten aufgeteilt.
Die Faehigkeiten zum Medienversand haengen von der installierten zca-cli-Version ab. Halten Sie diese fuer beste Kompatibilitaet aktuell.
Multi-Konto-Einrichtung
OpenClaw unterstuetzt den gleichzeitigen Betrieb mehrerer persoenlicher Zalo-Konten durch Zuordnung zu verschiedenen zca-Profilen. Jedes Konto hat seinen eigenen Profilnamen, eigene DM-Richtlinien und Gruppeneinstellungen.
Dies ist nuetzlich, wenn Sie separate KI-Assistenten fuer verschiedene Zwecke betreiben moechten -- beispielsweise ein Arbeitskonto und ein persoenliches Konto.
openclaw.json
{
"channels": {
"zalouser": {
"enabled": true,
"defaultAccount": "default",
"accounts": {
"work": {
"enabled": true,
"profile": "work"
},
"personal": {
"enabled": true,
"profile": "personal"
}
}
}
}
}Verzeichnis und Erkennung
Der Kanal Zalo Personal bietet Verzeichnisbefehle zum Durchsuchen von Freunden und Gruppen in Ihrem Konto. Diese sind nuetzlich, um Benutzer-IDs fuer Zulassungslisten oder Gruppen-IDs fuer Gruppenrichtlinien zu finden.
Sie koennen Ihr eigenes Profil anzeigen, Freunde nach Namen suchen und Gruppen nach Namen suchen -- alles von der Kommandozeile aus.
terminal
# View your profile
openclaw directory self --channel zalouser
# Search friends
openclaw directory peers list --channel zalouser --query "name"
# Search groups
openclaw directory groups list --channel zalouser --query "work"Zalo Personal Konfigurationsreferenz
| Key | Type | Default | Description |
|---|---|---|---|
| enabled | boolean | false | Den Kanal Zalo Personal aktivieren oder deaktivieren |
| dmPolicy | string | "pairing" | Steuert, wer dem Bot Direktnachrichten senden kann. Optionen: pairing, allowlist, open, disabled |
| allowFrom | string[] | [] | Benutzer-IDs oder -namen, die dem Bot Nachrichten senden duerfen (wenn dmPolicy auf allowlist gesetzt ist) |
| groupPolicy | string | "open" | Steuert das Verhalten in Gruppenchats. Optionen: open, allowlist, disabled |
| groups | object | {} | Zuordnung von Gruppen-IDs oder -namen zu Berechtigungsobjekten (wenn groupPolicy auf allowlist gesetzt ist) |
| defaultAccount | string | "default" | Der standardmaessig zu verwendende zca-Profilname |
| accounts.<id>.enabled | boolean | true | Ein bestimmtes Konto im Multi-Konto-Modus aktivieren oder deaktivieren |
| accounts.<id>.profile | string | "" | Der zca-Profilname fuer ein bestimmtes Konto |
enabled
Type: booleanDefault: false
Den Kanal Zalo Personal aktivieren oder deaktivieren
dmPolicy
Type: stringDefault: "pairing"
Steuert, wer dem Bot Direktnachrichten senden kann. Optionen: pairing, allowlist, open, disabled
allowFrom
Type: string[]Default: []
Benutzer-IDs oder -namen, die dem Bot Nachrichten senden duerfen (wenn dmPolicy auf allowlist gesetzt ist)
groupPolicy
Type: stringDefault: "open"
Steuert das Verhalten in Gruppenchats. Optionen: open, allowlist, disabled
groups
Type: objectDefault: {}
Zuordnung von Gruppen-IDs oder -namen zu Berechtigungsobjekten (wenn groupPolicy auf allowlist gesetzt ist)
defaultAccount
Type: stringDefault: "default"
Der standardmaessig zu verwendende zca-Profilname
accounts.<id>.enabled
Type: booleanDefault: true
Ein bestimmtes Konto im Multi-Konto-Modus aktivieren oder deaktivieren
accounts.<id>.profile
Type: stringDefault: ""
Der zca-Profilname fuer ein bestimmtes Konto
Zalo Personal Häufig gestellte Fragen
Zalo Personal Fehlerbehebung
Befehl zca nicht gefunden
Die zca-cli-Binaerdatei ist nicht installiert oder nicht im System-PATH.
Installieren Sie zca-cli und stellen Sie sicher, dass es in Ihrem PATH ist. Ueberpruefen Sie dies mit 'zca --version'. Wenn es installiert, aber nicht gefunden wird, fuegen Sie das Installationsverzeichnis zu Ihrem PATH in ~/.bashrc oder ~/.zshrc hinzu.
QR-Code-Anmeldung schlaegt fehl oder die Sitzung bleibt nicht bestehen
Die Zalo-Sitzung ist moeglicherweise abgelaufen oder die anfaengliche Authentifizierung war unvollstaendig.
Versuchen Sie, sich ab- und wieder anzumelden: 'openclaw channels logout --channel zalouser' und dann 'openclaw channels login --channel zalouser'. Stellen Sie sicher, dass Ihr Smartphone waehrend des QR-Scans eine stabile Internetverbindung hat.
Bot antwortet nicht auf Gruppennachrichten
groupPolicy ist moeglicherweise auf 'disabled' oder auf 'allowlist' gesetzt, ohne dass die Gruppe aufgefuehrt ist.
Ueberpruefen Sie Ihre groupPolicy-Einstellung. Bei Verwendung von 'allowlist' stellen Sie sicher, dass die Gruppen-ID oder der Gruppenname in der groups-Konfiguration aufgefuehrt ist. Verwenden Sie 'openclaw directory groups list --channel zalouser', um die richtige Gruppen-ID zu finden.
Nachrichten werden nicht empfangen
Der Prozess zca listen laeuft moeglicherweise nicht, oder die Sitzung ist abgelaufen.
Fuehren Sie 'openclaw channels status --probe' aus, um die Verbindung zu diagnostizieren. Wenn die Sitzung abgelaufen ist, authentifizieren Sie sich erneut per QR-Code-Anmeldung. Ueberpruefen Sie die Gateway-Logs auf spezifische Fehlermeldungen.
Konto wurde gesperrt oder ausgeschlossen
Zalo hat inoffizielle Automatisierung auf dem Konto erkannt.
Dies ist ein bekanntes Risiko bei der Verwendung inoffizieller Integrationen. Kontaktieren Sie den Zalo-Support, um eine Kontowiederherstellung zu versuchen. Erwaegen Sie den Wechsel zur offiziellen Integration ueber die Zalo Bot Platform (Kanal zalo), die kein Sperrrisiko birgt, jedoch keine Gruppenchats unterstuetzt.