WhatsApp KI Bot erstellen: Schritt-für-Schritt Anleitung

Was ist ein WhatsApp KI Bot?

Ein WhatsApp KI Bot ist ein automatisierter Chat-Assistent, der auf deiner WhatsApp-Nummer läuft und mithilfe von KI-Modellen wie Claude oder GPT-4 intelligent auf Nachrichten antwortet — in Einzel- und Gruppenchats, mit Text, Sprache und Bildern.

Stell dir vor: Du schreibst deinem Bot auf WhatsApp "Was steht morgen in meinem Kalender?" — und er antwortet in Sekunden. Oder ein Freund stellt in der Gruppengruppe eine Frage, und dein Bot liefert die Antwort. Das ist kein Zukunftsszenario, das geht heute.

Anders als die simplen Chatbots, die du vielleicht von Kundenservice-Hotlines kennst, nutzt ein KI-Bot moderne Sprachmodelle (LLMs). Er versteht Kontext, merkt sich Gespräche und kann sogar Aufgaben erledigen — E-Mails checken, im Web suchen, Dateien analysieren.

Das Tool dafür: OpenClaw — eine Open-Source-Plattform, die KI-Modelle mit Messaging-Diensten verbindet. Und WhatsApp ist einer der beliebtesten Kanäle. Eine Übersicht über alle Möglichkeiten findest du in Was ist OpenClaw?

Was du brauchst

Für deinen WhatsApp KI Bot brauchst du einen Server (VPS ab €5/Monat oder eigener Mac/Raspberry Pi), einen API-Key für ein KI-Modell (z.B. Anthropic Claude), eine Telefonnummer für WhatsApp und ca. 30–60 Minuten Zeit.

• Server oder Computer: Ein VPS (Hetzner ab €5/Mo), Mac mini, Raspberry Pi 5 oder jeder Linux-Rechner mit 24/7-Betrieb
• Node.js 20+: Die Runtime für OpenClaw
• Anthropic API-Key: Für Claude als KI-Gehirn (alternativ OpenAI für GPT-4)
• Telefonnummer: Für die WhatsApp-Verbindung (Zweitnummer empfohlen)
• Smartphone: Zum QR-Code scannen (einmalig)

Noch keinen Server? In unserem Guide OpenClaw einrichten zeigen wir die komplette Server-Einrichtung. Hier konzentrieren wir uns auf den WhatsApp-Bot.

Schritt 1: Server vorbereiten

Der Server ist das Zuhause deines Bots. Ein günstiger VPS bei Hetzner (CX22, ca. €5/Monat) reicht völlig aus. Du brauchst Ubuntu 22.04+, Node.js 20+ und eine stabile Internetverbindung.

Falls du noch keinen Server hast, hier die Kurzfassung:

VPS bei Hetzner mieten (empfohlen)

1. Gehe zu hetzner.com → Cloud → Neues Projekt
2. Wähle CX22 (2 vCPU, 4 GB RAM) — reicht für einen Bot locker
3. Standort: Falkenstein oder Nürnberg (Deutschland = DSGVO-konform)
4. Image: Ubuntu 24.04
5. SSH-Key hinterlegen (oder Passwort wählen)

Server-Grundlagen einrichten

Per SSH verbinden und die Basics installieren:

# Mit dem Server verbinden
ssh root@DEINE-SERVER-IP

# System updaten
apt update && apt upgrade -y

# Node.js 20 installieren (via NodeSource)
curl -fsSL https://deb.nodesource.com/setup_20.x | bash -
apt install -y nodejs

# Überprüfen
node --version  # Sollte v20.x.x zeigen
npm --version   # Sollte 10.x.x zeigen

Detaillierte Server-Absicherung (Firewall, SSH-Hardening) findest du in OpenClaw Sicherheit. Welche Hardware du genau brauchst, steht in OpenClaw Systemanforderungen.

Schritt 2: OpenClaw installieren

OpenClaw wird über npm installiert — ein einziger Befehl. Der Setup-Wizard führt dich durch die Grundkonfiguration inklusive API-Key und Modellauswahl.

# OpenClaw global installieren
npm install -g openclaw

# Setup-Wizard starten
openclaw init

Der Wizard fragt dich nach:

• KI-Modell: Wähle "Anthropic Claude" (empfohlen) oder OpenAI
• API-Key: Deinen Anthropic API-Key (von console.anthropic.com)
• Modell: Claude 3.5 Sonnet ist das beste Preis-Leistungs-Verhältnis
• Messaging: Wähle "WhatsApp" als Kanal

Nach dem Wizard läuft OpenClaw bereits — aber noch ohne WhatsApp-Verbindung. Das kommt jetzt.

Schritt 3: WhatsApp verbinden (QR-Code)

Die WhatsApp-Verbindung funktioniert über einen QR-Code — genau wie WhatsApp Web. OpenClaw nutzt die Baileys-Library, um sich als WhatsApp-Client zu verbinden. Du scannst einmal den Code, danach bleibt die Session aktiv.

Das ist der spannendste Schritt. OpenClaw verbindet sich mit WhatsApp über die gleiche Methode wie WhatsApp Web — per QR-Code.

WhatsApp in der config.yaml aktivieren

Falls der Wizard WhatsApp nicht automatisch konfiguriert hat, füge es manuell hinzu:

# config.yaml öffnen
nano ~/.openclaw/config.yaml

# WhatsApp-Channel hinzufügen/aktivieren:
channels:
  whatsapp:
    enabled: true

QR-Code scannen

1. Starte OpenClaw (falls noch nicht laufend): openclaw gateway start
2. In den Logs erscheint ein QR-Code im Terminal
3. Öffne WhatsApp auf deinem Smartphone → Verknüpfte Geräte → Gerät hinzufügen
4. Scanne den QR-Code — fertig!

# Logs anzeigen, um den QR-Code zu sehen
openclaw gateway logs

# Oder im Vordergrund starten (für Ersteinrichtung)
openclaw gateway start --foreground

Verbindung testen

Schick dem Bot eine Nachricht von einem anderen Handy oder WhatsApp-Account:

• Schreibe "Hallo, bist du da?" an die Bot-Nummer
• Der Bot sollte innerhalb von 5–15 Sekunden antworten
• Wenn nicht: Logs checken mit openclaw gateway logs

🎉 Glückwunsch! Dein WhatsApp KI Bot läuft. Jetzt machen wir ihn richtig gut.

Schritt 4: Bot-Persönlichkeit konfigurieren (SOUL.md)

Die SOUL.md-Datei ist das Herzstück deines Bots. Sie definiert Persönlichkeit, Tonfall, Sprache und Verhaltensregeln. Ohne SOUL.md antwortet dein Bot generisch — mit SOUL.md wird er einzigartig.

Der Bot antwortet jetzt — aber wie ein generischer Assistent. Die SOUL.md macht ihn zu deinem Bot:

# SOUL.md erstellen
nano ~/.openclaw/workspace/SOUL.md

Beispiel: Persönlicher Assistent

# SOUL.md — Wer du bist

Du bist Max, ein persönlicher KI-Assistent.

## Persönlichkeit
- Freundlich aber direkt — kein Geschwurbel
- Du sprichst Deutsch (du-Form)
- Antworte kurz und knapp, außer es wird mehr verlangt
- Humor ist erlaubt, Sarkasmus in Maßen

## Regeln
- Keine sensiblen Daten an Dritte weitergeben
- Im Zweifel lieber nachfragen als falsch handeln
- Gruppenchats: Nur antworten wenn angesprochen

## Fähigkeiten
- Web-Suche für aktuelle Infos
- Kalender und E-Mail checken
- Bilder analysieren
- Zusammenfassungen erstellen

Beispiel: Kunden-Support-Bot

# SOUL.md — Support-Bot

Du bist der Support-Assistent für [Firmenname].

## Tonfall
- Professionell und freundlich (Sie-Form)
- Immer hilfsbereit, nie genervt
- Bei Beschwerden: Verständnis zeigen, Lösung anbieten

## Wissen
- Produkte: [Liste deiner Produkte]
- Öffnungszeiten: Mo–Fr 9–18 Uhr
- Kontakt: support@firma.de

## Grenzen
- Keine Preise nennen (→ auf Website verweisen)
- Keine Verträge abschließen
- Bei komplexen Problemen: an menschlichen Support weiterleiten

Mehr zur deutschen Konfiguration: OpenClaw auf Deutsch nutzen.

Schritt 5: Gruppenchat-Einstellungen

Im Gruppenchat willst du nicht, dass der Bot auf jede Nachricht antwortet. OpenClaw bietet granulare Kontrolle: Mention-Only-Modus, Allowlist für bestimmte Gruppen und konfigurierbare Trigger-Keywords.

Ein Bot der in Gruppen auf jede Nachricht antwortet? Nervt. So machst du es richtig:

Nur auf Mentions reagieren

# config.yaml — Gruppenchat-Konfiguration
channels:
  whatsapp:
    enabled: true
    groups:
      mode: allowlist          # nur bestimmte Gruppen
      allowlist:
        - "Familie"            # Gruppenname
        - "Arbeit Team"
      requireMention: true     # Nur antworten wenn @erwähnt

Verfügbare Gruppen-Modi

• allowlist: Bot antwortet nur in aufgelisteten Gruppen
• denylist: Bot antwortet überall außer in aufgelisteten Gruppen
• all: Bot antwortet in allen Gruppen (Vorsicht!)
• none: Bot ignoriert alle Gruppen (nur Einzelchats)

Schritt 6: Sprachnachrichten & Bilder

OpenClaw kann eingehende Sprachnachrichten automatisch transkribieren (via Whisper) und auf Bilder reagieren (via Claude Vision). Optional antwortet der Bot selbst per Sprachnachricht — mit natürlichen Stimmen von ElevenLabs oder OpenAI.

Sprachnachrichten empfangen

Standardmäßig transkribiert OpenClaw eingehende Sprachnachrichten automatisch. Stelle sicher, dass ein Whisper-kompatibler Service konfiguriert ist:

# config.yaml
speech:
  stt:
    provider: openai    # Nutzt OpenAI Whisper
    # Alternativ: local (mit whisper.cpp auf dem Server)

Mit Sprachnachricht antworten

Dein Bot kann auch als Sprachnachricht antworten — klingt natürlich und ist praktisch für unterwegs:

# config.yaml
speech:
  tts:
    provider: openai    # oder elevenlabs für Premium-Stimmen
    voice: nova         # Stimmenauswahl

Bilder analysieren

Schick dem Bot ein Foto und er sagt dir was drauf ist. Claude 3.5 Sonnet hat Vision-Fähigkeiten eingebaut — es funktioniert automatisch, wenn du ein Vision-fähiges Modell nutzt.

Beispiele, was der Bot mit Bildern kann:

• 📸 Foto von einer Speisekarte → "Was gibt es für vegetarische Optionen?"
• 📄 Screenshot von einer Fehlermeldung → erklärt das Problem
• 🏷️ Produktfoto → sucht den besten Preis online
• 📊 Chart oder Diagramm → fasst die Key-Findings zusammen

Troubleshooting: Häufige Probleme

Die häufigsten Probleme beim WhatsApp KI Bot sind: QR-Code erscheint nicht, Bot antwortet nicht, Session läuft ab. Hier sind die Lösungen für jedes Problem.

❌ QR-Code erscheint nicht

• Ursache: WhatsApp-Channel nicht aktiviert oder Service nicht gestartet
• Lösung: Prüfe channels.whatsapp.enabled: true in der config.yaml
• Starte neu: openclaw gateway restart
• Logs checken: openclaw gateway logs

❌ Bot antwortet nicht

• API-Key prüfen: Ist der Key gültig? Ist Guthaben vorhanden?
• Logs prüfen: openclaw gateway logs zeigt Fehler
• Gruppen-Modus: Ist der Bot vielleicht auf "none" für Gruppen gestellt?
• Rate Limiting: Anthropic hat Rate Limits — bei neuen Accounts strenger

❌ WhatsApp-Session läuft ab

• Normal: Sessions halten ca. 14 Tage, danach erneut QR-Code scannen
• Tipp: Server nie länger als ein paar Tage komplett offline nehmen
• Multi-Device: Stelle sicher, dass nicht zu viele Geräte verknüpft sind (max. 4)

❌ Bot antwortet zu langsam

• Modell wechseln: Claude 3.5 Haiku ist schneller als Sonnet (und günstiger)
• Server-Standort: Ein Server in Europa (Hetzner) hat weniger Latenz als US-Server
• Context-Länge: Sehr lange Gesprächsverläufe verlangsamen die Antwort

Mehr Lösungen für alle OpenClaw-Probleme: OpenClaw Probleme & Lösungen.

Baileys vs. WhatsApp Business API

OpenClaw nutzt standardmäßig Baileys (Open Source, kostenlos, QR-Code-basiert). Für Unternehmen mit hohem Nachrichtenvolumen gibt es die offizielle WhatsApp Business API (kostenpflichtig, verifiziert). Hier der Vergleich beider Ansätze.

Es gibt zwei Wege, einen Bot mit WhatsApp zu verbinden. OpenClaw nutzt Baileys — aber du solltest den Unterschied kennen:

Nächste Schritte

Dein WhatsApp KI Bot läuft — und jetzt? Hier sind die besten nächsten Schritte:

• Skills aktivieren: Web-Suche, Kalender, E-Mail — mach deinen Bot schlauer. → OpenClaw Skills
• Memory einrichten: Dein Bot merkt sich Gespräche und lernt deine Vorlieben
• Proaktivität aktivieren: Der Bot checkt selbständig E-Mails und erinnert dich an Termine
• Server absichern: Firewall, SSH-Key, automatische Updates → OpenClaw Sicherheit
• Kosten im Blick: Budget-Limits setzen und Modell-Mix nutzen → OpenClaw Kosten

Häufige Fragen zu WhatsApp KI Bots