OpenClaw WhatsApp Kanal

OpenClaw verbindet sich über die Baileys-Bibliothek mit WhatsApp — eine durch Reverse Engineering erstellte Open-Source-Implementierung des WhatsApp Web Multi-Device-Protokolls. Im Gegensatz zur offiziellen WhatsApp Business API (die eine Meta-Genehmigung erfordert und pro Konversation berechnet) verbindet sich Baileys direkt durch Emulation eines verknüpften Geräts. Die Architektur ist unkompliziert: Ihr Telefon bleibt das Hauptgerät, und das Gateway fungiert als verknüpftes Begleitgerät. Nachrichten werden wie gewohnt über WhatsApps Server übertragen — OpenClaw fängt eingehende Nachrichten ab, verarbeitet sie mit Ihrer KI und sendet die Antworten zurück.

Eine dedizierte Telefonnummer wird dringend empfohlen. Obwohl Sie Ihre persönliche Nummer verwenden können, führt das Mischen von persönlichen und Bot-Konversationen zu Routing-Verwirrung und kann Ihre Kontakte stören. Sie benötigen eine echte Telefonnummer, die SMS oder Sprachanrufe für die erste WhatsApp-Registrierung empfangen kann. Nach der Registrierung muss die Nummer nur auf einem Telefon mit installiertem WhatsApp aktiv bleiben.

{
  "channels": {
    "whatsapp": {
      "accounts": {
        "default": {
          "phone": "+15551234567"
        }
      }
    }
  }
}

Nach der Konfiguration Ihres Kanals müssen Sie Ihr Telefon mit dem Gateway koppeln. Führen Sie den Login-Befehl aus, und ein QR-Code erscheint in Ihrem Terminal. Scannen Sie ihn mit WhatsApp auf Ihrem Telefon (Einstellungen → Verknüpfte Geräte → Gerät verknüpfen). Anmeldedaten werden automatisch unter ~/.openclaw/credentials/whatsapp/<accountId>/creds.json gespeichert und bleiben nach Neustarts erhalten. Ein Backup (creds.json.bak) wird automatisch für die Wiederherstellung bei Beschädigung erstellt. Sie müssen den QR-Code nur einmal scannen, es sei denn, die Sitzung läuft ab oder wird manuell widerrufen.

openclaw channels login whatsapp

DM-Richtlinien (Direktnachrichten) steuern, wer mit Ihrem KI-Assistenten interagieren kann. OpenClaw unterstützt vier Richtlinien: • pairing (Standard) — Neue Kontakte müssen einen Pairing-Ablauf durchlaufen. Sie senden eine Nachricht, erhalten einen Pairing-Code, und Sie genehmigen oder lehnen über die CLI ab. Nach der Genehmigung können sie frei chatten. • allowlist — Nur Telefonnummern, die explizit in allowFrom aufgelistet sind, können dem Bot Nachrichten senden. Alle anderen werden stillschweigend ignoriert. • open — Jeder, der die Nummer anschreibt, erhält eine Antwort. In der Produktion mit Vorsicht verwenden. • disabled — Die DM-Verarbeitung ist vollständig deaktiviert. Der Bot antwortet auf keine Direktnachrichten.

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

OpenClaw kann an WhatsApp-Gruppenchats teilnehmen. Standardmäßig ist die Gruppenunterstützung deaktiviert, um unerwünschte KI-Antworten in gemeinsamen Konversationen zu vermeiden. Wenn aktiviert, antwortet der Bot nur, wenn er namentlich erwähnt oder durch ein konfiguriertes Schlüsselwort ausgelöst wird. Sie können steuern, welche Gruppen aktiv sind und wie der Bot aktiviert wird.

{
  "channels": {
    "whatsapp": {
      "groupPolicy": "allowlist",
      "groupActivation": "mention",
      "groupAllowList": ["group-jid-1", "group-jid-2"]
    }
  }
}

Sie können konfigurieren, ob OpenClaw Lesebestätigungen (blaue Häkchen) sendet, wenn eine Nachricht verarbeitet wird. Standardmäßig werden Lesebestätigungen gesendet, um ein natürliches Gesprächsgefühl aufrechtzuerhalten. Das Deaktivieren von Lesebestätigungen kann nützlich sein, wenn der Bot weniger "aktiv" erscheinen soll oder wenn Sie Nachrichten asynchron verarbeiten.

{
  "channels": {
    "whatsapp": {
      "sendReadReceipts": true
    }
  }
}

OpenClaw kann auf eingehende Nachrichten mit einem Emoji reagieren, um den Empfang zu bestätigen, bevor die KI-Antwort bereit ist. Dies ist nützlich, da KI-Antworten mehrere Sekunden dauern können, und die Reaktion dem Absender mitteilt, dass seine Nachricht empfangen wurde. Sie können verschiedene Reaktionen für Direktnachrichten und Gruppenchats konfigurieren oder die Funktion vollständig deaktivieren.

{
  "channels": {
    "whatsapp": {
      "ackReaction": {
        "emoji": "👀",
        "direct": true,
        "group": true
      }
    }
  }
}

OpenClaw unterstützt das Senden von Text, Bildern, Dokumenten, Audio und Video über WhatsApp. Mediendateien werden automatisch verarbeitet — das Gateway lädt sie auf WhatsApps Server hoch und sendet den entsprechenden Nachrichtentyp. Bei langen KI-Antworten wird der Text automatisch aufgeteilt, um innerhalb der WhatsApp-Nachrichtengrößenbeschränkungen zu bleiben. Sie können die Aufteilungsgröße und das Verhalten konfigurieren.

WhatsApp erzwingt Ratenlimits für verknüpfte Geräte. Obwohl es keine offiziell veröffentlichten Limits für persönliche Konten gibt, kann zu schnelles und zu häufiges Senden von Nachrichten vorübergehende Sperren oder Kontobeschränkungen auslösen. OpenClaw enthält eingebaute Ratenbegrenzung zum Schutz Ihres Kontos. Die Standardeinstellungen sind konservativ und für die meisten Anwendungsfälle geeignet.

{
  "channels": {
    "whatsapp": {
      "textChunkLimit": 5,
      "mediaMaxMb": 50
    }
  }
}

Sie fragen sich vielleicht, warum OpenClaw Baileys anstelle der offiziellen WhatsApp Business API (über Twilio, MessageBird usw.) verwendet. Hier sind die Gründe: • Kosten — Die Business API berechnet pro Konversation (etwa 0,005–0,08 $ pro Nachricht je nach Region). Für den persönlichen Gebrauch oder kleine Teams summiert sich das schnell. Baileys ist kostenlos. • Genehmigung — Die Business API erfordert Meta-Verifizierung, ein registriertes Unternehmen und Genehmigung für Nachrichtenvorlagen. Baileys funktioniert mit jedem persönlichen WhatsApp-Konto. • Flexibilität — Die Business API hat strenge Vorlagenanforderungen für ausgehende Nachrichten und ein 24-Stunden-Konversationsfenster. Baileys hat keine solchen Einschränkungen. • Selbst gehostet — Mit Baileys läuft alles auf Ihrem Server. Keine Drittanbieter-API-Anbieter sehen Ihre Nachrichten. Der Kompromiss liegt in der Zuverlässigkeit: Die Business API wird offiziell unterstützt, während Baileys auf Reverse Engineering basiert und bei Protokolländerungen von WhatsApp ausfallen könnte. Für die meisten selbst gehosteten Anwendungsfälle lohnt sich dieser Kompromiss.