Skip to main content
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:
Manuelle Installation:
Starten Sie das Gateway nach der Installation neu:

​
Anmeldung

Führen Sie die QR-Anmeldung auf demselben Computer aus, auf dem das Gateway läuft:
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:

​
Zugriffskontrolle

Direktnachrichten verwenden das normale OpenClaw-Modell für Kopplung und Zulassungslisten bei Kanal-Plugins. Genehmigen Sie neue Absender:
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:

​
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:
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:
Wenn das Gateway nach der Aktivierung von WeChat wiederholt neu startet, aktualisieren Sie sowohl OpenClaw als auch das Plugin:
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:

​
Verwandte Dokumentation