Offizielles WeChat-Plugin · QR-Bindung · Einzelchat-Limits · Gateway 24/7 · DSGVO-Hinweise
Sie wollen den offiziellen WeChat ClawBot an Ihr laufendes OpenClaw Gateway hängen — und stoßen auf abgelaufene QR-Codes, fehlende Grau-Plugins oder Nachrichten, die nach einem Gateway-Neustart verschwinden. Dieser Leitfaden richtet sich an Entwickler und kleine Teams, die npx @tencent-weixin/openclaw-weixin-cli produktiv nutzen wollen: zuerst die Architektur (offizielles Plugin vs. inoffizielle Brücke), dann Voraussetzungen und DSGVO-relevante Kontotrennung, anschließend ein sechsstufiges Runbook für Installation, Bindung und Abnahme. Ergänzend lesen Sie die Gateway-Install-Checkliste und Mehrkanal-Härtung.
2026 stellt Tencent ein offizielles OpenClaw-Plugin bereit, das WeChat als Kanal neben Telegram, Discord und Slack an dieselbe Steuerebene anschließt. Der Kanal-Adapter lebt im Gateway; Skills, Modell-Routing und Tool-Aufrufe bleiben unverändert. Das unterscheidet ClawBot von inoffiziellen Web-WeChat-Brücken, die oft gegen Nutzungsbedingungen verstoßen, keine saubere Session-Wiederherstellung bieten und für Produktion untauglich sind.
Das Paket @tencent-weixin/openclaw-weixin-cli kapselt Plugin-Installation, QR-Generierung und Erstbindung. OpenClaw selbst verwaltet Heartbeats, Webhook-Empfang und Weiterleitung an den Agent. Wer bereits Telegram betreibt, addiert WeChat als zweiten Kanal — nicht als Ersatz für Gateway-Härtung. Für EU-Teams zählt hier die DSGVO: Chat-Inhalte, Kontakt-Metadaten und Agent-Logs können personenbezogene Daten enthalten. Gateway und Logs auf einem dedizierten Remote-Knoten mit dokumentierter Verarbeitung reduzieren unkontrollierte Datenflüsse über Drittanbieter-Brücken.
Offizielles Plugin: Von Tencent gepflegt, an OpenClaw-Versionen gekoppelt; Updates über npm oder openclaw plugins.
Inoffizielle Brücke: Hohes Sperr-Risiko, fragiles Protokoll — nur für Experimente, nicht für Kundenverkehr.
Gateway als Single Control Plane: Ein Gateway, mehrere Kanäle; WeChat teilt Modell-Backend und Skill-Registry mit Telegram.
Grau-Release: WeChat-Client und Plugin sind oft nur für ausgewählte Konten freigeschaltet — ohne Grau kein stabiler Kanal.
Einzelchat-Fokus: Produktionslimits (kein Gruppenbot wie bei Telegram) früh in Architektur-Reviews festhalten.
Wer diese fünf Punkte vor dem ersten QR-Scan versteht, vermeidet die häufigste Fehlannahme: dass ein grüner openclaw doctor automatisch WeChat-Grau und Handy-Erreichbarkeit garantiert.
Bevor Sie npx ausführen, prüfen Sie vier Gates. Fehlende Grau-Freigabe ist der häufigste Showstopper — kein Runbook ersetzt ein Konto ohne Plugin-Zugang.
| Gate | Prüfung | Typisches Ergebnis |
|---|---|---|
| WeChat-Client | Aktuelle Version, Grau-Plugin sichtbar | Ohne Grau: QR erscheint nicht oder Bindung bricht ab |
| OpenClaw | Node 22.14+, openclaw gateway status grün | Gateway muss vor QR laufen, nicht danach |
| Kontostrategie | Realname-Konto vs. Test-Subkonto | Produktion: dediziertes Konto; DSGVO: Trennung privat/geschäftlich dokumentieren |
| Host 24/7 | Laptop vs. Remote-Mac/VPS | Schlafender Laptop killt Callbacks — siehe Dauerbetrieb Cloud-Mac |
WeChat ClawBot ist kein „Handy-only“-Spielzeug: der Gateway-Host muss erreichbar bleiben, solange Sie Antworten erwarten.
Für Teams mit gemischten Kanälen empfiehlt sich ein dedizierter WeChat-Testaccount, der nicht mit persönlichen Chats vermischt wird — relevant für interne Compliance und DSGVO-Dokumentation (Zweckbindung, Löschfristen in Gateway-Logs). Produktions-Gateway gehört auf einen planbaren 24/7-Knoten; Docker-Isolation siehe Compose-Baseline.
Zwei Wege führen zum gleichen Ziel; wählen Sie einen pro Umgebung und dokumentieren Sie ihn im Change-Ticket.
One-Shot npx: npx @tencent-weixin/openclaw-weixin-cli install — installiert Plugin, startet Bindungsassistent, zeigt QR im Terminal oder Browser.
Manuell Schritt 1: openclaw plugins install @tencent-weixin/openclaw-weixin
Manuell Schritt 2: Gateway neu starten — openclaw gateway restart
Manuell Schritt 3: openclaw channels add weixin (exakter Subcommand laut CLI-Hilfe)
Manuell Schritt 4: QR binden und Erstkontakt in WeChat bestätigen
openclaw gateway status npx @tencent-weixin/openclaw-weixin-cli install openclaw gateway restart openclaw logs --follow
Hinweis: Bei langsamen npm-Mirrors oder Corporate-Proxy zuerst Registry und npm config prüfen — halbfertige Plugin-Installationen erzeugen „Gateway grün, Kanal tot“-Symptome.
Der manuelle Pfad eignet sich für GitOps und Docker-Images, in denen npx zur Laufzeit unerwünscht ist. Beide Pfade setzen voraus, dass openclaw onboard --install-daemon bereits auf dem Host ausgeführt wurde — Details in der Install-Checkliste.
Die Abnahme folgt einer festen Reihenfolge; jeden Schritt ins Ticket kopieren.
QR generieren: Gültigkeitsfenster beachten — abgelaufene Codes sind die Top-Fehlerquelle; bei Timeout neu generieren, nicht Gateway wild neu starten.
In WeChat scannen: Offiziellen ClawBot-Kontakt bestätigen; bei fehlendem Grau-Plugin bricht der Flow hier ab.
Erstkontakt sichtbar: Neuer Chat-Eintrag im Client; ohne Eintrag: Gateway-Logs und Plugin-Version prüfen.
Echo-Roundtrip: Kurze Textnachricht senden, Antwort innerhalb SLA (typisch Sekunden bis wenige Minuten je Modell-Backend).
Neustart-Test: openclaw gateway restart, erneut Nachricht — Session sollte ohne erneuten QR halten (Soft-Restart); Hard-Deploy kann Re-Bind erfordern.
| Aspekt | WeChat ClawBot | Telegram (Referenz) |
|---|---|---|
| Bindung | QR + Grau-Plugin | BotFather-Token, kein QR |
| Chat-Typ | Primär Einzelchat | Gruppen und Kanäle üblich |
| Dateien | Produktlimits beachten | Bot-API flexibler |
| Callback | Gateway 24/7 + erreichbare Ports | Gleiche Gateway-Anforderung |
| Compliance | Regionale WeChat-Regeln, DSGVO bei EU-Nutzern | Andere Datenschutz-Profile |
| Symptom | Zuerst prüfen | Typische Maßnahme |
|---|---|---|
| QR abgelaufen | Zeitfenster, Terminal geschlossen | Neuen QR generieren; screen für Remote-Session |
| Keine eingehende Nachricht | Gateway down, Firewall, Plugin-Version | openclaw gateway status; Logs Phase 1 Plugin |
| Antwort nach Restart weg | Session-Persistenz, harter Deploy | Soft-Restart vs. Image-Rebuild trennen; ggf. Re-Bind |
| npm / npx Fehler | Mirror, Proxy, Node-Version | Registry wechseln; manuellen Plugin-Pfad |
| Gruppenchat gewünscht | Produktscope 2026 | Nicht unterstützt — Architektur anpassen oder anderen Kanal |
Achtung: Nicht in einem Ticket gleichzeitig WeChat Re-Bind, Modell-Backend-Wechsel und Telegram-Webhook drehen — kein sauberes Bisect möglich.
WeChat ClawBot in Produktion bedeutet: Gateway und Plugin in isoliertem Container oder dediziertem Host, Monitoring auf Kanal-Latenz, Runbook für Re-Bind nach Deploy. Logs lesen Sie in drei Phasen — Plugin (Bindung, QR), Gateway (Routing, Heartbeat), Modell-Backend (Timeout, Kontext) — statt alles als „WeChat kaputt“ zu labeln.
Laptop-Gateways scheitern an Sleep und NAT; IM-Kanäle brauchen dieselbe 24/7-Disziplin wie Telegram. Wer dedizierte Kapazität, stabile Callbacks und auditierbare Changes braucht — in der EU oft auch wegen DSGVO und klarer Datenresidenz auf dem Mietknoten — findet in der VpsMesh Mac Mini Cloud-Miete die passende Basis: WeChat- und Telegram-Kanäle co-lokalisieren, Runbooks mit Mehrkanal-Härtung verzahnen. Mietpreise, Hilfezentrum, Bestellen.
Ja. Beide Kanäle hängen am selben OpenClaw Gateway; Skills und Modell-Routing werden geteilt. Voraussetzung: Gateway 24/7, erreichbare Callbacks und getrennte Abnahme pro Kanal — siehe Mehrkanal-Härtung.
Typisch: abgelaufener QR, Gateway war beim Scan offline, kein Grau-Plugin in WeChat, oder Corporate-Firewall blockiert den Host. Neuen QR erzeugen, openclaw gateway status prüfen, Grau-Freigabe verifizieren — nicht zuerst das Modell-Backend wechseln.
Soft-Restart sollte die WeChat-Session halten; nach Image-Rebuild oder Plugin-Upgrade kann Re-Bind nötig sein. Logs in drei Phasen lesen; für dauerhaften Betrieb Gateway auf Remote-Mac migrieren — 24/7-Leitfaden, Mietpreise.