OpenClaw Zalo Kanal
Verbinden Sie OpenClaw über die Zalo Bot Platform mit Zalo. Diese Integration ermöglicht es Ihrem KI-Assistenten, Nachrichten in Vietnams beliebtester Messaging-App zu senden und zu empfangen. Richten Sie einen Bot Token ein, konfigurieren Sie Ihre DM-Richtlinie und beginnen Sie zu chatten — mit Unterstützung für Long-Polling und Webhook-Zustellungsmodi.
Zalo Unterstützte Funktionen
Textnachrichten
Unterstützt
Medien & Dateien
Nicht unterstützt
Reaktionen
Nicht unterstützt
Threads
Nicht unterstützt
Sprachnachrichten
Nicht unterstützt
Gruppenchat
Nicht unterstützt
Zalo Voraussetzungen
- Ein Zalo-Konto mit Zugang zur Zalo Bot Platform (bot.zaloplatforms.com)
- Ein Bot Token aus dem Zalo Bot Platform Dashboard
- OpenClaw Gateway läuft und ist konfiguriert
- Für den Webhook-Modus: ein öffentlich erreichbarer HTTPS-Endpunkt
Zalo Schnelleinrichtung
Zalo Bot erstellen und Token erhalten
Gehen Sie zu bot.zaloplatforms.com, melden Sie sich mit Ihrem Zalo-Konto an und erstellen Sie einen neuen Bot. Kopieren Sie den Bot Token (Format: 12345689:abc-xyz) aus dem Dashboard.
Zalo-Kanal-Konfiguration hinzufügen
Fügen Sie die Zalo-Kanal-Konfiguration in ~/.openclaw/openclaw.json hinzu. Legen Sie botToken, dmPolicy (pairing, allowlist, open oder disabled) fest und konfigurieren Sie optional die Webhook-Einstellungen.
Gateway starten und testen
Starten Sie das Gateway mit 'openclaw start'. Der Bot verbindet sich standardmäßig im Long-Polling-Modus. Senden Sie eine Nachricht an Ihren Bot auf Zalo, um die Verbindung zu überprüfen.
Zalo Konfigurationsbeispiel
{
"channels": {
"zalo": {
"enabled": true,
"botToken": "12345689:abc-xyz",
"dmPolicy": "pairing"
}
}
}Zalo Detaillierte Dokumentation
Architekturübersicht
Ihren Zalo Bot erstellen
{
"channels": {
"zalo": {
"enabled": true,
"botToken": "12345689:abc-xyz"
}
}
}DM-Richtlinien
{
"channels": {
"zalo": {
"dmPolicy": "allowlist",
"allowFrom": ["123456789", "987654321"]
}
}
}Webhook-Konfiguration
{
"channels": {
"zalo": {
"botToken": "12345689:abc-xyz",
"webhookUrl": "https://your-server.com/zalo/webhook",
"webhookSecret": "your-secret-string-8-to-256-chars",
"webhookPath": "/zalo/webhook"
}
}
}Nachrichtenverarbeitung
Multi-Account-Einrichtung
{
"channels": {
"zalo": {
"accounts": {
"support-bot": {
"botToken": "token-for-support-bot",
"dmPolicy": "open"
},
"team-bot": {
"botToken": "token-for-team-bot",
"dmPolicy": "allowlist",
"allowFrom": ["111222333"]
}
}
}
}
}Ausgehende Nachrichten
openclaw message send --channel zalo --target 123456789Proxy-Konfiguration
{
"channels": {
"zalo": {
"proxy": "http://proxy.example.com:8080"
}
}
}Zalo Konfigurationsreferenz
| Key | Type | Default | Description |
|---|---|---|---|
| enabled | boolean | false | Zalo-Kanal aktivieren oder deaktivieren |
| botToken | string | "" | Bot Token von der Zalo Bot Platform (bot.zaloplatforms.com) |
| tokenFile | string | "" | Bot Token aus einem Dateipfad statt aus der Inline-Konfiguration lesen |
| dmPolicy | string | "pairing" | Steuert, wer dem Bot DMs senden kann. Optionen: pairing, allowlist, open, disabled |
| allowFrom | string[] | [] | Numerische Zalo-Benutzer-IDs, die mit dem Bot kommunizieren dürfen (wenn dmPolicy allowlist ist) |
| mediaMaxMb | number | 5 | Maximale Größe eingehender Mediendateien in Megabyte |
| webhookUrl | string | "" | HTTPS-URL für den Webhook-Modus. Wenn gesetzt, wird Long-Polling deaktiviert |
| webhookSecret | string | "" | Geheimer String (8-256 Zeichen) zur Webhook-Verifizierung über den X-Bot-Api-Secret-Token Header |
| webhookPath | string | "" | Benutzerdefinierter Webhook-Pfad auf dem Gateway HTTP-Server |
| proxy | string | "" | Proxy-URL für ausgehende API-Anfragen an Zalo |
| accounts.<id>.botToken | string | "" | Bot Token für ein bestimmtes Konto im Multi-Account-Modus |
| accounts.<id>.dmPolicy | string | "pairing" | DM-Richtlinienüberschreibung für ein bestimmtes Konto |
| accounts.<id>.webhookUrl | string | "" | Webhook-URL-Überschreibung für ein bestimmtes Konto |
Zalo-Kanal aktivieren oder deaktivieren
Bot Token von der Zalo Bot Platform (bot.zaloplatforms.com)
Bot Token aus einem Dateipfad statt aus der Inline-Konfiguration lesen
Steuert, wer dem Bot DMs senden kann. Optionen: pairing, allowlist, open, disabled
Numerische Zalo-Benutzer-IDs, die mit dem Bot kommunizieren dürfen (wenn dmPolicy allowlist ist)
Maximale Größe eingehender Mediendateien in Megabyte
HTTPS-URL für den Webhook-Modus. Wenn gesetzt, wird Long-Polling deaktiviert
Geheimer String (8-256 Zeichen) zur Webhook-Verifizierung über den X-Bot-Api-Secret-Token Header
Benutzerdefinierter Webhook-Pfad auf dem Gateway HTTP-Server
Proxy-URL für ausgehende API-Anfragen an Zalo
Bot Token für ein bestimmtes Konto im Multi-Account-Modus
DM-Richtlinienüberschreibung für ein bestimmtes Konto
Webhook-URL-Überschreibung für ein bestimmtes Konto
Zalo Häufig gestellte Fragen
Zalo Fehlerbehebung
Der Bot Token kann ungültig oder abgelaufen sein, oder das Gateway läuft nicht. Im Webhook-Modus ist der HTTPS-Endpunkt möglicherweise nicht erreichbar.
Long-Polling hat im Vergleich zum Webhook-Modus eine inhärente Latenz. Netzwerkinstabilität kann ebenfalls zu Nachrichtenbündelung führen.
Die dmPolicy ist möglicherweise nicht auf 'pairing' eingestellt, oder der Bot ist nicht korrekt mit Zalo verbunden.
Die Bilddatei überschreitet möglicherweise die mediaMaxMb-Grenze, oder die Zalo-API ist vorübergehend nicht verfügbar.
Das webhookSecret in Ihrer Konfiguration stimmt nicht mit dem überein, was Zalo erwartet, oder der Endpunkt gibt nicht die richtige Antwort zurück.