Clawdbot WhatsApp-Integration

Übersicht über die Clawdbot WhatsApp-Integration

Die Clawdbot WhatsApp-Integration ermöglicht es Ihnen, Ihren persönlichen KI-Assistenten direkt mit WhatsApp zu verbinden, der weltweit beliebtesten Messaging-Plattform. Clawdbot verwendet WhatsApp Web über Baileys, wobei das Gateway die Sitzung besitzt. Dies ermöglicht es Ihnen, Gespräche zu automatisieren, intelligente Antworten zu erhalten und Ihre WhatsApp-Nachrichten durch KI-gestützte Automatisierung zu verwalten.

Warum Clawdbot mit WhatsApp verwenden?

WhatsApp wird von über 2 Milliarden Menschen weltweit genutzt. Durch die Integration von Clawdbot mit WhatsApp erschließen Sie leistungsstarke KI-Funktionen:

Schnelleinrichtung (Anfänger)

1. Verwenden Sie nach Möglichkeit eine separate Telefonnummer (empfohlen)
2. Konfigurieren Sie WhatsApp in ~/.clawdbot/clawdbot.json
3. Führen Sie clawdbot channels login aus, um den QR-Code zu scannen (Verknüpfte Geräte)
4. Starten Sie das Gateway

Minimale Konfiguration:

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

Eine Telefonnummer erhalten

WhatsApp benötigt eine echte Mobilfunknummer zur Verifizierung. VoIP- und virtuelle Nummern werden normalerweise blockiert. Es gibt zwei unterstützte Möglichkeiten, Clawdbot auf WhatsApp auszuführen:

Dedizierte Nummer (Empfohlen)

Verwenden Sie eine separate Telefonnummer für Clawdbot WhatsApp. Dies bietet die beste Benutzererfahrung mit sauberem Routing und ohne Selbstchat-Eigenheiten.

Ideale Einrichtung: Ersatz-/altes Android-Telefon + eSIM. Lassen Sie es mit WLAN und Strom verbunden und verknüpfen Sie es per QR.

WhatsApp Business-Tipp: Sie können WhatsApp Business auf demselben Gerät mit einer anderen Nummer verwenden, um Ihr persönliches WhatsApp getrennt zu halten.

Beispielkonfiguration (dedizierte Nummer, Einzelbenutzer-Zulassungsliste):

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

Persönliche Nummer (Ausweichlösung)

Schnelle Ausweichlösung: Führen Sie Clawdbot auf Ihrer eigenen Nummer aus. Senden Sie sich selbst eine Nachricht (WhatsApp "Nachricht an mich selbst") zum Testen.

Beispielkonfiguration (persönliche Nummer, Selbstchat):

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

Tipps zur Nummernbeschaffung

• Lokale eSIM vom Mobilfunkanbieter Ihres Landes (am zuverlässigsten)
• Prepaid-SIM — günstig, muss nur eine Verifizierungs-SMS empfangen
• Vermeiden: TextNow, Google Voice, die meisten "kostenlosen SMS"-Dienste — WhatsApp blockiert diese aggressiv

Tipp: Die Nummer muss nur eine Verifizierungs-SMS empfangen. Danach bleiben WhatsApp Web-Sitzungen über creds.json bestehen.

Clawdbot WhatsApp einrichten

Voraussetzungen

Bevor Sie Clawdbot mit WhatsApp verbinden, stellen Sie sicher, dass Sie haben:

• Clawdbot auf Ihrem Gerät installiert
• Ein WhatsApp-Konto mit einer aktiven Telefonnummer
• Node.js 22 oder höher

Schritt 1: WhatsApp-Kanal konfigurieren

Fügen Sie die WhatsApp-Konfiguration zu Ihrer ~/.clawdbot/clawdbot.json hinzu:

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

Schritt 2: Mit QR-Code anmelden

Führen Sie den Clawdbot WhatsApp-Anmeldebefehl aus:

clawdbot channels login

Öffnen Sie WhatsApp auf Ihrem Telefon, gehen Sie zu Einstellungen > Verknüpfte Geräte > Gerät verknüpfen, und scannen Sie den von Clawdbot angezeigten QR-Code.

Für Multi-Account-Anmeldung:

clawdbot channels login --account <id>

Schritt 3: Gateway starten

clawdbot gateway --port 18789

Schritt 4: Verbindung überprüfen

Bestätigen Sie, dass Ihre Clawdbot WhatsApp-Integration funktioniert:

clawdbot channels status whatsapp

Clawdbot WhatsApp-Funktionen

Intelligente Nachrichtenverarbeitung

Clawdbot WhatsApp verarbeitet eingehende Nachrichten und generiert kontextbezogene Antworten. Die KI versteht den Gesprächsverlauf und liefert relevante Antworten. Das Modell sieht genug Kontext, um zitierte Antworten zu verstehen.

DM-Richtlinienoptionen

Unterstützung für Gruppennachrichten

Clawdbot WhatsApp unterstützt Gruppengespräche. Direkte Chats verwenden die Hauptsitzung des Agenten; Gruppen bleiben isoliert.

Medienunterstützung

Clawdbot WhatsApp kann verarbeiten und antworten auf:

• Textnachrichten
• Bilder (mit Vision-KI)
• Sprachnachrichten (PTT-Audio mit Transkription)
• Dokumente
• Standortnachrichten

Lesebestätigungen

Clawdbot WhatsApp kann Lesebestätigungen senden, wenn konfiguriert.

Bestätigungsreaktionen

Automatische Reaktion beim Empfang zur Bestätigung des Nachrichtenempfangs.

Clawdbot WhatsApp-Konfiguration

Vollständiges Konfigurationsbeispiel

{
  "channels": {
    "whatsapp": {
      "dmPolicy": "allowlist",
      "allowFrom": ["+15551234567", "+10987654321"],
      "configWrites": true,
      "selfChatMode": false
    }
  }
}

Konfigurationsschreibvorgänge

Standardmäßig darf WhatsApp Konfigurationsaktualisierungen schreiben, die durch /config set|unset ausgelöst werden. Deaktivieren mit:

{
  "channels": {
    "whatsapp": {
      "configWrites": false
    }
  }
}

Clawdbot WhatsApp-Anmeldedatenspeicherung

Clawdbot speichert WhatsApp-Anmeldedaten sicher:

~/.clawdbot/credentials/whatsapp/<accountId>/creds.json

• Sicherungskopie bei creds.json.bak (bei Beschädigung wiederhergestellt)
• Legacy-Kompatibilität: Ältere Installationen speicherten Baileys-Dateien direkt in ~/.clawdbot/credentials/

Ihre WhatsApp-Sitzungsdaten bleiben auf Ihrem lokalen Rechner und gewährleisten Datenschutz.

Fehlerbehebung bei Clawdbot WhatsApp

Verbindung verloren

Wenn Clawdbot WhatsApp die Verbindung trennt:

1. Internetverbindung überprüfen
2. Erneut authentifizieren: clawdbot channels login
3. Protokolle überprüfen: cat /tmp/clawdbot/whatsapp.log

Nachrichten werden nicht gesendet

Wenn Clawdbot WhatsApp keine Nachrichten senden kann:

1. Kontostatus überprüfen: clawdbot channels status whatsapp
2. Zulassungslistenkonfiguration überprüfen
3. Sicherstellen, dass das Clawdbot-Gateway läuft
4. Aktiver Listener ist für ausgehende Sendungen erforderlich

QR-Code abgelaufen

Wenn der Clawdbot WhatsApp QR-Code abläuft:

clawdbot channels logout
clawdbot channels login

Abmelden

Abmelden löscht den WhatsApp-Authentifizierungsstatus (behält aber die gemeinsame oauth.json):

clawdbot channels logout
# oder für ein bestimmtes Konto
clawdbot channels logout --account <id>

Clawdbot WhatsApp Best Practices

1. Dedizierte Nummer verwenden: Eine separate Telefonnummer bietet die beste Erfahrung
2. Klare Grenzen setzen: Zulassungslisten konfigurieren, um den Clawdbot WhatsApp-Zugriff zu kontrollieren
3. Nutzung überwachen: Clawdbot WhatsApp-Protokolle regelmäßig überprüfen
4. Regelmäßig aktualisieren: Clawdbot auf dem neuesten Stand halten für die neueste WhatsApp-Kompatibilität
5. Anmeldedaten sichern: Ihre Clawdbot WhatsApp-Anmeldedaten regelmäßig sichern

Warum nicht Twilio?

WhatsApp Business-Nummern passen schlecht zu einem persönlichen Assistenten:

• Meta erzwingt ein 24-Stunden-Antwortfenster
• Hochvolumige Nutzung löst aggressive Sperrung aus
• Geschäftskonten sind nicht für persönliche Assistentennachrichten gedacht

Nächste Schritte

• Clawdbot Telegram-Integration - Verbinden Sie Clawdbot mit Telegram
• Clawdbot Discord-Integration - Richten Sie Clawdbot auf Discord ein
• Clawdbot-Einrichtungsanleitung - Vollständige Installationsanleitung