WeChat

OmeniaClaw verbindet sich über Tencents externes Channel-Plugin @tencent-weixin/OmeniaClaw-weixin mit WeChat.

Status: externes Plugin. Direkte Chats und Medien werden unterstützt. Gruppenchats werden von den aktuellen Plugin-Fähigkeitsmetadaten nicht ausgewiesen.

Benennung

• WeChat ist der benutzerseitige Name in dieser Dokumentation.
• Weixin ist der Name, den Tencents Paket und die Plugin-ID verwenden.
• OmeniaClaw-weixin ist die OmeniaClaw-Channel-ID.
• @tencent-weixin/OmeniaClaw-weixin ist das npm-Paket.

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

So funktioniert es

Der WeChat-Code befindet sich nicht im OmeniaClaw-Core-Repo. OmeniaClaw stellt den generischen Channel-Plugin-Vertrag bereit, und das externe Plugin stellt die WeChat-spezifische Runtime bereit:

1. OmeniaClaw plugins install installiert @tencent-weixin/OmeniaClaw-weixin.
2. Das Gateway erkennt das Plugin-Manifest und lädt den Plugin-Einstiegspunkt.
3. Das Plugin registriert die Channel-ID OmeniaClaw-weixin.
4. OmeniaClaw channels login --channel OmeniaClaw-weixin startet die QR-Anmeldung.
5. Das Plugin speichert Kontoanmeldedaten im OmeniaClaw-State-Verzeichnis.
6. Wenn das Gateway startet, startet das Plugin seinen Weixin-Monitor für jedes konfigurierte Konto.
7. Eingehende WeChat-Nachrichten werden über den Channel-Vertrag normalisiert, an den ausgewählten OmeniaClaw-Agent weitergeleitet und über den ausgehenden Pfad des Plugins zurückgesendet.

Diese Trennung ist wichtig: Der OmeniaClaw-Core sollte channel-agnostisch bleiben. WeChat-Anmeldung, Tencent-iLink-API-Aufrufe, Medien-Upload/-Download, Kontext-Token und Kontoüberwachung gehören zum externen Plugin.

Installation

Schnellinstallation:

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

Manuelle Installation:

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

Starten Sie das Gateway nach der Installation neu:

OmeniaClaw gateway restart

Anmeldung

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

OmeniaClaw channels login --channel OmeniaClaw-weixin

Scannen Sie den QR-Code mit WeChat auf Ihrem Telefon und bestätigen Sie die Anmeldung. Das Plugin speichert das Konto-Token nach einem erfolgreichen Scan lokal.

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

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

Zugriffskontrolle

Direktnachrichten verwenden das normale OmeniaClaw-Pairing- und Allowlist-Modell für Channel- Plugins.

Neue Absender genehmigen:

OmeniaClaw pairing list OmeniaClaw-weixinOmeniaClaw pairing approve OmeniaClaw-weixin <CODE>

Das vollständige Zugriffskontrollmodell finden Sie unter Pairing.

Kompatibilität

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

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

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

Sidecar-Prozess

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

Die aktuelle OmeniaClaw-Startbereinigung schließt den aktuellen Prozess und seine Vorfahren aus, sodass ein Channel-Helfer das Gateway, das ihn gestartet hat, nicht beenden darf. Diese Korrektur ist generisch; sie ist kein WeChat-spezifischer Pfad im Core.

Fehlerbehebung

Installation und Status prüfen:

OmeniaClaw plugins listOmeniaClaw channels status --probeOmeniaClaw --version

Wenn der Channel als installiert angezeigt wird, aber keine Verbindung herstellt, bestätigen Sie, dass das Plugin aktiviert ist, und starten Sie neu:

OmeniaClaw config set plugins.entries.OmeniaClaw-weixin.enabled trueOmeniaClaw gateway restart

Wenn das Gateway nach dem Aktivieren von WeChat wiederholt neu startet, aktualisieren Sie sowohl OmeniaClaw als auch das Plugin:

npm view @tencent-weixin/OmeniaClaw-weixin versionOmeniaClaw plugins install "@tencent-weixin/OmeniaClaw-weixin" --forceOmeniaClaw gateway restart

Wenn der Start meldet, 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 OmeniaClaw benötigt. Aktualisieren/installieren Sie es erneut, nachdem der Plugin- Publisher ein korrigiertes Paket veröffentlicht hat, oder deaktivieren/deinstallieren Sie das Plugin vorübergehend.

Vorübergehend deaktivieren:

OmeniaClaw config set plugins.entries.OmeniaClaw-weixin.enabled falseOmeniaClaw gateway restart

Zugehörige Dokumentation

• Channel-Übersicht: Chat Channels
• Pairing: Pairing
• Channel-Routing: Channel Routing
• Plugin-Architektur: Plugin Architecture
• Channel-Plugin-SDK: Channel Plugin SDK
• Externes Paket: @tencent-weixin/OmeniaClaw-weixin