OpenClaw mit WhatsApp einrichten

Pairing per WhatsApp Web

OpenClaw nutzt das WhatsApp-Web-Protokoll. Befehl:

openclaw channel add whatsapp

QR-Code im Terminal scannen, gleicher Vorgang wie bei WhatsApp Web im Browser. Token wird in der macOS-Keychain (oder Linux-Keystore) abgelegt.

requireMention global aktivieren

Default-Verhalten ist riskant: OpenClaw antwortet potenziell auf jede Nachricht. Ändern in ~/.openclaw/openclaw.json:

{
  "channels": {
    "whatsapp": {
      "requireMention": true,
      "mentionTriggers": ["@molty", "molty,"]
    }
  }
}

Damit reagiert der Bot nur, wenn jemand "@molty" oder "molty," schreibt.

Allowlist konfigurieren

Whitelist von Numbers und Groups, in denen der Bot überhaupt aktiv ist:

{
  "channels": {
    "whatsapp": {
      "allowlist": {
        "groups": ["120363xxx@g.us", "120363yyy@g.us"],
        "users": ["+4915112345678", "+4917698765432"]
      }
    }
  }
}

Außerhalb der Allowlist wird der Bot komplett ignoriert.

Privacy-Defaults

WhatsApp hat per User Privacy-Settings (Read-Receipts, Last-Seen, Profile-Photo). Setze sie bewusst — der Bot hängt an deinem WhatsApp-Account, also gelten dessen Defaults. Empfehlung: Read-Receipts off für Bot-Account, dedizierte Bot-Phone-Number nutzen.

Voice-Memos verarbeiten

Mit aktivem Voice-Setup transkribiert OpenClaw automatisch Voice-Messages. Konfiguration:

openclaw skill enable voice-to-task

Senden eines Voice-Memos an den Bot triggert STT (Whisper), den Skill, und du bekommst Text zurück oder einen erstellten Task im CRM.