Zalo privat

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Gebündeltes Plugin

• Installation über die CLI: openclaw plugins install @openclaw/zalouser
• Angeheftete Version: openclaw plugins install @openclaw/zalouser@2026.5.2
• Oder aus einem Source-Checkout: openclaw plugins install ./path/to/local/zalouser-plugin
• Details: Plugins

​

Schnelle Einrichtung (Einsteiger)

1. Stellen Sie sicher, dass das Zalo Personal Plugin verfügbar ist.
   • Aktuelle paketierte OpenClaw-Releases bündeln es bereits.
   • Ältere/benutzerdefinierte Installationen können es manuell mit den obigen Befehlen hinzufügen.
2. Anmelden (QR, auf dem Gateway-Rechner):
   • openclaw channels login --channel zalouser
   • Scannen Sie den QR-Code mit der mobilen Zalo-App.
3. Aktivieren Sie den Kanal:

{
  channels: {
    zalouser: {
      enabled: true,
      dmPolicy: "pairing",
    },
  },
}

4. Starten Sie das Gateway neu (oder schließen Sie die Einrichtung ab).
5. DM-Zugriff verwendet standardmäßig Pairing; genehmigen Sie den Pairing-Code beim ersten Kontakt.

​

Was es ist

• Läuft vollständig im Prozess über zca-js.
• Verwendet native Event-Listener, um eingehende Nachrichten zu empfangen.
• Sendet Antworten direkt über die JS-API (Text/Medien/Link).
• Entwickelt für Anwendungsfälle mit einem „persönlichen Konto“, bei denen die Zalo Bot API nicht verfügbar ist.

​

Benennung

​

IDs finden (Verzeichnis)

openclaw directory self --channel zalouser
openclaw directory peers list --channel zalouser --query "name"
openclaw directory groups list --channel zalouser --query "work"

​

Grenzen

• Ausgehender Text wird in Blöcke von etwa 2000 Zeichen aufgeteilt (Zalo-Client-Grenzen).
• Streaming ist standardmäßig blockiert.

​

Zugriffskontrolle (DMs)

• openclaw pairing list zalouser
• openclaw pairing approve zalouser <code>

​

Gruppenzugriff (optional)

• Standard: channels.zalouser.groupPolicy = "open" (Gruppen erlaubt). Verwenden Sie channels.defaults.groupPolicy, um den Standard zu überschreiben, wenn kein Wert gesetzt ist.
• Auf eine Allowlist beschränken mit:
  • channels.zalouser.groupPolicy = "allowlist"
  • channels.zalouser.groups (Schlüssel sollten stabile Gruppen-IDs sein; Namen werden beim Start nur dann zu IDs aufgelöst, wenn channels.zalouser.dangerouslyAllowNameMatching: true aktiviert ist)
  • channels.zalouser.groupAllowFrom (steuert, welche Absender in erlaubten Gruppen den Bot auslösen können; statische Absender-Zugriffsgruppen können mit accessGroup:<name> referenziert werden)
• Alle Gruppen blockieren: channels.zalouser.groupPolicy = "disabled".
• Der Konfigurationsassistent kann nach Gruppen-Allowlists fragen.
• Beim Start löst OpenClaw Gruppen-/Benutzernamen in Allowlists zu IDs auf und protokolliert die Zuordnung nur, wenn channels.zalouser.dangerouslyAllowNameMatching: true aktiviert ist.
• Gruppen-Allowlist-Abgleich ist standardmäßig ausschließlich ID-basiert. Nicht aufgelöste Namen werden für die Authentifizierung ignoriert, sofern channels.zalouser.dangerouslyAllowNameMatching: true nicht aktiviert ist.
• channels.zalouser.dangerouslyAllowNameMatching: true ist ein Break-Glass-Kompatibilitätsmodus, der veränderliche Namensauflösung beim Start und Gruppen-Namensabgleich zur Laufzeit wieder aktiviert.
• Wenn groupAllowFrom nicht gesetzt ist, fällt die Laufzeit für Gruppen-Absenderprüfungen auf allowFrom zurück.
• Absenderprüfungen gelten sowohl für normale Gruppennachrichten als auch für Steuerbefehle (zum Beispiel /new, /reset).

{
  channels: {
    zalouser: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["1471383327500481391"],
      groups: {
        "123456789": { allow: true },
        "Work Chat": { allow: true },
      },
    },
  },
}

​

Gruppen-Erwähnungs-Gating

• channels.zalouser.groups.<group>.requireMention steuert, ob Gruppenantworten eine Erwähnung erfordern.
• Auflösungsreihenfolge: exakte Gruppen-ID/exakter Name -> normalisierter Gruppen-Slug -> * -> Standard (true).
• Dies gilt sowohl für Gruppen in der Allowlist als auch für den offenen Gruppenmodus.
• Das Zitieren einer Bot-Nachricht zählt als implizite Erwähnung zur Gruppenaktivierung.
• Autorisierte Steuerbefehle (zum Beispiel /new) können das Erwähnungs-Gating umgehen.
• Wenn eine Gruppennachricht übersprungen wird, weil eine Erwähnung erforderlich ist, speichert OpenClaw sie als ausstehende Gruppenhistorie und fügt sie der nächsten verarbeiteten Gruppennachricht hinzu.
• Das Gruppenhistorienlimit ist standardmäßig messages.groupChat.historyLimit (Fallback 50). Sie können es pro Konto mit channels.zalouser.historyLimit überschreiben.

{
  channels: {
    zalouser: {
      groupPolicy: "allowlist",
      groups: {
        "*": { allow: true, requireMention: true },
        "Work Chat": { allow: true, requireMention: false },
      },
    },
  },
}

​

Mehrere Konten

{
  channels: {
    zalouser: {
      enabled: true,
      defaultAccount: "default",
      accounts: {
        work: { enabled: true, profile: "work" },
      },
    },
  },
}

​

Tippen, Reaktionen und Zustellbestätigungen

• OpenClaw sendet vor dem Versand einer Antwort ein Tipp-Ereignis (Best Effort).
• Die Nachrichtenreaktionsaktion react wird für zalouser in Kanalaktionen unterstützt.
  • Verwenden Sie remove: true, um ein bestimmtes Reaktions-Emoji aus einer Nachricht zu entfernen.
  • Reaktionssemantik: Reaktionen
• Für eingehende Nachrichten, die Event-Metadaten enthalten, sendet OpenClaw Zustell- und Gesehen-Bestätigungen (Best Effort).

​

Fehlerbehebung

• openclaw channels status --probe
• Erneut anmelden: openclaw channels logout --channel zalouser && openclaw channels login --channel zalouser

• Verwenden Sie numerische IDs in allowFrom/groupAllowFrom und stabile Gruppen-IDs in groups. Wenn Sie absichtlich exakte Freundes-/Gruppennamen benötigen, aktivieren Sie channels.zalouser.dangerouslyAllowNameMatching: true.

• Entfernen Sie alle alten Annahmen zu externen zca-Prozessen.
• Der Kanal läuft jetzt vollständig in OpenClaw ohne externe CLI-Binärdateien.

​

Verwandte Themen

• Kanalübersicht — alle unterstützten Kanäle
• Pairing — DM-Authentifizierung und Pairing-Ablauf
• Gruppen — Gruppenchatverhalten und Erwähnungs-Gating
• Kanal-Routing — Sitzungsrouting für Nachrichten
• Sicherheit — Zugriffsmodell und Härtung