WeChat

OpenClaw stellt über Tencents externes Kanal-Plugin @tencent-weixin/openclaw-weixin eine Verbindung zu WeChat her.

Status: externes Plugin, betreut vom Tencent-Weixin-Team. Direktchats und Medien werden unterstützt. Gruppenchats werden in den Metadaten zu den Plugin-Funktionen nicht ausgewiesen (dort sind nur Direktchats deklariert).

Benennung

• WeChat ist der in dieser Dokumentation verwendete Name.
• Weixin ist der Name, den Tencent für sein Paket und die Plugin-ID verwendet.
• openclaw-weixin ist die OpenClaw-Kanal-ID (weixin und wechat funktionieren als Aliasse).
• @tencent-weixin/openclaw-weixin ist das npm-Paket.

Verwenden Sie openclaw-weixin in CLI-Befehlen und Konfigurationspfaden.

Funktionsweise

Der WeChat-Code befindet sich nicht im OpenClaw-Core-Repository. OpenClaw stellt den generischen Vertrag für Kanal-Plugins bereit, und das externe Plugin stellt die WeChat-spezifische Laufzeit bereit:

1. openclaw plugins install installiert @tencent-weixin/openclaw-weixin.
2. Das Gateway erkennt das Plugin-Manifest und lädt den Plugin-Einstiegspunkt.
3. Das Plugin registriert die Kanal-ID openclaw-weixin.
4. openclaw channels login --channel openclaw-weixin startet die Anmeldung per QR-Code.
5. Das Plugin speichert die Anmeldedaten des Kontos im OpenClaw-Statusverzeichnis (standardmäßig ~/.openclaw).
6. Beim Start des Gateways startet das Plugin seinen Weixin-Monitor für jedes konfigurierte Konto.
7. Eingehende WeChat-Nachrichten werden über den Kanalvertrag normalisiert, an den ausgewählten OpenClaw-Agenten weitergeleitet und über den ausgehenden Pfad des Plugins zurückgesendet.

Diese Trennung ist wichtig: Der OpenClaw-Core bleibt kanalunabhängig. Die WeChat-Anmeldung, Aufrufe der Tencent-iLink-API, das Hoch- und Herunterladen von Medien, Kontext-Token und die Kontoüberwachung liegen in der Verantwortung des externen Plugins.

Installation

Schnellinstallation:

npx -y @tencent-weixin/openclaw-weixin-cli install

Manuelle Installation:

openclaw plugins install "@tencent-weixin/openclaw-weixin"openclaw config set plugins.entries.openclaw-weixin.enabled true

Starten Sie das Gateway nach der Installation neu:

openclaw gateway restart

Anmeldung

Führen Sie die Anmeldung per QR-Code auf demselben Rechner aus, auf dem das Gateway läuft:

openclaw channels login --channel openclaw-weixin

Scannen Sie den QR-Code mit WeChat auf Ihrem Smartphone und bestätigen Sie die Anmeldung. Nach erfolgreichem Scannen speichert das Plugin das Konto-Token lokal.

Um ein weiteres WeChat-Konto hinzuzufügen, führen Sie denselben Anmeldebefehl erneut aus. Isolieren Sie bei mehreren Konten die Direktnachrichtensitzungen nach Konto, Kanal und Absender:

openclaw config set session.dmScope per-account-channel-peer

Zugriffskontrolle

Direktnachrichten verwenden das normale Kopplungs- und Zulassungslistenmodell von OpenClaw für Kanal-Plugins.

Neue Absender genehmigen:

openclaw pairing list openclaw-weixinopenclaw pairing approve openclaw-weixin <CODE>

Das vollständige Modell der Zugriffssteuerung finden Sie unter Kopplung.

Kompatibilität

Das Plugin prüft beim Start die OpenClaw-Version des Hosts.

Wenn das Plugin meldet, dass Ihre OpenClaw-Version zu alt ist, aktualisieren Sie entweder OpenClaw oder installieren Sie die Legacy-Plugin-Linie:

openclaw plugins install @tencent-weixin/openclaw-weixin@legacy

Sidecar-Prozess

Das WeChat-Plugin kann neben dem Gateway Hilfsprozesse ausführen, während es die Tencent iLink API überwacht. In Issue #68451 deckte dieser Hilfspfad einen Fehler in der generischen Bereinigung veralteter Gateways von OpenClaw auf: Ein untergeordneter Prozess konnte versuchen, den übergeordneten Gateway-Prozess zu bereinigen, was unter Prozessmanagern wie systemd Neustartschleifen verursachte.

Die aktuelle Startbereinigung von OpenClaw schließt den aktuellen Prozess und seine Vorgängerprozesse aus, sodass ein Kanal-Hilfsprozess das Gateway, von dem er gestartet wurde, nicht beenden kann. Diese Korrektur ist generisch; sie ist kein WeChat-spezifischer Pfad im Kernsystem.

Fehlerbehebung

Installation und Status prüfen:

openclaw plugins listopenclaw channels status --probeopenclaw --version

Wenn der Kanal als installiert angezeigt wird, aber keine Verbindung herstellt, vergewissern Sie sich, dass das Plugin aktiviert ist, und starten Sie neu:

openclaw config set plugins.entries.openclaw-weixin.enabled trueopenclaw gateway restart

Wenn das Gateway nach der Aktivierung von WeChat wiederholt neu startet, aktualisieren Sie sowohl OpenClaw als auch das Plugin:

npm view @tencent-weixin/openclaw-weixin versionopenclaw plugins install "@tencent-weixin/openclaw-weixin" --forceopenclaw gateway restart

Wenn beim Start gemeldet wird, dass das installierte Plugin-Paket requires compiled runtime output for TypeScript entry, wurde das npm-Paket ohne die kompilierten JavaScript-Laufzeitdateien veröffentlicht, die OpenClaw benötigt. Aktualisieren oder installieren Sie es erneut, nachdem der Plugin-Herausgeber ein korrigiertes Paket veröffentlicht hat, oder deaktivieren beziehungsweise deinstallieren Sie das Plugin vorübergehend.

Vorübergehend deaktivieren:

openclaw config set plugins.entries.openclaw-weixin.enabled falseopenclaw gateway restart

Verwandte Dokumentation

• Kanalübersicht: Chat-Kanäle
• Kopplung: Kopplung
• Kanal-Routing: Kanal-Routing
• Plugin-Architektur: Plugin-Architektur
• SDK für Kanal-Plugins: SDK für Kanal-Plugins
• Externes Paket: @tencent-weixin/openclaw-weixin