​

Zalo Personal (inoffiziell)

Warnung: Dies ist eine inoffizielle Integration und kann zur Sperrung/Blockierung des Kontos führen. Verwendung auf eigenes Risiko.

​

Gebündeltes Plugin

• Über CLI installieren: openclaw plugins install @openclaw/zalouser
• Oder aus einem Quellcode-Checkout: openclaw plugins install ./path/to/local/zalouser-plugin
• Details: Plugins

​

Schnelle Einrichtung (für Einsteiger)

1. Stellen Sie sicher, dass das Zalo-Personal-Plugin verfügbar ist.
   • Aktuelle paketierte OpenClaw-Releases enthalten 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. Der DM-Zugriff verwendet standardmäßig Pairing; genehmigen Sie beim ersten Kontakt den Pairing-Code.

​

Was es ist

• Läuft vollständig im Prozess über zca-js.
• Verwendet native Ereignis-Listener zum Empfangen eingehender Nachrichten.
• Sendet Antworten direkt über die JS-API (Text/Medien/Link).
• Entwickelt für Anwendungsfälle mit „persönlichen Konten“, 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"

​

Einschränkungen

• Ausgehender Text wird auf etwa 2000 Zeichen segmentiert (Zalo-Client-Limits).
• Streaming ist standardmäßig blockiert.

​

Zugriffssteuerung (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 er nicht 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 nach Möglichkeit zu IDs aufgelöst)
  • channels.zalouser.groupAllowFrom (steuert, welche Absender in erlaubten Gruppen den Bot auslösen können)
• 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.
• Der Abgleich mit der Gruppen-Allowlist erfolgt standardmäßig nur per ID. Nicht aufgelöste Namen werden für die Authentifizierung ignoriert, sofern nicht channels.zalouser.dangerouslyAllowNameMatching: true aktiviert ist.
• channels.zalouser.dangerouslyAllowNameMatching: true ist ein Kompatibilitätsmodus für Notfälle, der den Abgleich mit veränderlichen Gruppennamen wieder aktiviert.
• Wenn groupAllowFrom nicht gesetzt ist, verwendet die Runtime allowFrom als Fallback für Prüfungen von Gruppenabsendern.
• 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 },
      },
    },
  },
}

​

Mention-Gating für Gruppen

• channels.zalouser.groups.<group>.requireMention steuert, ob Antworten in Gruppen eine Erwähnung erfordern.
• Auflösungsreihenfolge: exakte Gruppen-ID/-Name -> normalisierter Gruppen-Slug -> * -> Standard (true).
• Dies gilt sowohl für allowlistete Gruppen als auch für den offenen Gruppenmodus.
• Autorisierte Steuerbefehle (zum Beispiel /new) können das Mention-Gating umgehen.
• Wenn eine Gruppennachricht übersprungen wird, weil eine Erwähnung erforderlich ist, speichert OpenClaw sie als ausstehende Gruppenhistorie und fügt sie bei der nächsten verarbeiteten Gruppennachricht ein.
• Das Limit der Gruppenhistorie verwendet 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 Senden einer Antwort ein Tippen-Ereignis (Best-Effort).
• Die Nachrichtenreaktionsaktion react wird für zalouser bei Kanalaktionen unterstützt.
  • Verwenden Sie remove: true, um ein bestimmtes Reaktions-Emoji aus einer Nachricht zu entfernen.
  • Reaktionssemantik: Reactions
• Für eingehende Nachrichten, die Ereignismetadaten enthalten, sendet OpenClaw Zustellungs- 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/groups oder exakte Freundes-/Gruppennamen.

• Entfernen Sie alle Annahmen über alte externe zca-Prozesse.
• Der Kanal läuft jetzt vollständig in OpenClaw ohne externe CLI-Binärdateien.

​

Verwandt

• Channels Overview — alle unterstützten Kanäle
• Pairing — DM-Authentifizierung und Pairing-Ablauf
• Groups — Verhalten von Gruppenchats und Mention-Gating
• Channel Routing — Sitzungsrouting für Nachrichten
• Security — Zugriffsmodell und Härtung