WeChat

OpenClaw stellt über Tencents externes @tencent-weixin/openclaw-weixin-Kanal-Plugin 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 das Paket von Tencent und die Plugin-ID verwenden.
• 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 Runtime 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 QR-Anmeldung.
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 QR-Anmeldung auf demselben Computer 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 Direktnachrichtensitzungen nach Konto, Kanal und Absender:

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

Zugriffskontrolle

Direktnachrichten verwenden das normale OpenClaw-Modell für Kopplung und Zulassungslisten bei Kanal-Plugins.

Genehmigen Sie neue Absender:

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

Das vollständige Modell zur Zugriffskontrolle finden Sie unter Kopplung.

Kompatibilität

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

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

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

Sidecar-Prozess

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

Die aktuelle OpenClaw-Startbereinigung schließt den aktuellen Prozess und dessen Vorfahren aus, sodass ein Kanal-Hilfsprozess das Gateway, das ihn gestartet hat, nicht beenden kann. Diese Korrektur ist generisch; sie ist kein WeChat-spezifischer Pfad im Core.

Fehlerbehebung

Prüfen Sie Installation und Status:

openclaw plugins listopenclaw channels status --probeopenclaw --version

Wenn der Kanal als installiert angezeigt wird, aber keine Verbindung herstellt, stellen Sie sicher, dass das Plugin aktiviert ist, und führen Sie einen Neustart durch:

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-Runtime-Dateien 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: Chatkanä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