​

WhatsApp (Web-Kanal)

​

Installation (bei Bedarf)

• Onboarding (openclaw onboard) und openclaw channels add --channel whatsapp fordern zur Installation des WhatsApp-Plugins auf, wenn du es zum ersten Mal auswählst.
• openclaw channels login --channel whatsapp bietet den Installationsablauf ebenfalls an, wenn das Plugin noch nicht vorhanden ist.
• Dev-Kanal + Git-Checkout: standardmäßig wird der lokale Plugin-Pfad verwendet.
• Stable/Beta: standardmäßig wird das npm-Paket @openclaw/whatsapp verwendet.

openclaw plugins install @openclaw/whatsapp

​

Schnelleinrichtung

{
  channels: {
    whatsapp: {
      dmPolicy: "pairing",
      allowFrom: ["+15551234567"],
      groupPolicy: "allowlist",
      groupAllowFrom: ["+15551234567"],
    },
  },
}

openclaw channels login --channel whatsapp

openclaw channels login --channel whatsapp --account work

openclaw gateway

openclaw pairing list whatsapp
openclaw pairing approve whatsapp <CODE>

​

Bereitstellungsmuster

{
  channels: {
    whatsapp: {
      dmPolicy: "allowlist",
      allowFrom: ["+15551234567"],
    },
  },
}

​

Laufzeitmodell

• Das Gateway verwaltet den WhatsApp-Socket und die Wiederverbindungsschleife.
• Ausgehende Sendungen erfordern einen aktiven WhatsApp-Listener für das Zielkonto.
• Status- und Broadcast-Chats werden ignoriert (@status, @broadcast).
• Direkte Chats verwenden DM-Sitzungsregeln (session.dmScope; standardmäßig reduziert main DMs auf die Hauptsitzung des Agenten).
• Gruppensitzungen sind isoliert (agent:<agentId>:whatsapp:group:<jid>).
• Der WhatsApp-Web-Transport berücksichtigt Standard-Proxy-Umgebungsvariablen auf dem Gateway-Host (HTTPS_PROXY, HTTP_PROXY, NO_PROXY / kleingeschriebene Varianten). Bevorzuge eine Proxy-Konfiguration auf Host-Ebene gegenüber kanalspezifischen WhatsApp-Proxy-Einstellungen.

​

Zugriffskontrolle und Aktivierung

​

Persönliche Nummer und Selbst-Chat-Verhalten

• Lesebestätigungen für Selbst-Chat-Züge überspringen
• Auto-Trigger-Verhalten für Erwähnungs-JIDs ignorieren, das dich sonst selbst anpingen würde
• wenn messages.responsePrefix nicht gesetzt ist, verwenden Selbst-Chat-Antworten standardmäßig [{identity.name}] oder [openclaw]

​

Nachrichten-Normalisierung und Kontext

[Antwort auf <sender> id:<stanzaId>]
<zitierter Text oder Medienplatzhalter>
[/Antwort]

{
  channels: {
    whatsapp: {
      sendReadReceipts: false,
    },
  },
}

{
  channels: {
    whatsapp: {
      accounts: {
        work: {
          sendReadReceipts: false,
        },
      },
    },
  },
}

​

Zustellung, Aufteilung und Medien

​

Reaktionsstufe

{
  channels: {
    whatsapp: {
      reactionLevel: "ack",
    },
  },
}

​

Bestätigungsreaktionen

{
  channels: {
    whatsapp: {
      ackReaction: {
        emoji: "👀",
        direct: true,
        group: "mentions", // always | mentions | never
      },
    },
  },
}

• werden sofort gesendet, nachdem eine eingehende Nachricht akzeptiert wurde (vor der Antwort)
• Fehler werden protokolliert, blockieren aber nicht die normale Antwortzustellung
• der Gruppenmodus mentions reagiert bei durch Erwähnung ausgelösten Zügen; die Gruppenaktivierung always wirkt als Umgehung dieser Prüfung
• WhatsApp verwendet channels.whatsapp.ackReaction (das veraltete messages.ackReaction wird hier nicht verwendet)

​

Multi-Account und Anmeldedaten

​

Tools, Aktionen und Konfigurationsschreibvorgänge

• Die Tool-Unterstützung des Agenten umfasst die WhatsApp-Reaktionsaktion (react).
• Aktionssperren:
  • channels.whatsapp.actions.reactions
  • channels.whatsapp.actions.polls
• Vom Kanal initiierte Konfigurationsschreibvorgänge sind standardmäßig aktiviert (deaktivierbar über channels.whatsapp.configWrites=false).

​

Fehlerbehebung

openclaw channels login --channel whatsapp
openclaw channels status

openclaw doctor
openclaw logs --follow

​

Verweise zur Konfigurationsreferenz

• Konfigurationsreferenz - WhatsApp

• Zugriff: dmPolicy, allowFrom, groupPolicy, groupAllowFrom, groups
• Zustellung: textChunkLimit, chunkMode, mediaMaxMb, sendReadReceipts, ackReaction, reactionLevel
• Multi-Account: accounts.<id>.enabled, accounts.<id>.authDir, Overrides auf Kontoebene
• Betrieb: configWrites, debounceMs, web.enabled, web.heartbeatSeconds, web.reconnect.*
• Sitzungsverhalten: session.dmScope, historyLimit, dmHistoryLimit, dms.<id>.historyLimit

​

Verwandt

• Kopplung
• Gruppen
• Sicherheit
• Kanal-Routing
• Multi-Agent-Routing
• Fehlerbehebung