OpenClaw auf WhatsApp, ohne die eigene Nummer zu riskieren

Der WhatsApp-Kanal von OpenClaw bindet dein Gateway als verknüpftes Gerät an einen WhatsApp-Account an, mit der Bibliothek Baileys und einem QR-Code. Der Account gehört dir, eine Sperre also auch. Die Doku von OpenClaw empfiehlt eine eigene zweite Nummer: eine SIM, eine eSIM oder einen Prepaid-Anschluss. Willst du diese Nummer lieber nicht selbst besitzen, lässt sich eine verwaltete Nummer mit einer kurzen Bridge über HTTP anbinden.

Wie funktioniert der WhatsApp-Kanal von OpenClaw?

OpenClaw ist ein quelloffenes selbst gehostetes Gateway (MIT-Lizenz), das Chat-Apps mit KI-Agenten verbindet. Sein WhatsApp-Kanal ist laut Doku „production-ready via WhatsApp Web (Baileys)“, und das Gateway besitzt die verknüpfte Session samt ihrer Reconnect-Schleife. Die Doku sagt, dass es keinen eigenen Twilio-WhatsApp-Kanal gibt. Die Fakten in diesem Artikel stammen aus der Doku und dem Repository von OpenClaw, wie wir sie am 19. Oktober 2026 gelesen haben.

Die Einrichtung ist kurz:

1. Plugin installieren: openclaw plugins install @openclaw/whatsapp.
2. Account verknüpfen: openclaw channels login --channel whatsapp. Der Login geht nur per QR, auf einem Headless-Server brauchst du also einen verlässlichen Weg, den aktuellen QR-Code auf dein Smartphone zu bringen.
3. Gateway starten mit openclaw gateway.

Die Standardeinstellung von dmPolicy ist pairing. Ein unbekannter Absender bekommt eine Pairing-Anfrage, die du mit openclaw pairing approve whatsapp <CODE> bestätigst. Anfragen verfallen nach einer Stunde, und jeder Account hält höchstens drei. Weitere Policies sind allowlist (nur Nummern in allowFrom), open und disabled. Der Kanal verarbeitet Direktchats, Gruppen, Bilder, Videos, Audio und Dokumente, und er sendet während der Arbeit eine Tippanzeige und standardmäßig Lesebestätigungen.

Das Verknüpfen geschieht durch Scannen mit einem Smartphone, die Nummer lebt also auf einem Telefon, und OpenClaw läuft als verknüpftes Gerät mit. Dieses Detail erklärt das meiste des Folgenden.

Warum will OpenClaw eine zweite Nummer?

Die Doku von OpenClaw empfiehlt aus Gründen der Zugriffskontrolle eine eigene Nummer, und die Seiten von WhatsApp beschreiben ein Risiko, das die WhatsApp- und Setup-Seiten von OpenClaw nicht erörtern.

Die Seite von WhatsApp definiert inoffizielle Apps als gefälschte WhatsApp-Apps und Websites von Drittanbietern und nennt weder OpenClaw noch Baileys. OpenClaw ist ein Drittanbieter-Client, der sich als Gerät verknüpft. Geh deshalb davon aus, dass die Warnung auch für dich gilt. Eine zweite Nummer begrenzt den Schaden: Sperrt WhatsApp den Account, ist es die Nummer des Assistenten und nicht die, die deine Familie und deine Kunden benutzen.

Der Modus mit persönlicher Nummer ist ein unterstützter Ausweg. Das Onboarding schreibt dann dmPolicy: "allowlist", deine eigene Nummer in allowFrom und selfChatMode: true, und die Doku warnt, dass ein Liveness-Check an deine eigene Nummer zur Eingabe des Agenten werden kann, solange du nicht selfChatMode: false setzt.

Wie bekommst du die zweite Nummer?

Die 14-Tage-Regel stammt von der Seite zu verknüpften Geräten bei WhatsApp, die außerdem sagt, dass verknüpfte Geräte ohne Online-Telefon funktionieren und sich nach 30 Tagen Inaktivität trennen. Wenn du OpenClaw schon mit deiner persönlichen Nummer betreibst, füge den Assistenten als benannten Account hinzu, statt neu zu installieren: openclaw channels login --channel whatsapp --account assistant. Accounts liegen unter channels.whatsapp.accounts.<id>, und jeder behält seine eigenen Zugangsdaten.

Wie bleibst du mit OpenClaw ungesperrt?

Keine Einstellung ist als sperrsicher dokumentiert, und WhatsApp entscheidet. Diese Gewohnheiten passen zu dem, was die Doku und WhatsApp sagen:

• Nutze eine Allowlist. Setze dmPolicy: "allowlist" und allowFrom auf die Leute, die den Agenten erreichen sollen. Der Standardmodus Pairing zwingt dich bereits, unbekannte Absender zu bestätigen.
• Halte die Tool-Policy eng. Der Leitfaden von OpenClaw sagt, ein verbundener Agent kann je nach Policy Befehle ausführen, Dateien nutzen und in deinem Namen Leuten schreiben. Ein Agent, der Leuten schreibt, die ihm nie geschrieben haben, ist eine Kaltnachricht von deiner Nummer, eines der Signale, die Warum WhatsApp Nummern sperrt behandelt.
• Sichere vor dem erneuten Verknüpfen. Kopiere ~/.openclaw/credentials/whatsapp/<accountId>, führe dann openclaw channels logout und openclaw channels login aus, wie es die Troubleshooting-Doku beschreibt.
• Wärme die Nummer zuerst auf. So wärmst du eine neue WhatsApp-Nummer auf (Warm-up) trennt, was bekannt ist, von dem, was Community-Praxis ist.

Kann OpenClaw eine verwaltete Nummer wie whasp nutzen?

Nicht über den WhatsApp-Kanal. Dieser Kanal ist WhatsApp Web über Baileys, und die Doku von OpenClaw führt keinen anderen WhatsApp-Transport auf. whasp ist eine HTTP-API: Eingehende Nachrichten kommen an deinem Webhook an, und ein API-Aufruf antwortet. OpenClaw kann whasp also nicht von Haus aus als sein WhatsApp verwenden. Es hat aber zwei dokumentierte Wege.

Der OpenAI-kompatible Endpoint des Gateways. Der Endpoint /v1/chat/completions von OpenClaw ist standardmäßig deaktiviert und führt einen normalen Agenten-Turn aus. Das Feld model benennt einen Agenten (openclaw/<agentId>), und ein OpenAI-String user ergibt eine stabile Session, sodass wiederholte Aufrufe eine Unterhaltung fortsetzen. Eine Bridge verbindet beide Seiten:

import { createServer } from "node:http";
import { Webhook } from "standardwebhooks";

const wh = new Webhook(process.env.WHASP_WEBHOOK_SECRET); // whsec_... von whasp
const seen = new Set(); // Deduplizierung über die Event-ID (nimm in Produktion einen echten Speicher)

async function askOpenClaw(user, text) {
  const res = await fetch(`${process.env.OPENCLAW_URL}/v1/chat/completions`, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.OPENCLAW_TOKEN}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      model: process.env.OPENCLAW_AGENT ?? "openclaw/default",
      user, // gleicher Wert pro Unterhaltung = gleiche OpenClaw-Session
      messages: [{ role: "user", content: text }],
    }),
  });
  if (!res.ok) throw new Error(`OpenClaw answered ${res.status}`);
  const data = await res.json();
  return data.choices?.[0]?.message?.content ?? "";
}

async function sendToWhasp(to, text, eventId) {
  const res = await fetch("https://api.whasp.ai/v1/messages", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.WHASP_API_KEY}`,
      "Content-Type": "application/json",
      "Idempotency-Key": eventId,
    },
    body: JSON.stringify({ to, text: text.slice(0, 4096) }),
  });
  if (!res.ok) throw new Error(`whasp answered ${res.status}`);
}

createServer(async (req, res) => {
  if (req.method !== "POST") return res.writeHead(405).end();
  const chunks = [];
  for await (const chunk of req) chunks.push(chunk);
  const body = Buffer.concat(chunks).toString("utf8"); // Raw Body, vor dem Parsen

  let event;
  try {
    event = wh.verify(body, req.headers);
  } catch {
    return res.writeHead(401).end();
  }
  res.writeHead(204).end(); // jetzt bestätigen, danach arbeiten

  if (event.type !== "message.received" || seen.has(event.id)) return;
  seen.add(event.id);
  const { number, chat, text } = event.data.message;
  if (!text || /^(STOP|UNSUBSCRIBE|OPTOUT|CANCEL|END|QUIT)$/.test(text.trim())) return; // whasp übernimmt den Opt-out

  try {
    const answer = await askOpenClaw(`whasp:${number}:${chat}`, text);
    if (answer) await sendToWhasp(chat, answer, event.id);
  } catch (err) {
    console.error(event.id, err.message);
  }
}).listen(8790);

Wir haben das gegen Mock-Server für beide APIs ausgeführt, gebaut nach der Dokumentation von OpenClaw und whasp. Gegen ein echtes OpenClaw-Gateway haben wir es nicht ausgeführt. Zum Einsatz aktivierst du gateway.http.endpoints.chatCompletions.enabled, registrierst die öffentliche HTTPS-URL der Bridge mit PUT /v1/webhook und setzt WHASP_WEBHOOK_SECRET, WHASP_API_KEY, OPENCLAW_URL (die Doku nutzt http://127.0.0.1:18789), OPENCLAW_TOKEN und OPENCLAW_AGENT. Signaturprüfung und Duplikatbehandlung erklärt WhatsApp-Webhooks verarbeiten: Signatur, Retries, Duplikate.

Drei Dinge, auf die du achten musst. Erstens nennt die Doku von OpenClaw diesen Endpoint vollen Operator-Zugriff auf das Gateway: Halte ihn auf Loopback oder in einem privaten Netz, sodass nur die Bridge ihn aufrufen kann. Zweitens sind Texte von Fremden nicht vertrauenswürdige Eingaben, richte OPENCLAW_AGENT also auf einen eigenen Agenten, dessen Tools du eingeschränkt hast. Das README von OpenClaw sagt, du sollst eingehende Nachrichten als nicht vertrauenswürdige Eingabe behandeln. Drittens sieht OpenClaw jetzt einen generischen API-Client und keinen WhatsApp-Kanal. Pairing, Allowlists, Gruppen, Reaktionen, Tippanzeige und Sprachnachrichten gelten dafür nicht, und whasp hat eigene Grenzen: Nutzer schreiben zuerst, und es gibt keine Gruppen, keine Tippanzeigen und keine ausgehenden Sprachnachrichten.

Ein Kanal-Plugin. Die Doku von OpenClaw sagt, du sollst ein Kanal-Plugin bauen, wenn du ein externes Messaging-Netz mit eigener Webhook-Zustellung oder eigenem ausgehenden Transport anbindest. Das ergibt natives Routing und native Zugriffskontrolle, zum Preis, dass du TypeScript gegen das Plugin-SDK schreibst und pflegst. Wir haben keines gebaut.

Was du als Nächstes tun kannst

Wähle den Weg danach, wer dem Agenten schreiben wird:

• Nur du. Eine Prepaid-SIM oder eSIM plus der eigene Kanal von OpenClaw ist ein vernünftiges Setup, solange du akzeptierst, dass die Nummer das Risiko ist. Lass dmPolicy auf allowlist.
• Ein paar Leute, die du kennst. Dasselbe Setup, mit jeder Person in allowFrom oder per Pairing bestätigt, und einer Tool-Policy, mit der du leben kannst, falls einer von ihnen nachlässig ist.
• Kunden oder Fremde. Setze den Account dorthin, wo eine Sperre deine eigene Nummer nicht berührt: eine verwaltete Nummer über die Bridge oben oder die offizielle WhatsApp Business Platform, wenn dein Bot sich dafür qualifiziert.

Inoffizielle WhatsApp-APIs im Vergleich legt die Abwägungen zwischen den selbst betriebenen Optionen dar, und WhatsApp-MCP-Server zeigt einen weiteren Weg, einem Agenten eine Nummer zu geben.