2026 Tencent WeChat ClawBot mit OpenClaw: Installation, Versionskompatibilitaet und Mac-VPS-Runbook (Entscheidungsmatrix und FAQ)

1. Schmerzpunkte: kein ClawBot, Versionskonflikt, QR und Disconnect

Personal-WeChat unterscheidet sich fundamental von Enterprise WeChat (WeCom): Tencent kontrolliert Grauzonen-Rollout, Protokollversion und Datenegress. Vier Muster dominieren Support-Tickets im Fruehjahr 2026.

1. Kein ClawBot-Eintrag: Client noch nicht in der Grauzone — kein Plugin-Menu, CLI installiert erfolgreich, aber kein QR. Warten oder Testgeraet mit neuerer Version nutzen; nicht am Gateway drehen.
2. Plugin verweigert Laden: OpenClaw unter 2026.3.22 oder falsche openclaw-weixin-Major-Linie; Logs zeigen Versionsmismatch statt Netzwerkfehler.
3. QR-Scan scheitert: Gateway nicht auf 18789, Firewall blockiert, oder Basis-Smoke nie gruen — Handy erreicht den VPS nicht.
4. Nur Empfang, kein Versand: Session stale nach Sleep, Provider-429 oder Routing-Drift; oft verwechselt mit „Bot kaputt“, obwohl Kanal online ohne Antwort die eigentliche Schicht ist.

Halten Sie waehrend der Erstinstallation eine einzige Aenderung pro Schritt: erst Gateway stabil, dann Plugin, dann QR. Parallele Upgrades an OpenClaw-Core und WeChat-Plugin erzeugen undokumentierte Kombinationen, die in Community-Threads als „zufaellige Disconnects“ erscheinen.

In Incident-Reviews sehen wir haeufig, dass Teams zuerst Netzwerk oder LLM-Provider verdächtigen, obwohl JSONL bereits Plugin-Refusal oder abgelaufene QR-Sessions zeigt. Halten Sie eine einzige sessionId fest und aendern Sie nicht parallel Gateway-Auth, Plugin-Version und Provider-Routing. Wer Personal-WeChat neben Telegram produktiv schaltet, sollte ausserdem festlegen, welche Tools der Agent in DM-Kontexten aufrufen darf — das reduziert sowohl Compliance-Risiko als auch unnoetige Provider-Last durch Retry-Schleifen.

Ein fuenftes Muster: Rebind nach Notebook-Migration. Symptom ist ein scheinbar gruener Kanal mit stale Session nach Wechsel des Hosts. In diesem Fall reicht oft ein gezielter QR-Rebind auf dem stabilen Mac VPS — nie auf einem Laptop, der schlafen kann, bevor der Smoke abgeschlossen ist.

2. Entscheidungsmatrix: Personal-WeChat vs WeCom vs Feishu vs Telegram

ClawBot richtet sich an Nutzer, die bereits Personal-WeChat als Alltags-IM nutzen. Unternehmen mit Compliance-Pflichten sollten WeCom-Integration pruefen; Multi-Kanal-Betrieb siehe Feishu/LINE/Telegram-Runbook.

Teams, die bereits IM-Kanaele auf Mac VPS betreiben, sollten ClawBot nicht auf einem separaten Linux-Host erwarten — das Tencent-Plugin ist an OpenClaw-Gateway und Session-Modell gebunden. Die Matrix ist bewusst operations-nah formuliert, damit Architektur-Reviews nicht in Tooling-Debatten abdriften. Fuer kurze Experimente auf dem Laptop reicht ClawBot; sobald jedoch 7x24 und Reconnect nach Reboot gefordert sind, gewinnt Co-Location mit launchd auf Mac Cloud.

3. Grauzonen-Selbstcheck auf dem Handy

Bevor Sie SSH oeffnen: WeChat → Ich → Einstellungen → Plugins → ClawBot. Fehlt der Eintrag, ist kein Runbook auf dem Server hilfreich. iOS mindestens 8.0.70, Android 8.0.69 in ausgewaehlten Regionen. Strategie ohne Eintrag: zweites Geraet mit aktueller Version, geduldig auf Rollout warten, nicht sideloaden. Mit Eintrag: sofort Gateway-Preflight — die QR-Session ist kurzlebig.

Notieren Sie Client-Version und Region im Change-Ticket. Wenn Tencent den Grauzonen-Kreis erweitert, kann derselbe VPS ploetzlich einen gueltigen QR anzeigen, ohne dass Sie am Server etwas geaendert haben — das hilft, Deploy-Regressionen von reiner Produkt-Wartezeit zu trennen.

4. Mac-VPS-Preflight: Node 22, 18789, Provider, launchd

OpenClaw muss als Produktions-Gateway laufen, bevor das Tencent-Plugin geladen wird. Orientierung am Fuenf-Schritte-Deploy und Gateway-Runbook.

• Runtime: Node.js 22+; openclaw --version und openclaw doctor ohne Halb-Install-Warnung.
• Gateway: Port 18789 lauscht; openclaw gateway status healthy.
• Provider: Mindestens ein LLM-Provider mit erfolgreichem Echo-Smoke — sonst wirkt WeChat „stumm“ obwohl der Kanal gruen ist.
• Same-Account-HOME: launchd-plist UserName = SSH-User; Plugin-Arbeitsverzeichnis minimal privilegiert.
• Audit: Vor Drittanbieter-Skills ClawHub-Audit abschliessen.

Vergleichen Sie echo $HOME in interaktiver SSH-Shell und in einer per launchd simulierten Session. Abweichungen sind die haeufigste Ursache fuer „lokal gruen, produktion rot“ nach WeChat-Bindung. Planen Sie ausreichend RAM fuer Gateway plus Plugin-Worker; auf geteilten Mac-Cloud-Knoten konkurrieren IM-Kanaele, LLM-Provider und Skills um denselben Speicherpool.

5. Versionskompatibilitaet: openclaw-weixin 2.0.x vs 1.0.x

Nach Upgrade gemaess Mai-Release-Train: doctor, Plugin-Version pruefen, Einzelchat-Smoke wiederholen. „Plugin refused to load“ fast immer Versionsmatrix, nicht Firewall.

6. Einschraenkungen und Compliance-Hinweise

7. Sieben-Schritte-Runbook: Basis → CLI → QR → 7x24

1. OpenClaw-Basis abnehmen: doctor gruen, 18789 lauscht, Provider-Echo erfolgreich — ohne WeChat.
2. CLI-Ein-Klick: npx -y @tencent-weixin/openclaw-weixin-cli install; dist-tag und Plugin-Pfad in Logs notieren.
3. Fallback manuell: Bei CLI-Fehler openclaw plugins install @tencent-weixin/openclaw-weixin oder openclaw channels login weixin laut Doku.
4. QR scannen: ClawBot auf dem Handy oeffnen, QR am Terminal oder Dashboard scannen — VPS muss vom Handy erreichbar sein (Tailscale/VPN falls noetig).
5. Gateway restart: openclaw gateway restart oder launchctl-Reload; erneut gateway status.
6. Einzelchat-Abnahme: DM senden und empfangen; JSONL auf channelId und Delivery pruefen.
7. 7x24-Reconnect: Neustart simulieren, nach 24h Inaktivitaet erneut schreiben; bei Drop Schicht-Triage unten.

Archivieren Sie QR-Zeitstempel und Plugin-Version im Change-Ticket. Re-Bind nach Major-Upgrade ohne Dokumentation kostet in der Regel erneut Grauzonen-Geduld auf dem Handy.

Schritt zwei — CLI-Install — waehlt automatisch den passenden dist-tag; notieren Sie die Ausgabe dennoch. Bei manuellem Fallback pruefen Sie, ob openclaw channels status den WeChat-Kanal nach Restart wirklich als connected listet, bevor Sie den ersten DM-Smoke starten. Schritt sieben — 7x24-Reconnect — ist nicht optional: ein Smoke nur in interaktiver SSH beweist nichts ueber Dauerbetrieb nach Reboot oder plist-Reload.

8. Fehler-Mapping und Schicht-Triage

Sequenziell: Grauzone → Plugin-Version → Gateway → Provider → Session. Verweisen Sie bei „online ohne Antwort“ auf den Kanal-Artikel und bei Multi-Kanal auf das Routing-Runbook.

Vermeiden Sie parallele Aenderungen an Gateway-Auth, Plugin-Config und Provider waehrend eines Incidents. Layer eins — Grauzone — pruefen Sie auf dem Handy, nicht auf dem Server. Layer zwei — Version — validieren Sie OpenClaw ≥2026.3.22 und openclaw-weixin 2.0.x zusammen. Layer drei — Erreichbarkeit — Tailscale oder VPN, wenn der VPS hinter NAT steht und das Handy den QR-Host nicht erreicht.

9. Praxisbeispiele

Persoenlicher Assistent: Developer bindet Sekundaer-WeChat, fragt per DM nach Server-Metriken — Agent antwortet aus Gateway-Tools; kein Gruppen-Routing noetig.

WeChat plus Telegram: Produktion auf Mac VPS mit beiden Kanaelen; Zwei-Kanal-Lasttest vor Go-Live, damit sessionId nicht kollidiert.

Kleines Business ohne WeCom: Solo-Founder nutzt ClawBot fuer Kunden-DMs; Einschraenkungen (24h, kein Rich-Mix) im Onboarding-Text kommunizieren.

Compliance-Screenshots per DM: Interne Audits verlangen periodische Bestaetigung, dass eine Statusseite bestimmten Text enthaelt. Ein cron-getriggerter Agent-Flow mit archiviertem JSONL liefert wiederholbare Evidenz — vorausgesetzt, keine Secrets werden in WeChat-Threads gepostet und der Bot antwortet nur auf user-initiierte Nachrichten innerhalb des 24h-Fensters.

10. FAQ

Frage: Parallel zu Telegram oder Feishu? Ja — separater Kanal im Gateway; Multi-Channel-Abnahme nicht ueberspringen.

Frage: Mac VPS vs lokaler Mac? 7x24 und stabiles Reconnect: Mac VPS; Laptop schlaeft und bricht Bindung.

Frage: Neu scannen nach Upgrade? Innerhalb 2.0.x oft nein; Sprung von 1.0.x oder OpenClaw-Downgrade oft ja.

Frage: Ausland/Region? Grauzone regionals; Testgeraet in Zielregion; kein Workaround durch falsche App-Store-Region empfohlen.

11. Fazit

Erfolgskriterium: Grauzonen-Check → stabiles Gateway auf 18789 → CLI-Install → QR → reproduzierbarer Einzelchat. Personal-WeChat ClawBot ersetzt nicht WeCom fuer Enterprise-Compliance, gewinnt aber dort, wo Nutzer ohnehin in WeChat leben. Wer 7x24 ohne Sleep-Bindungsverlust will, gehoert auf einen VPSMAC Apple-Silicon-Mac-VPS mit launchd und Same-Account-HOME — nicht auf das Notebook. Weiter: Gateway, Deploy, Skill-Audit.