2026 Tencent WeChat ClawBot – Installationsanleitung
openclaw-weixin-cli, Versionsmatrix und Produktionshinweise

Sie möchten Ihren OpenClaw-Agenten aus dem privaten WeChat steuern, sind aber unsicher, ob zuerst das ClawBot-Plugin oder das Gateway kommt. Dieser Leitfaden richtet sich an Betreiber mit OpenClaw 2026 und dem offiziellen Tencent-Kanal openclaw-weixin: Vorab-Checks, npx @tencent-weixin/openclaw-weixin-cli install versus manuelle Schritte, 2.0.x/legacy-Matrix, dmScope bei mehreren Konten sowie WeChat-Grenzen (Einzelchat, Dateien nur eingehend, 8.0.70+, Inhaltsprüfung). Ergänzend zu Telegram-Nach-Deploy-Triade, channels probe und Halbinstallation – damit Sie die richtige Ebene reparieren.

01

Was ist ClawBot – und warum zuerst Gateway, dann die WeChat-Leitung?

Der 2026er WeChat ClawBot (Einstellungen → Plugins) ist der offizielle Kanaleingang. Skills und Modelle laufen auf Ihrem OpenClaw Gateway. OpenClaw ist die „Hummer“-Laufzeit, ClawBot die Telefonleitung – ohne Leitung sieht ein gesundes Gateway keinen WeChat-Verkehr.

  • 01

    Nur WeChat-Plugin, kein OpenClaw: QR-Login kann klappen, inbound wird aber nicht verarbeitet.

  • 02

    Host zu alt: Plugin 2.0.x verlangt >=2026.3.22; Start bricht mit requires OpenClaw >=2026.3.22 ab.

  • 03

    Gateway nicht dauerhaft online: Laptop-Sleep, Docker ohne Restart, VPS ohne systemd – gestern OK, heute stumm.

  • 04

    ClawBot mit Tencent Yuanbao verwechseln: Yuanbao ist ein Tencent-Produkt; ClawBot verbindet Ihr OpenClaw – Sie tragen den Betrieb.

  • 05

    Mehrere WeChat-Konten, ein Session-Bucket: ohne session.dmScope können Antworten zwischen Nutzern vermischen.

  • 06

    WeChat-Produktgrenzen ignorieren: offizieller Kanal nur Einzelchat, keine Gruppen – Details in Abschnitt 4.

02

Vergleich: privates WeChat ClawBot vs. WeCom vs. Telegram

DimensionOffizielles ClawBot-PluginWeCom-EigenappTelegram-Bot (OpenClaw)
ZielgruppePrivat, Einzelchat-AutomationTeams, Gruppen, ComplianceInternationale Community, Gruppen-Gating
AufwandNiedrig: openclaw-weixin-cli + QRHoch: öffentliche IP, Callback, Trusted IPMittel: Bot-Token + Pairing
WeChat-Version8.0.70+ (Plugin-Eintrag)Scan für Firmenkontoentfällt
Gruppenchatnicht unterstützterweiterbarunterstützt (Mention-Regeln)
Fehlerbehebungdieser ArtikelWeCom-Plugin-DokuNach-Deploy-Triade

„In WeChat senden“ heißt nicht „Kanal geschlossen“ – Plugin enabled, Gateway-Neustart und Probe sind drei getrennte Hürden.

03

Sechs-Schritte-Runbook: CLI bis zur ersten WeChat-Antwort

Zuerst OpenClaw- und Node-Baseline (Node-24-Produktionsdeploy). Fehlt das Gateway: Halbinstallation vor erneutem QR-Scan.

  1. 01

    Host-Version: openclaw --version; unter 2026.3.22 für 2.0.x: openclaw update oder legacy-Linie (Abschnitt 4).

  2. 02

    Ein-Klick-Install: npx -y @tencent-weixin/openclaw-weixin-cli install — Version, plugins install, QR, Gateway-Neustart.

  3. 03

    Manuell: openclaw plugins install "@tencent-weixin/openclaw-weixin"openclaw config set plugins.entries.openclaw-weixin.enabled trueopenclaw channels login --channel openclaw-weixinopenclaw gateway restart.

  4. 04

    WeChat-Client: 8.0.70+, Pfad Ich → Einstellungen → Plugins → „WeChat ClawBot“; Android ohne Grauveröffentlichung ggf. QR über CLI.

  5. 05

    Mehrkonten (optional): erneutes channels login; openclaw config set session.dmScope per-account-channel-peer; optional channels.openclaw-weixin.botAgent nur für Logs.

  6. 06

    Abnahme: openclaw channels status --probe + openclaw doctor --deep; Testnachricht in WeChat, parallel openclaw logs --follow. Pairing: channels probe.

bash
# 2026 Tencent-WeChat-Kanal — Ein-Klick + Abnahme
npx -y @tencent-weixin/openclaw-weixin-cli install

openclaw --version
openclaw channels status --probe
openclaw doctor --deep
openclaw logs --follow

# Älterer Host: legacy-Plugin-Linie
openclaw plugins install @tencent-weixin/openclaw-weixin@legacy
info

Tipp: bei langsamem npm Registry spiegeln, dann npx wiederholen. Bei Plugin-Fehler zuerst openclaw plugins list, nicht sofort erneut scannen.

warning

Hinweis: Verkehr läuft über den offiziellen Tencent-Kanal mit Inhaltsprüfung. Für Produktion ein Zweitkonto nutzen; Datenfluss und Aufbewahrung in Ihrer DSGVO-Dokumentation festhalten.

04

Versionsmatrix, WeChat-Hardlimits und Host-Wahl

Plugin-LinieOpenClaw-Hostnpm dist-tagTypischer Fehler
2.0.x>= 2026.3.22latestHost zu alt → OpenClaw upgraden
1.0.x>= 2026.1.0 < 2026.3.22legacy@legacy statt erzwungenem Host-Upgrade
  • WeChat 8.0.70+: Plugin-Eintrag und QR hängen an aktueller Client-Version.
  • Nur Einzelchat / keine Gruppen: Gruppentext manuell an den Bot oder WeCom.
  • Dateien nur eingehend: PDF/Bilder an den Bot; Ergebnis oft über OpenClaw-Web oder anderen Kanal.
  • 24h-Interaktions-Keepalive: lange Pause kann proaktive Pushs stoppen – Cron-Heartbeat empfohlen.

Ein schlafender Laptop bricht WeChat ab. Ein exklusiver, dauerhaft online macOS-Knoten passt besser zu 7×24-Kanälen – betrieben wie in Remote-Mac launchd Health Checks mit nachvollziehbarer Stabilität.

Für VPS-ähnliche Bereitstellung per SSH, inklusive dieses Runbooks im Golden Image, ist NodeMini Mac-Mini-Cloud-Miete meist die stabilere Wahl als Heim-Gateway mit Sleep-Zyklen. Mietpreise und Hilfezentrum für EU/DSGVO-orientierte Betriebsfragen.

FAQ

Häufige Fragen

ClawBot ist das Kanal-Plugin, OpenClaw Gateway die Laufzeit. Zuerst OpenClaw, dann openclaw-weixin-cli. Basis: plattformübergreifende Installation.

plugins.entries.openclaw-weixin.enabled true und gateway restart. Mehrkonten: session.dmScope per-account-channel-peer. Host: Mac-Mini-Mietpreise.

Telegram-Artikel: 409, Webhook, Chrome Relay. Dieser Artikel: offizielles Tencent-WeChat-Plugin und Produktgrenzen. Support: Hilfezentrum.