2026 WeChat ClawBot für OpenClaw:
offizielles Plugin via npx @tencent-weixin/openclaw-weixin-cli, QR-Bindung und Hinweise bei Tagmiete macOS-Isolation
Wer bereits ein selbst gehostetes OpenClaw-Gateway betreibt, möchte WeChat oft in dieselbe Steuerungsebene wie Telegram oder Microsoft Teams — WeChat ist jedoch kein «weiterer Bot-API-Webhook». Tencents WeChat ClawBot ist ein offizieller Kanal-Plugin-Pfad mit npx @tencent-weixin/openclaw-weixin-cli, QR-Login und harten Produktgrenzen: nur Einzelchat (keine Gruppen), Dateien nur eingehend, Inhaltsprüfung und Gateway muss online bleiben. Dieser Leitfaden liefert drei Schmerzcluster, eine Entscheidungsmatrix, sieben Schritte, Triage-Tabelle, drei Kennzahlen und Mac-Vergleich — mit Links zum Installationsguide, Telegram/Discord Kopplung und Allowlist, Microsoft Teams Dev Tunnel und Webhook 3978 sowie SSH/VNC FAQ.
Inhaltsverzeichnis
01. Drei Schmerzcluster nach ClawBot-Aktivierung
1) QR-Bindung klappt einmal, dann bricht die Session ab: ClawBot hängt an einem laufenden Gateway und der Weixin-Bridge. Laptop-Sleep, Prozess-Killer ohne systemd/launchd oder nächtliche Neustarts erzeugen stille Desynchronisation: Der Bot-Kontakt bleibt in WeChat sichtbar, aber openclaw channels status --probe sieht nichts. Erste Maßnahme: Gateway-Uptime und Restart-Reihenfolge, nicht Modellrouting.
2) Produktpolitik — Gruppen, ausgehende Dateien, Review-Latenz: ClawBot ist nur 1:1-Privatchat, keine Gruppen, kein @all. Dateien sind nur eingehend zum Bot; PDF-Rückkanäle wie bei Slack sind nicht planbar. Ausgehende Texte/Media durchlaufen Tencent-Inhaltsprüfung — Verzögerungen wirken wie «langsames LLM». Stakeholder vor dem Pilot trennen: Review-Queue vs. Token-Latenz.
3) Falsche Kontoklasse: Haupt-WeChat mit Zahlungen und Familien-Chats bündelt Risiko. Nutzen Sie ein Ersatzkonto mit Minimalrechten und dokumentieren Sie Geräte-Hoheit für QR-Re-Auth. Pairing-Logik aus dem Telegram/Discord-Guide hilft bei Allowlists; WeChat scheitert oft auf Kontoebene.
02. Entscheidungsmatrix: ClawBot vs. andere Kanäle
| Dimension | WeChat ClawBot | Telegram / Discord | Microsoft Teams |
|---|---|---|---|
| Installation | npx @tencent-weixin/openclaw-weixin-cli | Bot-Token / OAuth + channels.* | Azure Bot + Tunnel :3978 |
| Bindung | QR-Scan mobil | Token / Pairing-Codes | Tenant-App + Endpoint |
| Chat-Form | Nur Einzelchat | DM + Gruppen mit Allowlist | Teams/Kanäle mit Tenant-Policy |
| Dateien | Nur eingehend | Bidirektional je Kanal | Anhänge Bot Framework |
| Moderation | Tencent Review | Plattform-ToS + eigene Policy | Enterprise-DLP + Policy |
| Uptime | Gateway dauerhaft online | Webhook/Long-Poll toleranter | Öffentliches HTTPS |
| Miet-Evidenz | QR-Screenshot + 24h-Uptime + Probe-JSON | Pairing-Export + Gruppen-Probe | Tunnel-URL + Listen :3978 |
ClawBot ablehnen, wenn die Anforderung «Projektgruppe», «Datei zurück per WeChat» oder «Gateway darf schlafen» lautet — dann Teams oder Telegram priorisieren.
03. Sieben Umsetzungsschritte
- Baseline einfrieren:
openclaw --version, Config-Pfad,plugins list,channels list --all. - Ersatzkonto: Dediziertes WeChat mit Minimalrechten; kein Kundenverkehr vor Policy-Freigabe.
- Offizielles CLI:
npx @tencent-weixin/openclaw-weixin-cli; Plugin im Gateway aktivieren; einmal neu starten. - QR auf stabilem Host: Gateway mit Supervision; QR scannen; Zeitstempel-Screenshot archivieren.
- Kanal-Policy: Allowlist nur für Pilotnutzer; keine Gruppen-Keys aus Telegram-Configs kopieren.
- Probe Text + Datei: Kurztext und kleine eingehende Datei; Review-Verzögerung bei Ausgang notieren.
- Evidenz und Wipe: Probe-JSON, Uptime-Snippet, Logs redigieren; QR-Artefakte auf Miet-Host löschen.
openclaw --version
openclaw plugins list 2>&1 | tee /tmp/oc-weixin-plugins-before.txt
npx @tencent-weixin/openclaw-weixin-cli
openclaw gateway restart
openclaw channels status --probe 2>&1 | tee /tmp/oc-weixin-probe.txt
openclaw doctor 2>&1 | tee /tmp/oc-weixin-doctor.txtMindestens 15 GB freier Speicher auf dem Bind-Host. Bandbreite und Desktop während des QR-Fensters: FAQ. Nicht parallel WeChat-Bind und Teams-Tunnel-Cutover am selben Nachmittag.
04. Triage-Tabelle
| Symptom | Erste Aktion | Falscher Schritt |
|---|---|---|
| QR gescannt, keine Inbound | Gateway läuft? Plugin enabled? Probe erneut | Globales openclaw ohne Plugin-Pfad |
| Gestern OK, heute tot | Sleep/Restart-Log prüfen; supervised service | Zuerst Modell-Provider beschuldigen |
| Bot in Gruppe | Einzelchat-Policy erklären; Pilot in DM | Telegram-groupPolicy blind kopieren |
| Ausgehende Datei erwartet | Lieferung per E-Mail/Teams | File-Tool auf Kanal erzwingen |
| Lange Verzögerung, Duplikat | Review-Queue; Prompts entschärfen | max_tokens blind erhöhen |
| Konto eingeschränkt | Automation pausieren; Ersatzkonto | QR-Rebind-Schleifen auf Hauptkonto |
05. Kennzahlen und 1–3-Tage-Mietplan
- Kennzahl 1: Einzelchat, keine Gruppen, Dateien nur eingehend, Review auf Ausgang sind Produkt-Gates — keine OpenClaw-Bugs.
- Kennzahl 2: Auf überwachtem M4-Miethost passen QR-Bind plus erste Probe oft in 2–4 Stunden; halber Tag für Review-Latenz unter realistischen Prompts.
- Kennzahl 3: Haupt-WeChat-Bindungen erzeugen disproportionale Re-Auth- und Sperr-Tickets vs. Ersatzkonten mit Minimalrechten.
Tag 1: Baseline per Installationsguide; npx + QR + Text-Probe. Tag 2: Eingehende Datei; drei Ausgangs-Templates unter Review. Tag 3: Stakeholder-Limits; Miet-Host wischen; Probe-JSON ans Change-Ticket.
06. Headless Linux vs. Tagmiete Mac
Ein VPS hält Gateway-Uptime günstig; bei WeChat zählen QR-Ergonomie, Telefon-Hoheit und Evidenzkette. Logs über drei Besitzer verteilt erzeugt «Tunnel-Drift» ohne Tunnel — die Session stirbt, wenn der Bridge-Host schläft.
Linux headless passt bei 24×7-Gateways mit Monitoring und on-call für das Ersatz-Handy. Tagmiete Mac bündelt CLI, Control UI, Keychain und QR in 1–3 Tagen für Security-Review ohne Session-Material auf dem Daily Driver. Siehe Preisleitfaden und FAQ. WeChat als beschriftete Nebenstrecke neben Telegram (Gruppen) und Teams (Enterprise).